/plan-audit
/plan-audit — حارسٌ ذو حلقة مغلقة لخط أنابيب /plan — يلفّ spec → generate → review ويُعالِج النتائج معالجةً نشطة حتى تصير الحزمة كُلًّا مُراجَعًا بلا نتائج.
الدور: الحارس الموضع في خط الأنابيب: ملفِّف / متعامد (قبل التنفيذ)
حارسٌ ذو حلقة مغلقة لخط أنابيب /plan. حيث يُبلِّغ /plan-review عن حزمة مُولَّدة ويُنقِّحها، يلفّ /plan-audit الدورة المنبعية (/plan-spec → /plan-generate → /plan-review) ويقود الحزمة إلى كُلٍّ مُراجَعٍ بلا نتائج — مُشغِّلًا المراحل المنبعية المفقودة فقط، ومُدقِّقًا في النتيجة، ومُصلِحًا في مكانها النتائج القابلة للحل آليًا، ومُظهِرًا مفارق الحُكم عبر قناة الاستفسار المُهيكَل، ومُكرِّرًا حتى تصير الحزمة نظيفة أو يُطلَق تراجعٌ محدود. وهو لا يُنفِّذ أبدًا عمل تنفيذ المراحل؛ بل يترك الحزمة جاهزةً لـ /plan-execute.
الاستدعاء القانوني
/plan-auditمع وسائط:
/plan-audit [suite-path] [--cap N] [--dry-run]المُدخَلات
_spec/spec.md الخاص بالحزمة الهدف، و_inputs/handoff-manifest.yml، وملفّات البنية التحتية، وphases/**/PHASE.md، وأيّ تقارير مراحل قائمة.
المُخرَجات
تقريرٌ دائمٌ ومحدودٌ عند <suite>/_outputs/audit-report-<YYYY-MM-DD>.md؛ وبيان تسليم مُحدَّث يحمل حُكم انعدام النتائج، وعدد النتائج المفتوحة، وسجلّ المعالجة، وأيّ توجيه صيانة؛ وحالة طرفية غير صفرية عندما تبقى نتائج متبقّية.
الموضع في خط الأنابيب
/plan-audit متعامد مع خط الأنابيب الخطّي، وليس مرحلةً داخله. التسلسل الخطّي القانوني هو /plan-spec → /plan-generate → /plan-review → /plan-design (شرطي، للحزم الحاملة للمعمارية فقط) → /plan-execute. ويشمل /plan-audit المراحل /plan-spec → /plan-generate → /plan-review بوصفه مُلفِّفًا واحدًا ذا حلقة مغلقة يمكن استدعاؤه عند أيّ نقطة: يفحص الحالة، ويشغّل المراحل المفقودة فقط. ومن دون مواصفة مكتوبة ولا حزمة مُولَّدة، يرفض التنفيذ برسالة Blocked: run /plan-spec first (ويتجاوز --override البوابة، ويسجّل التجاوز ملاحظةً في PLAN-NOTES.md، مع ذكر المبرّر والشرط المسبق المفقود). وهو يختلف عن تسلسل مراجعة التدقيق (يُدخَل إليه عند /code-review، وطرفيّته /threat-model-audit)، الذي يُدقِّق في شيفرة مُنفَّذة بدلًا من حزمة خطّة.
مراحل سير العمل
- حلّ الهدف — يحلّ الحزمة من الوسيط، أو يختار الحزمة الأحدث تعديلًا تحت
.apothem/plans/ويُعلِن عن الحلّ. - تقييم المرحلة — يكشف أيّ آثار موجودة (spec جاهز / مُولَّد / مُراجَع / مُنفَّذ) ويُسمّي أصغر فجوة نحو كُلٍّ مُراجَعٍ قابلٍ للتنفيذ.
- الوصول إلى كُلٍّ قابلٍ للمراجعة — يُشغِّل المراحل المنبعية المفقودة فقط، مُفوِّضًا كلّ فجوة إلى الأمر القانوني لها؛ ولا يُعيد أبدًا تشغيل مرحلة مستوفاة لمجرّد تحديث النثر.
- التدقيق الجنائي — يُطبِّق أبعاد تدقيق
/plan-review، وكتالوج تقنيات التخطيط، وبوابة ما قبل الإصدار ذات الخمسة عشر شريطًا. - المعالجة النشطة — يُصلِح النتائج الآلية في مكانها؛ ويُظهِر مفارق الحُكم عبر قناة الاستفسار المُهيكَل؛ ويُوجِّه العمل الخارج عن النطاق شرعًا إلى حزمة شقيقة
*-maintenance. - حلقة بسقفٍ وتراجع — يُكرِّر التدقيق-والمعالجة حتى لا تبقى نتائج مفتوحة، محدودًا بسقف تكرار (الافتراضي 3) مع تراجعٍ مُعرَّف عند استنفاد السقف.
أنماط الإخفاق
| العَرَض | السبب | التعافي |
|---|---|---|
| استُنفِد السقف مع نتائج متبقّية | نتائج غير قابلة للحل ضمن سقف التكرار | راجِع تقرير التدقيق؛ ووجِّه البنود المؤهَّلة إلى حزمة *-maintenance؛ ولا ترفع --cap إلّا بمبرّر |
| مفترق حُكم غير محلول | نتيجةٌ تتطلّب قرار سياسة/نطاق/صلاحية | أجِب على مُحَثّ الاستفسار المُهيكَل؛ فالحلقة لا تختار في صمت أبدًا |
| غياب spec ذي مرجعية | لا يوجد _spec/spec.md | يُوجِّه المُلفِّف إلى /plan-spec لتأليفه |
| بوابة الجودة FAIL | المُخرَج لا يفي بالمعايير | تُصلِح المعالجة السبب الجذري وتُعيد تدقيق المواضع المُلامَسة |
أمثلة
# Dry-run: report detected suite, stage, planned audit dimensions, would-write targets
/plan-audit --dry-run
# Audit and actively remediate a named suite, capping the loop at 2 iterations
/plan-audit path/to/plan-suite/ --cap 2