adr-writer
Installation
SKILL.md
ADR Writer
Captures architecture decisions in a lightweight, structured format that preserves context, rationale, alternatives, and consequences. Produces numbered ADR documents with proper status lifecycle — preventing the "why did we do it this way?" problem when revisiting decisions months later.
Reference Files
| File | Contents | Load When |
|---|---|---|
references/adr-template.md |
Standard ADR template with field explanations and examples | Always |
references/status-lifecycle.md |
Status transitions, supersession rules, deprecation process | ADR references existing decisions |
references/context-capture.md |
Techniques for eliciting and documenting decision context | Complex or multi-stakeholder decision |
references/alternatives-analysis.md |
Framework for evaluating and documenting rejected alternatives | Multiple options being considered |