This tree holds knowledge — the rules we work by and the understanding we build. Live project
state (phases, Action Points, trackers) lives under ../project/.
Rules vs. state:
docs/governance/defines how we work;project/records where we are.
| Area | Contents |
|---|---|
governance/ |
documentation policy · AP workflow · phase process · glossary |
vision/ |
vision · positioning · scope |
concepts/ |
The conceptual framework (Code Harness / Runtime / recovery). Populated in Phase 1. |
research/ |
Related-work survey, claims registry, paper drafts. Populated in Phase 1. |
design/ |
Legacy architecture/specs plus the admitted Continuation Contract v0 and Receipt/Reconciliation Contract v0. |
adr/ |
Architecture Decision Records — immutable once accepted. |
Active design documents carry machine-readable front-matter so freshness and traceability are visible. Sealed contracts and raw evidence retain their admitted bytes; their status and evidence boundary are stated in the document rather than edited for formatting.
---
title: ...
status: draft | active | frozen | superseded
last_updated: YYYY-MM-DD
owner: ...
related_aps: [AP-0001, ...]
related_adrs: [ADR-0001, ...]
---