الجزء الأول: شرح كامل
سجلّ قرارات المعمار (ADR)
لكل قرار مهمّ: ملف نصّي يحوي السياق، البدائل، الاختيار، العواقب.
الهدف
منع «نسيان لماذا قرّرنا هذا قبل سنة» الذي يجعل الفريق يكرّر النقاشات.
الخطوات
-
1
العنوان: «ADR-NNN: [قرار قصير]».2 دقائق
-
2
الحالة: مقترح / مقبول / مرفوض / مهجور.2 دقائق
-
3
السياق: ما المشكلة؟ ما القيود؟6 دقائق
-
4
البدائل التي درست (2-4) — مع إيجابيات وسلبيات.10 دقائق
-
5
القرار: ما اخترنا ولماذا.6 دقائق
-
6
العواقب: ما الذي يصبح أسهل/أصعب نتيجة هذا.6 دقائق
النتيجة المتوقّعة
فوريًا
الفريق الجديد يفهم «لماذا» بدل أن يحاول إعادة المناقشة.
خلال أسبوع
بعد 6 أشهر، ADRs الـ12 الأولى توفّر 40 ساعة اجتماعات.
علامة النجاح
≥ 10 ADRs مكتوبة، مفهرسة برقم.
إن لم تنجح
إن أصبحت كل ADR صفحة من 5 صفحات، فأنت لا تستخدم — ADR ≤ صفحة.
سؤال التأمّل
أيّ قرار حديث يجب أن يُكتب كـADR؟
المرجع العلمي
المدرسة: ThoughtWorks Tech Radar
الروّاد: Michael Nygard (2011)
Nygard — مقال «Documenting Architecture Decisions» (2011)؛ معيار في ThoughtWorks وفي AWS Well-Architected.
الكلمات المفتاحية
طبّق الآن
سجلّ قرارات المعمار (ADR): تطبيق تفاعلي مصمَّم لهذا التمرين. مدّته 30 دقيقة. كلّ widget يحفظ مدخلاتك تلقائيًّا.