1. Record architecture decisions

Date: 2026-07-14

Status

Accepted

Context

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

Decision

We will use Architecture Decision Records (ADRs), as described by Michael Nygard, to document significant architectural decisions.

Consequences

• Each significant decision gets a concise, versioned record.
• New contributors can understand why the codebase is shaped the way it is.
• ADRs are immutable once accepted; superseded decisions are marked and linked to their replacements.

Template

Subsequent ADRs follow this structure: title, date, status, context, decision, consequences.