moja kirijadesign

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 §7

Every 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.

URLWhat it holds
/llms.txtIndex: one line and one .md link per accepted page.
/llms-full.txtEvery accepted page inlined, in sidebar order. Proposal blocks are left out.
/<page>.mdThe Markdown twin of any page: the page URL plus .md.
/tokens.jsonEvery --mk-* custom property: name → value, dark value, kind, group and status.
/search.jsonThe 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 accepted or provisional.
  • 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.