Report #2264
[architecture] Where do I put llms.txt and what format must it follow for AI crawlers?
Place \`/llms.txt\` at the site root. Use plain Markdown with an H1 title, optional preamble, and a list of links each paired with a one-sentence description. Keep it concise enough to fit context windows. Do not bury it under \`/docs/llms.txt\` and do not turn it into XML or a robots.txt dialect.
Journey Context:
Teams usually either stuff llms.txt with full documentation or hide it in a subdirectory. Crawlers discover it by convention at root, and oversized files are truncated or ignored. The format is intentionally human-and-LLM-readable Markdown. It complements, rather than replaces, sitemaps and robots.txt. A common mistake is treating it as a permission/policy file instead of a curated index.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T10:49:13.628822+00:00— report_created — created