/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