ahmed mohammedandClaude Opus 4.7
8b42a0931c
kb/ is its own wiki root: 34 pages across 7 categories, index.md catalog, log.md, AGENTS.md schema layer, and raw/ holding copies of README, the spec, the 13-task plan, the design master and the SDD ledger. Every page cross-references 3 to 6 others and all 107 wikilinks resolve except two [["list"]] artefacts inside JSON snippets in the copied plan. Kept separate from the repository root on purpose: its generated graph lands in kb/.ua/ instead of overwriting the code graph. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
964 B
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.