अनुरूपता

संस्करण 1.0. स्थिति: स्थिर। यह दस्तावेज़ परिभाषित करता है कि किसी रिपॉज़िटरी का Deep Work Plan-अनुरूप होने का क्या अर्थ है — अर्थात्, AI-first और एजेंट-संचालन योग्य। कीवर्ड MUST, MUST NOT, SHOULD, SHOULD NOT और MAY की व्याख्या RFC 2119 में वर्णित अनुसार की जानी है।

अनुरूपता इसलिए मौजूद है ताकि “AI-first” एक प्रभाव के बजाय एक वस्तुनिष्ठ, जाँचने योग्य गुण हो। एक रिपॉज़िटरी या तो नीचे दिए मानदंडों पर खरी उतरती है या नहीं। verify सब-स्किल (/dwp-verify) उन्हें यांत्रिक रूप से जाँचती है।

एक अनुरूप रिपॉज़िटरी

एक DWP-अनुरूप रिपॉज़िटरी को निम्नलिखित सभी संतुष्ट करने MUST। हर आर्टिफ़ैक्ट को रिपॉज़िटरी के लिए तर्क-संगत होना MUST — उसकी वास्तविक भाषाओं, फ़्रेमवर्क और कमांड्स के अनुरूप ढाला हुआ। एक सामान्य स्टब, एक प्लेसहोल्डर, या किसी अन्य रिपॉज़िटरी से कॉपी की गई सामग्री किसी मानदंड को संतुष्ट नहीं करती।

1. रूट पर AGENTS.md। रिपॉज़िटरी में एक रूट AGENTS.md MUST होना चाहिए जिसमें (अ) दस्तावेज़ीकरण का एक इंडेक्स, (ब) रिपॉज़िटरी के लिए अनिवार्य नियम, और (स) एक Quick Commands ब्लॉक हो जिसकी कमांड्स इस रिपॉज़िटरी में वास्तविक और चलाने योग्य हों। प्लेसहोल्डर कमांड्स (उदाहरण के लिए, npm का उपयोग न करने वाली रिपॉज़िटरी में npm test) MUST NOT दिखाई दें।
2. CLAUDE.md, AGENTS.md तक हल होता है। एक CLAUDE.md MUST मौजूद हो और AGENTS.md तक हल हो (एक सिमलिंक, या एक समकक्ष जो सत्य के एक ही स्रोत की गारंटी देता हो)। दोनों MUST NOT अलग हों।
3. एक docs/ पदानुक्रम। रिपॉज़िटरी में एक docs/ डायरेक्टरी MUST हो जो मानक श्रेणियों (आर्किटेक्चर, मानक, परीक्षण, विकास कमांड्स, सुरक्षा, और एजेंट ऑनबोर्डिंग) को वास्तविक, रिपॉज़िटरी-विशिष्ट सामग्री के साथ कवर करती हो। जटिल मॉड्यूल अपना README.md साथ रखने SHOULD।
4. एक .agents/ घर। रिपॉज़िटरी में एक .agents/ डायरेक्टरी MUST हो जिसमें agents/, commands/, और skills/ हों, साथ ही .agents/docs/ के अंतर्गत एक कैटलॉग जो डिस्क पर मौजूद चीज़ से मेल खाता हो। dwp-* कमांड्स को स्थापित स्किल के पतले डेलिगेटर MUST होना चाहिए। एक .claude पाथ .agents तक हल होना MUST।
5. एक gitignored .dwp/ कार्यस्थल। रिपॉज़िटरी में plans/ और drafts/ वाली एक .dwp/ डायरेक्टरी MUST हो, और .dwp/ को gitignored MUST होना चाहिए। एक tmp/ स्क्रैच स्थान मौजूद SHOULD और gitignored SHOULD।
6. पद्धति स्किल हल करने योग्य है। Deep Work Plan स्किल को इस प्रकार स्थापित या संदर्भित MUST किया जाए कि रिपॉज़िटरी में एक एजेंट उसके सब-स्किल्स आमंत्रित कर सके।

एक रिपॉज़िटरी शून्य ऐडऑन के साथ पूर्णतः अनुरूप होती है। ऐडऑन (devcontainer, Dailybot, dependency-upgrade) ऑप्ट-इन हैं और अनुरूपता के लिए आवश्यक MUST NOT।

एक सुगठित योजना

.dwp/plans/ में एक Deep Work Plan सुगठित होती है जब:

1. हर कार्य को एक स्पष्ट दायरा, स्वीकृति मानदंड, और कम से कम एक सत्यापन-गेट (एक कमांड या जाँच जो वस्तुनिष्ठ रूप से पास या फ़ेल होती है) घोषित करना MUST।
2. योजना को प्रगति इस प्रकार स्थायी करनी MUST कि काम व्यवधान से बचे और एक भिन्न एजेंट द्वारा फिर से शुरू किया जा सके।
3. योजना में दो अनिवार्य अंतिम कार्य MUST शामिल हों — Skills & Agents Discovery और Executive Report।
4. कार्यों को निष्पादन से पहले योजना के लक्ष्य से फिर जुड़ना SHOULD, ताकि एक लंबे क्षितिज पर भटकाव रोका जा सके।

अनुरूपता सत्यापित करना

अनुरूपता को निरीक्षण के बजाय यांत्रिक रूप से सत्यापित करना SHOULD। /dwp-verify चलाने से उपरोक्त मानदंडों के विरुद्ध एक पास/फ़ेल रिपोर्ट बनती है: AGENTS.md की उपस्थिति और वास्तविक-सामग्री, CLAUDE.md हल होना, docs/ श्रेणियाँ, .agents/ कैटलॉग-बनाम-डिस्क मेल, .dwp/ और tmp/ gitignore स्थिति, और — एक योजना के लिए — कि हर कार्य स्वीकृति मानदंड और एक सत्यापन-गेट साथ रखता है।

एक रिपॉज़िटरी को ऑनबोर्डिंग के बाद और हर पूर्ण योजना के बाद फिर से सत्यापित करना SHOULD, ताकि अनुरूपता एक बार दावा करने के बजाय बनाए रखी जाए।