Architecture Decision Records
ADR Template
Template for Architecture Decision Records — context, decision, consequences with revenue impact, rejected alternatives, and references.
ADR-XXXX: Title (verb + object)
- Date: YYYY-MM-DD
- Status: Proposed | Accepted | Rejected | Superseded by ADR-NNNN
- Deciders: the owner + the participating agents
- Tags:
strategy|infra|domain|brand|ai|compliance|revenue
Context
The forces and constraints at play (regulatory, cost, PDPL, revenue). Cite the relevant files and earlier decisions.
Decision
One sentence that names the decision, then 2–6 concrete points (paths, services, tables).
Consequences
- Positive —
- Negative —
- Revenue impact (SAR / month, confidence) —
Rejected alternatives
One alternative per line, with the reason it was rejected.
References
Glass Design System
Apple-style liquid glass material contract for every surface of the template (tokens, utilities, components, motion, accessibility, RTL).
ADR-0001: Modular monolith on a monorepo instead of microservices
One database, one auth, one event bus, and every domain as a package under modules/ bound by ModuleManifest.