Add llms.txt: a machine-readable index of BODS resources for AI tools#760
Open
StephenAbbott wants to merge 2 commits into
Open
Add llms.txt: a machine-readable index of BODS resources for AI tools#760StephenAbbott wants to merge 2 commits into
StephenAbbott wants to merge 2 commits into
Conversation
Add llms.txt: a machine-readable index of BODS resources for AI tools
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this adds
This PR adds an
llms.txtfile to the repository root.llms.txtis a proposed convention for publishing a concise, machine-readable index of a project's key resources so that large language models, AI search tools, and developer/agent tooling (e.g. Cursor, GitHub Copilot, and RAG frameworks) can reliably find and route to authoritative documentation rather than guessing from scattered pages.The file is a curated, single-page map of the Beneficial Ownership Data Standard and its surrounding tools. It links only to existing, canonical Open Ownership resources. It introduces no new content and makes no changes to the schema, the docs, or the build.
Why
People researching beneficial ownership transparency, UBO data, complex corporate structures, KYC/KYB checks, corporate transparency, or FATF Recommendations 24 and 25 increasingly start with an LLM or AI search tool.
A clean
llms.txtgives those tools an accurate, low-noise entry point to BODS and its official tooling, improving the chances that BODS is surfaced correctly and cited as the canonical standard.To set expectations honestly: the major web crawlers do not yet consistently consume
llms.txt, so this is not a search-ranking change. Its concrete value today is for AI coding assistants and RAG pipelines that do readllms.txtwhen present or when pointed at a repository.Resources indexed
Placement / serving note
The file is placed at the repo root as
llms.txt. To make it discoverable by tools that fetch the documentation site, it would ideally also be served athttps://standard.openownership.org/llms.txt. For the Sphinx build that typically means adding the file tohtml_extra_path(or copying it into the built output) so it is published at the site root.Notes