/plan-review
/plan-review — تدقيق جنائي لحزمة خطة قائمة — أمانة النثر، والاتّساق، والجودة.
الدور: المُدقِّق الموضع في خط المعالجة: وسطي
تدقيق جنائي لحزمة خطة قائمة — أمانة النثر، والاتّساق، والجودة.
الاستدعاء المعياري
/plan-reviewمع الوسائط:
/plan-review [path/to/plan-suite/] [--focus AREA] [--dry-run]المدخلات
حزمة خطة مُولَّدة + _inputs/handoff-manifest.yml من /plan-generate.
المخرجات
بطاقات تقييم المراجعة في PLAN-NOTES.md (## Review Scorecards)، وملخّص المراجعة في PROGRESS.md، وخرائط أثر التنقيح لكل اكتشاف في PLAN-NOTES.md (التقارير الكبيرة الدائمة في _outputs/)، و_inputs/handoff-manifest.yml المُعزَّز الحامل لحُكم المراجعة.
المراحل اللاحقة
/plan-design (مشروط — للحزم الحاملة لمعمارية فقط) ثم /plan-execute؛ أمّا الحزم غير الحاملة لمعمارية فيستهلك /plan-execute بطاقات تقييم المراجعة مباشرةً لضبط التنفيذ عند مستوى SHARED فأعلى.
مراحل سير العمل
يُجري الأمر تدقيقًا جنائيًّا أعمى سطرًا بسطر، ثم يصقل عبر أسئلة وأجوبة تفاعلية:
- تحميل السياق — قراءة كل ملفات حزمة الخطة (
phases/**/PHASE.md، وملفات البنية التحتية، والتقارير) وبيان التسليم الأعلى منها؛ والرفض بـBlocked: run /plan-generate firstعند غياب الحزمة. - التدقيق — مسح الأبعاد (أمانة النثر، والاتّساق الداخلي، والاكتمال، والجودة، والمخاطر، والمعايير، والمجال، والمعمارية، والجودة الإبداعية) تحت تكليف المراجعة العمياء.
- فرز الاكتشافات — البتّ في كل اكتشاف (قبول · تنقيح · رفض · تأجيل) عبر قناة الاستفسار المُهيكَل مع عدّ الخطورة لكل اكتشاف.
- تشغيل بوّابة ما قبل الإصدار — تشغيل البوّابة ذات الخمسة عشر شريطًا مقابل تقرير المراجعة وبطاقات التقييم المُحدَّثة؛ والفشل يمنع الترقية.
- إصدار المراجعة — كتابة بطاقات تقييم المراجعة إلى
PLAN-NOTES.md، وملخّص المراجعة إلىPROGRESS.md، وبيان التسليم المُعزَّز.
أنماط الفشل
| العَرَض | السبب | المعالجة |
|---|---|---|
| Blocked: run /plan-generate first | لا توجد حزمة مُولَّدة | شغّل /plan-generate لإنتاج الحزمة التي يدقّقها هذا الأمر |
| اكتشافات مفتوحة باقية | كشف التدقيق عيوبًا غير محسومة | احسم كل اكتشاف (قبول · تنقيح · رفض · تأجيل) قبل الحُكم النهائي |
| بطاقة تقييم FAIL | بُعد يهبط دون عتبة CONDITIONAL | عالِج البُعد المُخفِق وأعد المراجعة |
أمثلة
# تشغيل تجريبي لمعاينة نطاق التدقيق
/plan-review --dry-run
# تدقيق حزمة خطة مُسمّاة، مُركَّز على منطقة واحدة
/plan-review path/to/plan-suite/ --focus architecture