Architecture Decision Records
A log of significant architecture and technology decisions, captured at the time they were made. ADRs document what was decided, why, and what alternatives were rejected — context that is otherwise lost as the codebase evolves.
Format
Each ADR follows this structure:
- Status — Proposed / Accepted / Deprecated / Superseded
- Context — the situation that forced a decision
- Decision — what was decided
- Consequences — what changes, what gets harder, what gets easier
- Rejected alternatives — what was considered and why it was ruled out
Naming convention
NNNN-short-title.md — zero-padded four-digit sequence number followed by a kebab-case title.
ADR index
| ADR | Title | Status |
|---|---|---|
| ADR-0001 | Pause Qubital Development for Business Overhaul | Accepted |
| ADR-0002 | Abandon Grafana Cloud | Accepted |
| ADR-0003 | Migrate Documentation from MkDocs to Docusaurus | Accepted |
Phase 0 note: the three ADRs above currently live in
../incoming/adr/and will be migrated here as the final step of Phase 0. New ADRs should be added directly to this folder.