Decisions and ADRs
Where architectural choices are recorded and how to navigate them.
Linear owns delivery status. Durable why lives in the repo:
| Location | Use |
|---|---|
docs/decisions/README.md |
Decision register (small decisions as rows) |
docs/decisions/accepted/ |
Accepted ADRs |
docs/decisions/proposed/ |
Proposed ADRs |
docs/decisions/superseded/ |
Historical ADRs |
docs/PROGRESS.md |
Append-only build log |
docs/GLOSSARY.md |
Domain terms (Wwft, BSN, …) |
Relevant to the docs stack
- ADR-0012 — Linear as source of truth
- ADR-0018 — API contract and offline OpenAPI generation
When something is unspecified, pick the option most consistent with AGENTS.md, record it in the register (or an ADR), and continue — do not block.
Partner guides: /partner · Architecture: /developers/architecture