The /llms.txt Standard: Documentation for AI Systems
A complete architectural guide to creating, structuring, and serving an /llms.txt file to guide AI models, crawlers, and coding agents.
AI Summary: /llms.txt is a standardized plain-text markdown file placed at the root of a domain that curates high-value documentation, APIs, and product context for LLMs and AI agents. It reduces token overhead and enables AI systems to ingest authoritative documentation accurately.
What is the /llms.txt Standard?
The /llms.txt proposal is an emerging community standard that defines a curated, machine-readable manifest placed at the root of a website (e.g., https://example.com/llms.txt).
While /robots.txt dictates where bots are allowed to go, /llms.txt tells AI models and agents which content is most important and how to understand it without parsing complex navigation bars, scripts, or marketing boilerplate.
Anatomical Structure of /llms.txt
An /llms.txt file is written in GitHub Flavored Markdown and contains three core elements:
# Project Name
> Short summary of the project, architecture, and core capabilities (1–2 sentences).
## Primary Documentation
- [Quickstart](https://example.com/docs/quickstart.md): Getting started guide for developers.
- [API Reference](https://example.com/docs/api.md): Complete REST and WebSocket endpoints.
- [Architecture](https://example.com/docs/architecture.md): Core system design and invariant rules.
## Optional Sections
- [Changelog](https://example.com/changelog.md): Recent release notes and breaking changes.
The Companion /llms-full.txt
For developer platforms and comprehensive documentation libraries, publishers also serve an /llms-full.txt file. This single concatenated markdown document bundles the entire technical documentation corpus, allowing LLMs with large context windows (200k+ tokens) to ingest the complete reference in a single prompt.
Best Practices for Serving /llms.txt
- Serve as Clean UTF-8 Plain Text: Return
Content-Type: text/markdown; charset=utf-8ortext/plain. - Link to Clean Markdown: Point URLs to clean markdown files or strip HTML chrome.
- Keep Information Dense: Avoid marketing copy; emphasize code examples, schemas, and configurations.
- Automate in CI/CD: Update
/llms.txtautomatically during deployment whenever documentation updates.
Verify that your /llms.txt file complies with emerging AI retrieval standards. Audit your domain with Geolify.ai.