Truth Surfaces¶
Why This Matters¶
Ledger is only manageable if each kind of truth has one clear home.
Truth Map¶
| Kind of truth | Home | Working rule |
|---|---|---|
| approved human doctrine | docs/ |
canon only |
| pre-canon exploration | research/ |
draft only |
| proposal and decision history | records/ |
durable record |
| machine-readable control rules | meta/ |
operational source |
| lifecycle and standards rules | governance/ |
enforceable guidance |
| contract baselines | specs/ |
versioned control contract |
| reusable forms and checklists | templates/ |
pattern reuse |
| verification proof | evidence/ |
closure surface |
Promotion Path¶
flowchart TD
A["Research or draft"] --> B["Proposal or decision"]
B --> C["Canon or spec"]
C --> D["Execution / enforcement"]
D --> E["Evidence and closeout"]
Current Freeze Points¶
These should be treated as stable until governed revision says otherwise:
- the active Phase 1 shell
- the project-centered execution spine
- the kernel/company boundary
docs/vsresearch/separation
Current Draft Zones¶
These are still evolving and should not be mistaken for implementation truth:
- broader company operating architecture research
- phase expansion maps beyond the current shell
- future value-stream depth outside the current Phase 1 wedge
Stronger Sources¶
Use the stronger repo surface that matches the kind of truth you need: