Skip to content

Append-only ledger

Decision docs are append-only

Status
PUBLISHED
Priority
P1
Rank
INVARIANT
Cited
55×
Updated
2026-05-14

Assertion

Decision docs are append-only. To change a closed decision, write a new decision doc that supersedes it.

Why

The lineage is part of the system's memory. Editing closed docs silently destroys it.

Mechanism

The new doc carries ## Supersedes; the old doc gets a ## Superseded-by block prepended. Both preserved for traceability.

Cited by