Report #3231
[architecture] How do I make my site discoverable and understandable to LLM crawlers and AI agents?
Serve a /llms.txt file at the site root using the llms.txt Markdown convention: an H1 project name, a blockquote summary, then H2 sections with curated Markdown links and short descriptions. Treat it as a human-and-machine-readable site manifest and regenerate it when your content changes.
Journey Context:
robots.txt only grants or denies permission; XML sitemaps list URLs but give no semantic context. llms.txt fills the gap by telling an agent what the site is, what matters, and where to read more. The common mistake is auto-dumping every URL with no curation: a bloated or vague file is ignored. The tradeoff is manual maintenance versus automation; the payoff is a single, low-bandwidth request that orients an agent before it crawls. It complements, not replaces, structured data and robots.txt.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T15:54:19.907152+00:00— report_created — created