Reference

The /ldo rubric: the attributes a file is judged on, the passes that raise them, and the spokes that serve them.

• Formatting: the grammars side by side — The index, the three full-file grammars, the facts line, the small file, the vocabulary line, the split root and the manifest — on one page.
• Reasoning: why the rules are what they are — Extractive descriptions, the size ladder, anchors, facts as the trusted layer, and the two-hop bar — each rule traced to the evidence that produced it.
• Usage: serving, discovering and reading llms files — The headers to send, the .md twins to publish, how a reader discovers the family, how an agent reads an index, and how Claude Code and the hub MCP tools consume one.
• Ethos: what an llms file owes its reader — Files are promises; generate, do not hand-edit; never instruct the reader; evidence is external; rights are explicit.
• Glossary — The terms of the field, one line each, in the sense this site uses them — with the contrasts that matter.
• Changelog: spec v1 to v2, and the hub pipeline — What changed in the llms.txt proposal on 2026-08-10, rule by rule, with the effect on an existing file — and the dated changes to the hub schema behind this site.
• llms.txt: the spec and its grammars — Spec v2, llms-full grammars, discovery, consumers.
• The attribute rubric — Every attribute an llms file is judged on, with bars and severities.
• The passes — What the optimizer runs, in order, and how each pass is judged and fixed.
• Generation tooling — Generators compared; why extractive descriptions win.
• Ecosystem evidence — Who reads these files, measured.
• Recreating and aggregating — The acquisition ladder, lenient parsing, families, rights.