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/ |
Architecture, schemas, protocols. Populated in Phase 2. |
adr/ |
Architecture Decision Records — immutable once accepted. |
Every doc carries machine-readable front-matter so freshness and traceability are visible:
---
title: ...
status: draft | active | frozen | superseded
last_updated: YYYY-MM-DD
owner: ...
related_aps: [AP-0001, ...]
related_adrs: [ADR-0001, ...]
---