Skip to content

ADR-NNNN: Decision Title

  • Status: proposed, accepted, superseded, or rejected
  • Date: YYYY-MM-DD
  • Owners: Named maintainers
  • Related proposal: FP-YYYY-NNN

Context

Describe the demonstrated problem, constraints, trust boundaries, and why existing architecture is insufficient.

Decision

State the decision, contract changes, invariants preserved, and implementation boundaries.

Alternatives

Compare viable alternatives, including doing nothing, with security, compatibility, maintenance, and operational trade-offs.

Consequences

Document positive and negative consequences, risks, costs, accessibility, privacy, performance, sustainability, migration, rollback, and deprecation effects.

Evidence and Review

Link tests, benchmarks, threat model, compatibility report, acceptance evidence, owner, approval, and next review date.