28 lines
1.3 KiB
Markdown
28 lines
1.3 KiB
Markdown
# Architecture Decision Records (ADRs)
|
||
|
||
Canonical directory for all ADRs.
|
||
|
||
All current ADR links should target this directory as `docs/adr/...`.
|
||
`docs/decisions/...` was the historical path and must not be used for new
|
||
references.
|
||
|
||
Runtime execution contracts live in `docs/specs/runtime_contracts.md`; ADRs
|
||
may cite that spec when a decision adds or changes a runtime invariant.
|
||
|
||
## Master Blueprint ADR mapping (2026-07-20)
|
||
|
||
The Master Architectural Specification lists ADR-0240–0253 with titles that
|
||
**collide by number** with Accepted repository ADRs (especially 0246–0252).
|
||
|
||
- **Do not renumber or overwrite Accepted ADRs.**
|
||
- Authoritative reconciliation:
|
||
[`MASTER-BLUEPRINT-2026-07-20-ADR-MAPPING.md`](./MASTER-BLUEPRINT-2026-07-20-ADR-MAPPING.md)
|
||
- Governance freeze decision:
|
||
[`ADR-0253-master-blueprint-adr-collision-and-dual-pack-boundary.md`](./ADR-0253-master-blueprint-adr-collision-and-dual-pack-boundary.md)
|
||
|
||
## Binding non-ADR notes in this directory
|
||
|
||
- [`epistemic-taxonomy-ownership-stage3.md`](./epistemic-taxonomy-ownership-stage3.md)
|
||
— binding ownership note (Master Blueprint Stage 3A, 2026-07-20): the three
|
||
orthogonal epistemic axes (`EpistemicStatus` / `EpistemicState` /
|
||
`GeometricCoherenceVerdict`) must not be collapsed into one enum.
|