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 |
Genera registros de decisiones arquitectónicas (ADR) que capturan el contexto, los fundamentos de la decisión, las alternativas consideradas y las consecuencias proyectadas. Produce documentos numerados con seguimiento de estado siguiendo el formato ADR estándar con un ciclo de vida de metadatos adecuado. Activadores de: "escribir un ADR", "documentar esta decisión", "registro de decisión de arquitectura", "por qué elegimos", "capturar esta decisión", "registrar la decisión", "ADR para", "documentar la arquitectura", "registro de decisión", "decisión de diseño", "decisión técnica". Utilice esta habilidad cuando sea necesario documentar una decisión arquitectónica o técnica. Fuente: mathews-tom/praxis-skills.