Architecture Decision Records (ADRs) capture significant technical decisions made in this project, including context, alternatives considered, and consequences.
Use the /adr skill in Claude Code to record new ADRs or query past decisions.
| ADR | Title | Status | Date |
|---|---|---|---|
| ADR-0001 | OSS packages — design decisions (living) | living | 2026-05-27 |
The codebase is in active transition across several axes (see CLAUDE.md). ADRs provide a durable record of:
- Why old patterns are being replaced (e.g. Sequelize → pg-promise)
- What alternatives were considered before choosing the current approach
- What trade-offs were accepted
New contributors can understand constraints without needing to ask — the reasoning is in the ADRs.