Contents

ADR-0001: Record architecture decisions

• Status: Accepted
• Date: 2026-09-29

Context

Reelwright has several decisions that are expensive to reverse (process split, staging model, schema conventions, determinism guarantees). Parallel contributors, human and AI, need to know what was decided, why, and what was rejected.

Decision

Keep lightweight ADRs in docs/adr/NNNN-title.md with Status, Context, Decision, Alternatives and Consequences. An ADR is Proposed until the project owner accepts it. A superseded ADR stays in place with a link to its replacement.

Consequences

Any change that contradicts an Accepted ADR needs a new ADR first. Code reviews may cite ADRs by number.