Architecture Decision Records
Architecture Decision Records (ADRs) document significant technical decisions along with their context and consequences.
Index
| ADR | Title | Status |
|---|---|---|
| 001 | Use Nx monorepo with npm | Accepted |
| 002 | Standalone Angular components only | Accepted |
| 003 | CSS custom property theming engine | Accepted |
| 004 | Generic SSE with marked and Shiki | Accepted |
Template
When adding a new ADR, copy this structure:
# ADR NNN: Title
**Status:** Proposed | Accepted | Deprecated | Superseded by ADR-XXX
**Date:** YYYY-MM-DD
## Context
What is the issue or decision point?
## Decision
What was decided?
## Consequences
What are the positive and negative outcomes?
## Alternatives Considered
What else was evaluated and why was it rejected?
Guidelines
- ADRs are immutable once accepted — supersede rather than edit.
- Number sequentially:
005,006, etc. - Keep them concise (one page max).
- Link from relevant docs and PROGRESS.md.