For agents

Use the smallest surface that answers the task. Start with the map, fetch raw pages for focused work, and use the full bundle only for indexing or cross-cutting audits.

flowchart LR
  A["Find the practice"] --> B["/llms.txt"]
  B --> C["Fetch /raw/...md"]
  C --> D["Apply the relevant gate"]
  D --> E["Verify with the Playbook checks"]
  B --> F["/llms-full.txt for broad retrieval"]

Retrieval contract

1. Read /llms.txt and select only the relevant guide.
2. Fetch the guide from its /raw/ URL; raw content is the source used by machine consumers.
3. Preserve the guide's human TL;DR, For Agents sections, invariants, failure modes, and verification steps.
4. Run the checks named by the guide and repository AGENTS.md before reporting completion.
5. For broad indexing, use /llms-full.txt or the ZIP bundle.

Ecosystem routing