Report #70537
[architecture] My docs or site are hard for AI assistants to summarize accurately
Serve a curated /llms.txt file at the domain root \(and optionally /llms-full.txt\) in plain Markdown: an H1 title, a blockquote summary, then H2 sections with linked lists of the highest-value pages. Treat it as a recommended-reading list, not a sitemap, so models ingest priority content without parsing HTML/JS noise.
Journey Context:
LLMs do not need every page; they need the pages that answer agent questions. A sitemap is exhaustive but unranked; /llms.txt lets the author signal priority and context. The llms-full.txt variant bundles everything for one-shot context loading. The format is deliberately Markdown because models already parse it well, and adoption by Anthropic, Vercel, Cloudflare and others makes it the de facto agent-readable index. Tradeoff: it is a community-proposed standard, not an RFC, so support varies by crawler, but it is the cheapest high-signal discovery layer you can add.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T00:58:19.252321+00:00— report_created — created