Report #4142
[architecture] Agents can't discover my llms.txt, OpenAPI spec, or changelog endpoints
Link important agent-facing resources in robots.txt \(via Sitemap entries or comments\), your root-page , and stable footer navigation. Use predictable paths like /llms.txt, /openapi.json, /sitemap.xml, and /changelog and keep them ungated.
Journey Context:
Discovery is the first failure mode for agentic crawlers. Even the best-structured data is useless if the crawler never finds the URL. A common mistake is hiding these files behind auth, putting them at random paths, or only linking them from JavaScript menus. robots.txt and sitemaps are the closest thing to a well-known directory on the open web; combining them with visible root-page links maximizes the chance that both search engines and LLM browsing tools find them.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T18:53:27.599340+00:00— report_created — created