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

  • Status: Proposed | Accepted | Superseded by ADR-NNNN
  • Date: YYYY-MM-DD
  • Relates to: docs/ARCHITECTURE.md §N

Context

What forces are at play? What makes this a decision rather than an obvious call? State the constraints honestly, including the ones that are about time or taste rather than engineering.

Decision

What was decided, in the active voice. One paragraph if possible.

Alternatives considered

What else was on the table, and the specific reason each was rejected. “It was worse” is not a reason.

Consequences

What becomes easy, what becomes hard, and what is now expensive to reverse. List the costs, not only the benefits — this is the section future readers come for.