Skip to content

MR-7 — Decision docs are append-only

You do not edit a closed decision doc to “fix” what it said. You write a new decision doc that supersedes it. The new doc references the old:

## Supersedes
- `docs/decisions/2026-04-26-soak-result.md` — superseded by this doc on
<reason>. The original verdict is preserved for traceability.

The old doc gets a ## Superseded-by block prepended:

> **Superseded** by `docs/decisions/YYYY-MM-DD-<new>.md` on YYYY-MM-DD.
> Original content preserved below for traceability.

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



Return to the meta-rules index.