Skip to content

Add llms.txt / llms-full.txt discovery blockquote to generated .md pages #2822

Description

@webrdaniel

Context

Agent-oriented surfaces (llms.txt, llms-full.txt, agents.md, AGI, .well-known, etc.) are rarely discovered unless they are clearly linked from docs. Purpose-built agent resources help once found, but blind agents mostly land on human-first docs pages.

Request

Update generated per-page .md outputs so each includes a Documentation Index-style blockquote pointing to llms.txt and llms-full.txt, similar to Anthropic's docs:

> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

Reference: https://code.claude.com/docs/en/overview.md

Notes

  • Apply this only on .md versions of pages (not the HTML rendered for humans).
  • SEO confirmed OK for .md-only additions (Aleš Wilk).
  • Related work already prepends nav headers to per-page .md files in scripts/addNavHeaders.mjs — this blockquote likely belongs in the same post-build path (and must not leak into llms-full.txt).

Slack

Metadata

Metadata

Assignees

No one assigned

    Labels

    medium priorityMedium priority issues to be done in a couple of sprints.t-webIssues with this label are in the ownership of the web team.

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions