الجزء الأول: شرح كامل

أرشيف Architecture Decision Records

كل قرار مهمّ: سياق، خيارات، قرار، عواقب — صفحة واحدة، رقم متسلسل.

50 دقائق متقدم فردي فعل

منع «لماذا قرّرنا هذا قبل سنة؟ نسينا» — ذاكرة مؤسّسيّة للقرارات.

1

صنّف القرارات السابقة الكبيرة (6 أشهر).

10 دقائق
2

لكل قرار: اكتب ADR بـ4 أقسام (context, options, decision, consequences).

25 دقائق
3

رقّمها متسلسلًا (ADR-001, ADR-002...).

4 دقائق
4

حفظ كـmarkdown في repo (لا Notion — git history).

6 دقائق
5

كل قرار جديد: ADR قبل التنفيذ.

8 دقائق
6

حدّث ADR قديم بـ«deprecated by ADR-N» — لا تحذف.

6 دقائق

فوريًا

تكتشف قرارَين قديمَين لم تعد تذكر سياقهما.

خلال أسبوع

بعد 6 أشهر، استدعاء «لماذا فعلنا هذا؟» يأخذ ثوانٍ.

علامة النجاح

كل قرار له ADR برقم + التاريخ + المسؤول.

إن لم تنجح

إن كتبت ADR بعد التنفيذ، فأنت تبرّر — لا تقرّر.

أيّ قرار اتّخذتموه قبل سنة ولا تذكرون لماذا؟

المدرسة: 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: تطبيق تفاعلي مصمَّم لهذا التمرين. مدّته 50 دقيقة. كلّ widget يحفظ مدخلاتك تلقائيًّا.