/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] [--from spec|generate|review] [--remediate] [--cap N] [--maintenance] [--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 بوصفها مُلفِّفًا ذا حلقة مغلقة واحدًا يمكن استدعاؤه عند أيّ نقطة: يفحص الحالة ويُشغِّل الأطوار المفقودة فقط. وهو متميّز عن سلسلة تدقيق الحصن (تُدخَل عند /code-review، وطرفية عند /threat-model-audit)، التي تُدقِّق في قاعدة شِفرة مُنفَّذة بدلًا من حزمة خطّة.
أطوار سير العمل
- حلّ الهدف — يحلّ الحزمة من الوسيط، أو يختار الحزمة الأحدث تعديلًا تحت
.apothem/plans/(.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/ --remediate --cap 2