# Wiki conventions

kb/AGENTS.md is the schema layer of this wiki: the layout, the category list and the page rules. It exists so a new
page can be added without inventing structure each time.

The rules that matter: one concept per file, the file name is the link target, every page cross-references 3 to 6
others and every link must resolve, measured numbers are stated with the artifact they came from, and a decision
page names the old behaviour, its cost, the replacement, and what it broke.

The wiki is deliberately separate from the repository's own documentation. raw/ holds copies of README, the spec,
the implementation plan, the design contract and the decisions ledger - copied, never edited in place - so the pages
above have citable sources. Keeping the wiki in its own root also keeps its generated graph in kb/.ua/ instead of
overwriting the code graph at the repository root.

Related: [[Gitea remote]], [[Design contract]], [[Running locally]].