core/docs/decisions
2026-05-12 22:13:29 -07:00
..
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
ADR-0006-field-energy-operator.md docs: ADR-0006 field energy operator, ADR-0007 valence layer, session addendum 2026-05-12-b 2026-05-12 22:13:29 -07:00
ADR-0007-valence-layer.md docs: ADR-0006 field energy operator, ADR-0007 valence layer, session addendum 2026-05-12-b 2026-05-12 22:13:29 -07:00
README.md
SESSION-2026-05-12-b.md docs: ADR-0006 field energy operator, ADR-0007 valence layer, session addendum 2026-05-12-b 2026-05-12 22:13:29 -07:00
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