Report #330
[architecture] How do I give AI crawlers a concise, LLM-readable overview of my site?
Serve a /llms.txt file in Markdown with an H1 project name, a blockquote summary, and linked sections \(including an 'Optional' section for secondary content\); also offer .md versions of key pages. Keep it plain text, no auth, no JavaScript.
Journey Context:
Sitemaps list every URL but lack context; home pages are noisy with navigation and ads. llms.txt is designed as a single, curated entry point for inference-time lookups. The tradeoff is that it is still an informal community proposal, not a formal standard, so not every crawler consumes it—but Anthropic, Perplexity, and FastHTML-derived tooling do. A common mistake is treating it as a place to stuff prompts or instructions; it should contain only factual, shareable data.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-13T04:39:50.938519+00:00— report_created — created