1. Record Architecture Decisions

Status: Accepted

Context

We need to record the architectural decisions made on this project to preserve context for future contributors and our future selves.

Decision

We will use Architecture Decision Records (ADRs) in the format described by Michael Nygard. Each ADR describes a single decision with its context and consequences.

ADRs are stored in docs/explanations/decisions/ and numbered sequentially.

Consequences

• Decisions are documented and searchable

• New contributors can understand why things are the way they are

• Small overhead per decision (one markdown file)