ADR-0001: Canonical docs stay current

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

Context

The earlier Forge repository required readers to combine stale PRD/TDS text with later ADRs. That is expensive for humans and AI agents.

Decision

Canonical product/architecture/design documents describe current truth. ADRs explain important reasons and history; archived specs never override current docs.

Consequences

When a decision changes, update the canonical document in the same change. Add/amend an ADR when the reason is worth preserving.

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.