ADR 0001: Record architecture decisions

Published

September 25, 2026

Context

Decisions about this project have been made in conversation and spread across NOTES.md, BACKLOG.md and commit messages. Faculty trust depends on being able to say why the system works the way it does.

Decision

Keep short Architecture Decision Records in docs/adr/, numbered, one decision each, with Context / Decision / Consequences. Write one only for a choice that is hard to reverse or that someone will later ask “why?” about. Supersede a record rather than editing it.

Consequences

The Quarto site lists ADRs next to the plan and notes. Small, reversible choices stay in commit messages.