---
title: "llms.txt and Markdown pages"
status: accepted
source: "docs/plans/design-system-site.md §7"
updated: "21.11.2026."
url: https://design.mojakirija.rs/agents
---

# llms.txt and Markdown pages

Accepted · docs/plans/design-system-site.md §7

The files an agent loads instead of the HTML, and what they leave out.

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.

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