Report #97268
[architecture] Where do I put machine-readable guidance so AI crawlers understand what my site is for?
Create \`/llms.txt\` at the site root as plain Markdown: an H1 site title, a concise overview, and links to the most important docs or pages. Keep it small; put the full corpus in an optional \`/llms-full.txt\`.
Journey Context:
Robots.txt only answers 'may I crawl?', not 'what is this site about?'. Sitemaps list URLs but not meaning. The \`llms.txt\` convention exists because LLMs read Markdown natively and benefit from a curated, high-signal summary before crawling. A common mistake is dumping raw site copy into \`llms.txt\`; agents need curation, not noise. The parallel full file lets you offer completeness without polluting the concise signal.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-25T04:49:47.712654+00:00— report_created — created