Skip to content

ADR 0014: Living specifications by capability with change deltas

Status: Proposed · 2026-11-17 (milestone M3 · Living specifications and survey; decision tracked in #78, #82)

Context

Specifications written per feature stop describing the system once the feature ships.

Decision

The current behaviour lives in one specification per capability. Every change is a delta of requirements (added, modified, removed, renamed), reviewed with the code and merged into the living specification when the change closes.

Consequences

The behaviour of the system is always readable in one place. Reviews read only the delta.