**Status:** proposed | accepted | superseded by ADR-MMM **Date:** YYYY-MM-DD ## Context What problem or force drove this decision? ## Decision What was decided, stated plainly. ## Consequences What becomes easier, what becomes harder, what must now be true. ``` Write an ADR whenever a choice is expensive to reverse (ORM, validation strategy, folder layout, auth model). Agents working in this repo should read existing ADRs before proposing conflicting changes.

# Architecture Decision Records

One file per decision, named `NNN-short-title.md` (e.g. `001-orm-choice.md`).

Format for each ADR:

```markdown
# ADR-NNN: <Title>

**Status:** proposed | accepted | superseded by ADR-MMM
**Date:** YYYY-MM-DD

## Context
What problem or force drove this decision?

## Decision
What was decided, stated plainly.

## Consequences
What becomes easier, what becomes harder, what must now be true.
```

Write an ADR whenever a choice is expensive to reverse (ORM, validation
strategy, folder layout, auth model). Agents working in this repo should
read existing ADRs before proposing conflicting changes.