Reference — generated from the toolkit
Source of truth: toolkit/templates/adr.md. Edit it there; this page is regenerated on build.
ADR {NNNN}: {short decision title}
- Status: Proposed | Accepted | Superseded by [ADR-XXXX] | Deprecated
- Date: {YYYY-MM-DD}
- Deciders: {names / roles}
- Type: architecture | design | product | toolkit
Context
The forces at play: the problem, the constraints (technical, domain, regulatory, commercial), and what makes this a decision worth recording. State facts, not the conclusion.
Options considered
- {Option A} — summary; key trade-offs.
- {Option B} — summary; key trade-offs.
- …
Decision
The option chosen, stated plainly, and the decisive reason(s).
Consequences
- Positive: what this enables.
- Negative / accepted cost: what it makes harder, and any risk consciously accepted.
- Follow-ups: actions, radar updates, or migrations this triggers.
Revisit by
{a date or a trigger condition} — when this decision should be re-examined. Leave blank only if genuinely permanent.