Skip to content
← सभी स्पेक दस्तावेज़

DWP विनिर्देश

संस्करण 1.0. स्थिति: स्थिर। यह दस्तावेज़ Deep Work Plan (DWP) पद्धति का मानक विनिर्देश है। कीवर्ड MUST, MUST NOT, SHOULD, SHOULD NOT और MAY की व्याख्या RFC 2119 में वर्णित अनुसार की जानी है।

परिभाषा

एक Deep Work Plan एक संरचित, केवल-markdown आर्टिफ़ैक्ट है जो एक जटिल इंजीनियरिंग कार्य का वर्णन करता है, जिसे क्रमिक, समीक्षा योग्य काम की इकाइयों में विघटित किया गया है, और जिसे स्वायत्त रूप से काम करने वाले AI कोडिंग एजेंट्स द्वारा बनाने, निष्पादित करने और बनाए रखने के लिए डिज़ाइन किया गया है।

DWP स्पेक-ड्रिवन है: योजना ही विनिर्देश है, और एजेंट्स को सुधार करने के बजाय इसके स्पष्ट स्वीकृति मानदंडों और सत्यापन-गेटों के विरुद्ध निष्पादन करना MUST। विनिर्देश — न कि कोई चैट प्रतिलेख — सत्य का टिकाऊ स्रोत है, इसलिए काम सत्रों और एजेंट्स के पार सत्यापन योग्य और फिर से शुरू होने योग्य है। यह हार्नेस इंजीनियरिंग को पोर्टेबल बनाना भी है: वह कॉन्टेक्स्ट, कंट्रोल लूप, सुरक्षा-कवच और फिर से शुरू होने योग्य स्थिति जो एक एजेंट को भरोसेमंद बनाती है, रिपॉज़िटरी में ही सादे markdown के रूप में स्थापित की जाती है, इसलिए कोई भी अनुरूप एजेंट एक उपकरण-विशिष्ट फ़्रेमवर्क के बिना रिपॉज़िटरी को संचालित कर MAY।

योजना संरचना

एक योजना .dwp/plans/ के अंतर्गत PLAN_<slug>/ नाम की एक डायरेक्टरी MUST होनी चाहिए। डायरेक्टरी में निम्नलिखित MUST होना चाहिए:

  • README.md — योजना अवलोकन, लक्ष्य, कार्य-तालिका और स्थिति।
  • प्रति कार्य एक फ़ाइल, जिसका नाम <n>.task_<slug>.md है।
  • PROGRESS.md — निष्पादन का एक चालू लॉग।

कार्य-संरचना

हर कार्य फ़ाइल में ये नौ खंड क्रम में MUST होने चाहिए:

  1. Goal — एक अनुच्छेद का कथन कि कार्य क्या हासिल करता है।
  2. Context — पृष्ठभूमि, लिंक, और यह कार्य क्यों मौजूद है।
  3. Steps — करने के लिए क्रमबद्ध, ठोस क्रियाएँ।
  4. Acceptance criteria — उन शर्तों की एक चेकलिस्ट जो पूर्णता को परिभाषित करती हैं।
  5. Validation — सत्यापन के लिए चलाई जाने वाली कमांड्स या परीक्षण।
  6. Files — बनाई या संशोधित किए जाने की अपेक्षित पाथ।
  7. Dependencies — अन्य कार्य या बाहरी पूर्वापेक्षाएँ।
  8. Risks — क्या गलत हो सकता है, और शमन-उपाय।
  9. Completion & Log — एक स्थिति-चिह्न और कालानुक्रमिक टिप्पणियाँ।

निष्पादन लूप

DWP पाँच संक्रियाएँ परिभाषित करता है:

  • create — एक लक्ष्य से एक नई योजना तैयार करें।
  • execute — योजना को कार्य-दर-कार्य निष्पादित करें।
  • refine — एक मौजूदा योजना को संशोधित करें।
  • resume — एक बाधित योजना को फिर से शुरू करें।
  • status — बिना निष्पादन के योजना की स्थिति की रिपोर्ट दें।

आउटपुट कार्यस्थल

सभी DWP आर्टिफ़ैक्ट रिपॉज़िटरी रूट पर एक gitignored .dwp/ डायरेक्टरी के अंतर्गत MUST रहने चाहिए।

संस्करण-निर्धारण

यह विनिर्देश सिमैंटिक वर्शनिंग का अनुसरण करता है।