Skip to content

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.