0. ADR Template

Template for new architecture decision records. Copy it, rename it to NNNN-kebab-title.md and replace every placeholder.
  • Status: proposed | accepted | superseded by ADR-M
  • Date: YYYY-MM-DD (board meeting where it was decided)
  • Deciders: …

Context

What is the problem, and what forces are at play? A few paragraphs; list decision drivers only if they help.

Decision

The rules, written with MUST / SHOULD / WILL.

Alternatives

  • Option A — rejected because …
  • Option B — rejected because …

Consequences

  • Good: …
  • Bad: …

Open Questions

Optional. What the board has not decided yet.

Current State

Optional. Where the code deviates from the decision.

Optional. Related ADRs and pages, e.g. Supersedes [ADR-M]({{< relref "docs/architecture/adr/…" >}}).

Last modified October 22, 2026: Update documentation (f481966)