docs-template/decisions/ADR-0001-example.md

ADR-0001: Example ADR

Date: 2026-05-09 Status: accepted

Context

This is an example to show the ADR shape. Replace with your real first decision and renumber the file accordingly.

Decision

Use the ADR pattern from Michael Nygard's article ("Documenting Architecture Decisions"): short, context-then-decision-then-consequences, one decision per file, append-only.

Consequences

• Decisions are searchable and history-stable
• Old decisions stay readable even after they're superseded
• New contributors can read the ADR folder to understand "why is this the way it is"