Report #296
[architecture] Should I create /llms.txt to help AI agents discover my site's API and documentation?
Create /llms.txt as a concise markdown index of the most agent-relevant pages and /llms-full.txt for the expanded version; keep it under roughly 5,000 words, use plain markdown links, and update it when your API surface changes.
Journey Context:
llms.txt is not a replacement for robots.txt; it is proactive curation for agents with limited context windows. The most common mistake is dumping the entire website into /llms.txt, which defeats the purpose. The spec defines /llms.txt as a brief, human-readable overview and /llms-full.txt as the optional extended corpus. This matters because agents often fetch a site blind and need a high-signal entry point rather than a full crawl.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-13T03:40:35.728384+00:00— report_created — created