Skip to content

ADR-0003: Plans use immutable revisions

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

Context

A mutable plans.content plus round counter makes old reviews ambiguous after edits.

Decision

A Plan has immutable PlanRevision records. Reviews/annotations bind to one exact revision.

Consequences

Rejection creates later revision content; approved revision remains identifiable forever.

Change rule

If implementation evidence proves this wrong, update the canonical architecture/product document first and then supersede/amend this ADR. The ADR is not allowed to keep current docs stale.

Forge is local-first. The docs are part of the product engineering system.