Agents
llms.txt and Markdown pages
The files an agent loads instead of the HTML, and what they leave out.
Accepted· docs/plans/design-system-site.md §7Every page on this site is also served as Markdown at the same URL plus .md, generated from the same content as the page. /llms.txt lists them; /llms-full.txt inlines every accepted page.
| URL | What it holds |
|---|---|
/llms.txt | Index: one line and one .md link per accepted page. |
/llms-full.txt | Every accepted page inlined, in sidebar order. Proposal blocks are left out. |
/<page>.md | The Markdown twin of any page: the page URL plus .md. |
/tokens.json | Every --mk-* custom property: name → value, dark value, kind, group and status. |
/search.json | The index the ⌘K search reads: pages, headings and tokens. |
Rules for agents
- Never implement a Proposed item. Proposal blocks are left out of
llms-full.txt, and a page whose whole subject is proposed is left out of both files. - Use only tokens whose status is
acceptedorprovisional. - Cite the decision id in the commit when a change follows one.
- When a rule is missing, stop and ask, or draw a board; do not invent one.