adr-writer

# 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 | ## Prerequisites - A decisions directory (typically `docs/adr/` or `docs/decisions/`) - Understanding of the decision being made (may require clarifying questions) ## Workflow ### Phase 1: Identify the Decision 1. **What choice was made?** — Extract the core architectural decision. If th...