| .. | ||
| ADR-0001-vocab-layer-invariants.md | ||
| ADR-0002-ingest-layer-design.md | ||
| ADR-0003-coordinate-system-dissolution.md | ||
| ADR-0004-rotor-as-operator-not-property.md | ||
| ADR-0005-language-pack-contract.md | ||
| README.md | ||
| SESSION-2026-05-12-language-packs-addendum.md | ||
| SESSION-2026-05-12.md | ||
Architecture Decision Records (ADRs)
This directory records every significant architectural decision made in the design and implementation of CORE. Each record is immutable once written — if a decision is superseded, a new ADR is created that references and replaces it. Old ADRs are never deleted or edited.
Format
docs/decisions/ADR-NNNN-short-title.md ← formal architectural decisions
docs/decisions/SESSION-YYYY-MM-DD.md ← timestamped working session logs
ADRs record decisions. Session logs record the reasoning process, open questions, and implementation details discovered during active development. Both are permanent record.
ADR Template
# ADR-NNNN: Title
**Date:** YYYY-MM-DD
**Status:** Proposed | Accepted | Superseded by ADR-XXXX
**Deciders:** [names/handles]
## Context
What situation or problem prompted this decision.
## Decision
What was decided, precisely.
## Rationale
Why this and not the alternatives. Which axiom(s) it serves.
## Consequences
What becomes easier. What becomes harder. What is now forbidden.
## Alternatives Considered
What was explicitly rejected and why.
Index
| ADR | Title | Date | Status |
|---|---|---|---|
| ADR-0001 | VocabManifold Versor Invariant | 2026-05-12 | Accepted |
| ADR-0002 | Ingest Layer Architecture | 2026-05-12 | Accepted |
| ADR-0003 | Coordinate System Dissolution | 2026-05-12 | Accepted |
| ADR-0004 | Rotor as Operator, Not Vocabulary Property | 2026-05-12 | Accepted |