Skip to content

PLANS.md

يحدد هذا الملف كيفية إنشاء خطط التنفيذ وتحديثها وإكمالها وأرشفتها.

متى تكون الخطة مطلوبة

أنشئ خطة تنفيذ عندما يكون العمل:

  • يمتد عبر أكثر من جلسة واحدة
  • يغيّر أكثر من نظام فرعي واحد
  • يحمل مخاطر تحقق أو طرح غير بسيطة
  • يعتمد على قرارات مفتوحة يجب تسجيلها

مواقع الخطط

  • docs/exec-plans/active/: الخطط التي تقود العمل حاليًا
  • docs/exec-plans/completed/: الخطط المنتهية المحفوظة لسياق الوكلاء المستقبلي
  • docs/exec-plans/tech-debt-tracker.md: العمل المؤجل والمتابعات

أقسام الخطة كحد أدنى

  • الهدف
  • النطاق وخارج النطاق
  • مسار التحقق
  • المخاطر والعوائق
  • سجل التقدم
  • القرارات المفتوحة

قواعد التشغيل

  • يجب أن تحتوي الخطة النشطة الواحدة على خطوة حالية مملوكة بوضوح.
  • حدِّث الخطة مع تقدم العمل؛ لا تعاملها كنص ثابت.
  • إذا غيّر قرار مسار التنفيذ، سجّله في الخطة.
  • انقل الخطط المنتهية إلى completed/ حتى يتمكن الوكلاء من اكتشاف السياق السابق.