Decision Records

Architecture Decision Records document important decisions that affect architecture, governance, technical standards, or durable Playbook direction.

Location

ADR source files live in adr/.

Naming

Use this format:

NNNN-short-decision-title.md

Examples:

0001-record-architecture-decisions.md
0002-select-documentation-platform.md

Status Values

Status	Meaning
proposed	Under review.
accepted	Approved and current.
superseded	Replaced by a later ADR.
rejected	Considered but not adopted.
deprecated	No longer preferred, but not directly replaced.

Process

1. Create a new ADR from templates/adr-template.md or adr/0000-template.md.
2. Assign the next sequential number.
3. Keep the decision focused on one issue.
4. Link related documents and superseded ADRs.
5. Do not mark an ADR accepted without approval.