# Wiki conventions (schema layer)

This directory is a Karpathy-pattern wiki: raw sources, wiki pages, and this schema file.

## Layout
- `raw/` — immutable sources copied from the repository. Never edited here.
- `index.md` — the catalog, grouped by category. Every page appears exactly once.
- `log.md` — chronological record of what was added, and why.
- `<Page Name>.md` — one page per concept. File name is the link target.

## Categories
- Pipeline
- Data and storage
- Security and credentials
- Interface
- Verification
- Operations
- Decisions

## Page rules
1. Start with `# <Page Name>`, then 120 to 250 words of prose.
2. Cross-reference with `[[Page Name]]`. Every page links 3 to 6 others, and every link must resolve.
3. State measured facts (numbers, timings, error strings) instead of adjectives. Note the measurement when it
   came from a specific artifact.
4. A page about a decision says: what the old behaviour was, what it cost, what replaced it, what it broke.
5. No code blocks longer than 5 lines. Long code belongs in `raw/`.