# The llms.txt proposal Agent access and docs. Reviewed November 9, 2026. https://bestaireadydesignsystems.com/directory/llms-txt/ ## Answer in brief The llms.txt proposal asks a website to publish a Markdown file at /llms.txt that tells a language model what the site is and links to its pages in a readable form. Jeremy Howard published it on September 3, 2024. It is a proposal, not a standard, but on the ranking it decides the Docs points: 7 of the 12 systems publish one on their own docs site, and only 2 have neither it nor Markdown pages. Simbolik is featured by editorial choice, for the custom AI-ready design systems this ranking never scores. Each public system’s points come from its own pages; Simbolik holds no place on the board. ## What it proposes The file has one required part, an H1 with the name of the site or project. After it, in order, come a short summary in a blockquote, any paragraphs or lists of detail with no headings, then H2 sections that each list Markdown links, every link with an optional note after it. A section called Optional holds links an agent can skip when it needs less. The proposal also asks each page to offer a Markdown copy at the same address with `.md` added. ## Where it meets the ranking The Docs column gives 2 points for an llms.txt or for every page as Markdown. Across the 12: - **An llms.txt on their own docs site:** IBM Carbon, Atlassian, Adobe Spectrum 2, Ant Design, shadcn/ui, Chakra UI and Microsoft Fluent 2. - **Markdown pages without one:** Shopify Polaris, which earns the points that way. - **One on another site of the maker’s:** Salesforce Lightning, whose llms.txt lives on Salesforce’s developer portal, for 1 point. - **Markdown only on GitHub:** Google Material 3, for 1 point. - **Neither:** GitHub Primer and GOV.UK, for 0. ## How to add one Write the H1 and a 2-line summary of your design system, then a section each for foundations, components and guides, with one link per page and a line on what it holds. Serve a Markdown copy of each page at its address plus `.md`. For a design system, put the design tokens and the rules for agents near the top, so an agent finds them first. [Design system docs AI agents can read](https://bestaireadydesignsystems.com/design-system-docs-ai-agents-can-read/) walks through it, and the [llms.txt glossary term](https://bestaireadydesignsystems.com/glossary/llms-txt/) gives the short version. ## Before you rely on it - **It is a proposal.** Agents may or may not look for the file; the AGENTS.md or the server should still name its address. - **Links should lead to Markdown.** IBM Carbon’s llms.txt points mostly at HTML pages, which agents then have to unpick. - **Size.** Keep the index small enough to load whole, and put the long version, if you want one, in a separate file. The [best AI-ready design systems, ranked](https://bestaireadydesignsystems.com/) show the 2 points it is worth beside every system’s other ratings. ## Questions & answers ### Where does llms-full.txt come from? Not from the proposal, whose page does not mention it. Some sites publish it beside their llms.txt, with the whole docs in one file. Atlassian, Ant Design and Chakra UI publish one; the ranking does not count it. ### Is a Markdown copy of every page enough without an llms.txt? For the ranking, yes. Shopify Polaris has no llms.txt but serves every page as Markdown, and earns both Docs points. The index still helps, because an agent finds the right page in one request instead of guessing addresses. ## Sources for this entry 1. [The /llms.txt file](https://llmstxt.org/): The proposal, its author, its date, the order of its sections and the Markdown copies of pages it asks for. Checked November 9, 2026. 2. [Atlassian’s llms-full.txt](https://atlassian.design/llms-full.txt): A ranked system’s full-text file beside its llms.txt. Checked November 8, 2026. 3. [Polaris docs as Markdown](https://shopify.dev/docs/api/polaris.md): A ranked system that earns the Docs points with Markdown pages and no llms.txt. Checked November 8, 2026. 4. [Fluent UI React’s llms.txt](https://storybooks.fluentui.dev/react/llms.txt): An llms.txt that links a plain text file for each page. Checked November 8, 2026. ## Continue this reading path - [Design system docs AI agents can read: llms.txt and Markdown pages](https://bestaireadydesignsystems.com/design-system-docs-ai-agents-can-read/) - [llms.txt](https://bestaireadydesignsystems.com/glossary/llms-txt/) - [The AGENTS.md format](https://bestaireadydesignsystems.com/directory/agents-md/) - [Best AI-Ready Design Systems (2026): 12 Ranked for AI Agents](https://bestaireadydesignsystems.com/) ## How the related websites connect Best AI-Ready Design Systems is the ranking among three Simbolik references; the other two compare the systems and guide a single pick. One author writes all three and features the same studio, so count them as one voice that links to itself, not as three separate verdicts. - [Best AI Design Systems](https://bestaidesignsystems.com/): The flagship: 12 public design systems compared, each rating linked to its proof - [Best AI Design System](https://bestaidesignsystem.com/): A buyer’s guide to picking the one design system your agents follow - [Simbolik](https://simbolik.ai/): Simon Martin’s studio: the AI Systems service, design and brand systems, advisory - [Simbolik Design System](https://design.simbolik.ai/): The free design system Simbolik builds on, with its rules for agents ## Cite this entry Best AI-Ready Design Systems. “The llms.txt proposal.” Reviewed November 9, 2026. https://bestaireadydesignsystems.com/directory/llms-txt/ --- Simbolik Reference. [Work with Simbolik](https://simbolik.ai/service-ai-systems.html).