0001 — Record architecture decisions¶
Status: accepted (2026-07-23)
Context¶
The repository's early history is four same-day commits, one of which deleted the entire backend; the reasoning behind what was kept, removed, and restored exists nowhere but in people's heads. The platform is now being built out (deploy stack, admin portal, monitoring, docs) and those choices deserve a durable record.
Decision¶
Keep Architecture Decision Records in docs/decisions/, one file per
significant choice, numbered sequentially, in the same format the Karat
repository uses (Context / Decision / Consequences).
Consequences¶
New significant choices (framework, storage, deployment model, security posture) get an ADR in the same PR that implements them.