377201015f
- Add docs/decisions/README.md: ADR format guide and index - Add docs/decisions/ADR-0001-vocab-layer-invariants.md - Add docs/decisions/ADR-0002-ingest-layer-design.md - Add docs/decisions/ADR-0003-coordinate-system-dissolution.md - Add docs/decisions/ADR-0004-rotor-as-operator-not-property.md - Add docs/decisions/SESSION-2026-05-12.md: full timestamped session log
51 lines
1.6 KiB
Markdown
51 lines
1.6 KiB
Markdown
# 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
|
|
|
|
```markdown
|
|
# 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](ADR-0001-vocab-layer-invariants.md) | VocabManifold Versor Invariant | 2026-05-12 | Accepted |
|
|
| [ADR-0002](ADR-0002-ingest-layer-design.md) | Ingest Layer Architecture | 2026-05-12 | Accepted |
|
|
| [ADR-0003](ADR-0003-coordinate-system-dissolution.md) | Coordinate System Dissolution | 2026-05-12 | Accepted |
|
|
| [ADR-0004](ADR-0004-rotor-as-operator-not-property.md) | Rotor as Operator, Not Vocabulary Property | 2026-05-12 | Accepted |
|