Canon¶
The canon layer is the UCCA project's deepest authority: the documents written to be true and to change rarely. Everything else in the project — ground reports, strategy, product surfaces — is built on what is stated here. When a lower-layer document conflicts with canon, canon wins; flag the conflict rather than working around it.
Canon lives here (and not in the engine repo) because it governs the whole project, not just the code, and because it includes the honest ledger — which belongs behind the knowledge site's access restriction.
The documents¶
- UCCA-FOUNDATION-01 — what the engine is — the first stone. What the engine is, the one rule every client inherits ("raises hands, never signs"), and an honest ledger of what exists on disk versus what has been claimed.
- Canon Register (living) — the maintained list of the project's true documents; the living successor to CAPTURE-01 §4.
- UCCA-CAPTURE-01 — capture & filing plan — non-canon scaffolding: the 2026-07-01 session's rulings, pinned so nothing sinks.
Decisions¶
Canon-level architecture decisions are recorded as ADRs under
Decisions → Canon ADRs. This series (ADR-000N) is
separate from the infrastructure ADR series (adr-001…adr-005).
Rate-of-change filing¶
A document's home is decided by how often it changes:
| Layer | Changes | Where |
|---|---|---|
| Canon | rarely | here (canon/) |
| Ground — true today | as reality changes | ground reports (SEED, RTOpacks needs) |
| Strategy — true for now | as we learn / market moves | strategy/ |
| Decisions — append-only | grows | decisions/ |
| Narrative — frozen | historical | narratives/ |