← Policy library/The /llms.txt Standard: Documentation for AI Systems
Policy library

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:

configuration / code
# 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

  1. Serve as Clean UTF-8 Plain Text: Return Content-Type: text/markdown; charset=utf-8 or text/plain.
  2. Link to Clean Markdown: Point URLs to clean markdown files or strip HTML chrome.
  3. Keep Information Dense: Avoid marketing copy; emphasize code examples, schemas, and configurations.
  4. Automate in CI/CD: Update /llms.txt automatically during deployment whenever documentation updates.

Verify that your /llms.txt file complies with emerging AI retrieval standards. Audit your domain with Geolify.ai.

Related policies