architecture-decision-records
Installation
SKILL.md
Architecture decision records
When to write an ADR
| Write ADR | Skip ADR |
|---|---|
| New framework or major dependency | Minor version bump |
| Database or storage choice | Bug fix |
| API or integration pattern | Config-only change |
| Security or auth architecture | Routine maintenance |
Lifecycle
Proposed -> Accepted -> Deprecated -> Superseded
Do not rewrite accepted ADRs; add a new ADR that supersedes the old one.