الإداري · 50 دقائق
أرشيف Architecture Decision Records
كل قرار مهمّ: سياق، خيارات، قرار، عواقب — صفحة واحدة، رقم متسلسل.
الهدف
منع «لماذا قرّرنا هذا قبل سنة؟ نسينا» — ذاكرة مؤسّسيّة للقرارات.
الخطوات
  1. صنّف القرارات السابقة الكبيرة (6 أشهر).
  2. لكل قرار: اكتب ADR بـ4 أقسام (context, options, decision, consequences).
  3. رقّمها متسلسلًا (ADR-001, ADR-002...).
  4. حفظ كـmarkdown في repo (لا Notion — git history).
  5. كل قرار جديد: ADR قبل التنفيذ.
  6. حدّث ADR قديم بـ«deprecated by ADR-N» — لا تحذف.
أيّ قرار اتّخذتموه قبل سنة ولا تذكرون لماذا؟
زينها براكتس · pra.zayenha.com adm-km-295