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.
| 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 |
Generates Architecture Decision Records (ADRs) capturing context, decision rationale, alternatives considered, and projected consequences. Produces numbered, status-tracked documents following the standard ADR format with proper metadata lifecycle. Triggers on: "write an ADR", "document this decision", "architecture decision record", "why did we choose", "capture this decision", "record the decision", "ADR for", "document the architecture", "decision record", "design decision", "technical decision". Use this skill when an architectural or technical decision needs to be documented. Source: mathews-tom/praxis-skills.