Contents

ADR-0001: Record architecture decisions

Status: Accepted
Date: 2026-09-30

Context

Gamewright has decisions that are expensive to reverse: what a game is made of, where code may live, what runs where, and what "deterministic" means. Several contributors, human and AI, work in parallel. They need to know what was decided, why, and what was rejected.

Decision

Keep short ADRs in docs/adr/NNNN-title.md with Status, Context, Decision, Alternatives and Consequences. An ADR is Proposed until the owner accepts it. A superseded ADR stays in place with a link to its replacement. Research that informed a decision lives in docs/research/ and is cited by file and section.

Consequences

A change that contradicts an Accepted ADR needs a new ADR first. Reviews cite ADRs by number.

From docs/adr/0001-record-architecture-decisions.md in the Gamewright repository.