Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

ADR-NNNN: Title in imperative or noun form

  • Status: Proposed | Accepted | Accepted — validation gate (WP-ID) | Superseded by ADR-NNNN
  • Date: YYYY-MM-DD
  • Deciders: who decided (planner session, owner)
  • Related: requirement IDs, other ADRs, specs, work packages

Context

What problem are we solving? What forces are at play (requirements, constraints, risks, facts about the ecosystem, with dates and sources)?

Decision

What we will do, stated precisely enough that an agent can follow it without interpretation.

Consequences

What becomes easier, what becomes harder, what new obligations we take on.

Alternatives considered

Each serious alternative and why it was not chosen.

Validation gate (if any)

The work package that must confirm this decision, and the measurable criteria. What happens if they fail.

Revisit when

Observable triggers that should cause a planning session to reconsider this decision.