Skip to main content

1. Record architecture decisions

Date: 2026-06-03

Status​

Accepted

Context​

We need a lightweight, durable record of architecture decisions so context isn't lost in Slack threads or PR comments.

Decision​

Use Architecture Decision Records (ADRs), one Markdown file per decision, numbered sequentially in docs/adr/.

Each ADR has: Status, Context, Decision, Consequences.

Consequences​

  • New decisions get a file. Old decisions are superseded, not edited.
  • Anyone (including AI assistants) can read the trail to understand why something is the way it is.