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.

| 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 |

يُنشئ سجلات قرارات الهندسة المعمارية (ADRs) التي تلتقط السياق وأساس القرار المنطقي والبدائل التي تم النظر فيها والعواقب المتوقعة. يُنتج مستندات مرقمة ومتتبعة للحالة باتباع تنسيق ADR القياسي مع دورة حياة البيانات التعريفية المناسبة. المشغلات على: "اكتب ADR"، "توثيق هذا القرار"، "سجل قرار التصميم المعماري"، "لماذا اخترنا"، "التقاط هذا القرار"، "تسجيل القرار"، "ADR لـ"، "توثيق البنية"، "سجل القرار"، "قرار التصميم"، "القرار الفني". استخدم هذه المهارة عندما يلزم توثيق قرار معماري أو فني. المصدر: mathews-tom/praxis-skills.