معاينة عامة
سجلّ قرارات المعمار (ADR)
لكل قرار مهمّ: ملف نصّي يحوي السياق، البدائل، الاختيار، العواقب.
الهدف
منع «نسيان لماذا قرّرنا هذا قبل سنة» الذي يجعل الفريق يكرّر النقاشات.
الخطوات
-
1
العنوان: «ADR-NNN: [قرار قصير]».
النتيجة المتوقّعة
فوريًا
الفريق الجديد يفهم «لماذا» بدل أن يحاول إعادة المناقشة.
المرجع العلمي
المدرسة: ThoughtWorks Tech Radar
الروّاد: Michael Nygard (2011)
Nygard — مقال «Documenting Architecture Decisions» (2011)؛ معيار في ThoughtWorks وفي AWS Well-Architected.
الكلمات المفتاحية
#adr#architecture-decision-record#documentation#writing#docs#وثائق#pyramid#minto#nygard#thoughtworks#context-decision-consequences#michael-nygard#سجل قرارات المعمار#بدائل مدروسة#عواقب القرار#فهرسة القرارات#حالة القرار المعتمد#aws-well-architected#عشرة سجلات مفهرسة#صفحة واحدة لكل قرار#أربعين ساعة اجتماعات موفرة#مقترح مقبول مرفوض مهجور#ثوتوركس-تكنولوجي-راديو#بديلان إلى أربعة بدائل#أي قرار حديث يستحق أن يكتب adr
الأسئلة الشائعة
كم يستغرق تمرين "سجلّ قرارات المعمار (ADR)"؟
يستغرق هذا التمرين 30 دقيقة تقريبًا، يُمارَس بمفردك، ونمط الممارسة: إبداعي.
متى ألاحظ أثر "سجلّ قرارات المعمار (ADR)"؟
الفريق الجديد يفهم «لماذا» بدل أن يحاول إعادة المناقشة. وعلى المدى القصير: بعد 6 أشهر، ADRs الـ12 الأولى توفّر 40 ساعة اجتماعات.
هل "سجلّ قرارات المعمار (ADR)" مبنيّ على أساس علميّ؟
نعم — يستند إلى ThoughtWorks Tech Radar (Michael Nygard (2011)). Nygard — مقال «Documenting Architecture Decisions» (2011)؛ معيار في ThoughtWorks وفي AWS Well-Architected.
هل "سجلّ قرارات المعمار (ADR)" مناسب للمبتدئين؟
مستوى صعوبته: متوسط. لا يتطلّب أدوات خارجية — يمكن ممارسته مباشرة داخل التطبيق.
اشترك للوصول الكامل
اشترك في Plus للوصول الكامل لهذا التمرين وكل الكتالوج، أو جرّب أولاً بلا تسجيل ولا التزام.
7 تمارين كاملة (واحد من كل نطاق) مجانًا ودائمًا بلا تسجيل.