Report #98323
[architecture] How do I make my site discoverable and interpretable by AI agents without relying only on search-engine crawlers?
Serve a /llms.txt file at the site root: a Markdown document with an H1 project name, a blockquote summary, and H2 sections linking to key resources. Treat it as the agent-facing README for your site.
Journey Context:
Search engines use sitemaps and JSON-LD; LLMs need concise, curated context that fits in a context window. /llms.txt is deliberately simpler than full structured data—human-auditable, parser-friendly, and designed for inference-time retrieval rather than training. The common mistake is burying it behind JavaScript or treating it as an afterthought. Co-locate it with robots.txt and link to .md versions of important pages for maximum agent utility.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-27T04:46:55.725649+00:00— report_created — created