معاينة عامة
أرشيف Architecture Decision Records
كل قرار مهمّ: سياق، خيارات، قرار، عواقب — صفحة واحدة، رقم متسلسل.
الهدف
منع «لماذا قرّرنا هذا قبل سنة؟ نسينا» — ذاكرة مؤسّسيّة للقرارات.
الخطوات
-
1
صنّف القرارات السابقة الكبيرة (6 أشهر).
النتيجة المتوقّعة
فوريًا
تكتشف قرارَين قديمَين لم تعد تذكر سياقهما.
المرجع العلمي
المدرسة: 12-Factor / Architecture Decision Records
الروّاد: Michael Nygard · Adam Wiggins (2011)
Nygard — Cognitect blog post 2011 «Documenting Architecture Decisions» قدّم ADR؛ Wiggins (Heroku) — 12-Factor App شاع التوثيق المنظّم.
الكلمات المفتاحية
#adr#nygard#wiggins#documentation#knowledge-management#pyramid#minto#architecture#decision#memory#adam-wiggins#12-factor-app#أرشيف قرارات المعمار#ذاكرة مؤسسية#ترقيم متسلسل#cognitect-blog#ملف ماركداون في repo#deprecated-by-adr-n#2011-توثيق-قرارات-المعمار#قرار جديد قبل التنفيذ#heroku-12-factor-app#أي قرار قبل سنة لا تذكرون لماذا#ذاكرة مؤسسية للقرارات الكبيرة#منع نسيان لماذا قررنا هذا#قرارات كبيرة آخر ستة أشهر
الأسئلة الشائعة
كم يستغرق تمرين "أرشيف Architecture Decision Records"؟
يستغرق هذا التمرين 50 دقيقة تقريبًا، يُمارَس بمفردك، ونمط الممارسة: فعل.
متى ألاحظ أثر "أرشيف Architecture Decision Records"؟
تكتشف قرارَين قديمَين لم تعد تذكر سياقهما. وعلى المدى القصير: بعد 6 أشهر، استدعاء «لماذا فعلنا هذا؟» يأخذ ثوانٍ.
هل "أرشيف Architecture Decision Records" مبنيّ على أساس علميّ؟
نعم — يستند إلى 12-Factor / Architecture Decision Records (Michael Nygard، Adam Wiggins (2011)). Nygard — Cognitect blog post 2011 «Documenting Architecture Decisions» قدّم ADR؛ Wiggins (Heroku) — 12-Factor App شاع التوثيق المنظّم.
هل "أرشيف Architecture Decision Records" مناسب للمبتدئين؟
مستوى صعوبته: متقدم. لا يتطلّب أدوات خارجية — يمكن ممارسته مباشرة داخل التطبيق.
اشترك للوصول الكامل
اشترك في Plus للوصول الكامل لهذا التمرين وكل الكتالوج، أو جرّب أولاً بلا تسجيل ولا التزام.
7 تمارين كاملة (واحد من كل نطاق) مجانًا ودائمًا بلا تسجيل.