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

0001: Record architecture decisions

Date: 2026-05-18

Status

Accepted

Context

We need to record the architectural decisions made on this project.

Decision

We will use Architecture Decision Records, as described by Michael Nygard.

Consequences

  • Every significant architectural decision should have an ADR
  • ADRs are immutable once accepted (amendments create new ADRs)
  • ADRs live in docs/decisions/ and are versioned with the code