Skip to content

Architecture Decisions

github-actions[bot] edited this page Oct 4, 2026 · 11 revisions

Generated reference. This page is published automatically from the version-controlled repository. Canonical source: docs/architecture/decisions/README.md. Do not edit this wiki page directly.

Architecture Decision Records

Architecture Decision Records preserve the small set of durable choices that future contributors and agents must not continually rediscover from PR history.

Rules

  • Accepted ADRs are historical records. Do not rewrite their decision to match later code.
  • If a decision changes, add a new ADR with Supersedes: and mark the earlier record Superseded by: in a follow-up metadata-only edit.
  • ADRs describe why a durable boundary exists, not implementation status. docs/ROADMAP.md remains the status authority.
  • A proposal that changes an accepted ADR should normally pass through docs/RFC_PROCESS.md before implementation.

Format

Each ADR contains:

  • Status
  • Date
  • Context
  • Decision
  • Consequences
  • Supersedes / Superseded by, when applicable

Accepted decisions

Clone this wiki locally