अध्याय 03
योजना और कार्य टेम्पलेट
एक Deep Work Plan markdown फ़ाइलों की एक डायरेक्टरी है। उस डायरेक्टरी का आकार — और उसके भीतर हर फ़ाइल का — ही एक योजना को मनुष्यों और एजेंट्स, दोनों के लिए समीक्षा योग्य बनाता है।
योजना संरचना
-
.dwp/ -
plans/ -
PLAN_<slug>/ -
README.mdलक्ष्य · कार्य तालिका · स्थिति -
PROGRESS.mdकेवल जोड़ने वाला निष्पादन लॉग -
1.task_<slug>.mdकार्य फ़ाइल (दस खंड) -
2.task_<slug>.md
एक योजना .dwp/plans/ के अंतर्गत PLAN_<slug>/ नाम की एक डायरेक्टरी है। इसमें शामिल है:
README.md— योजना का अवलोकन: लक्ष्य, स्रोत-सामग्री, कार्य-तालिका और स्थिति।- प्रति कार्य एक फ़ाइल, जिसका नाम
<n>.task_<slug>.mdहै। PROGRESS.md— निष्पादन का एक चालू लॉग।
कार्य फ़ाइल संरचना
हर कार्य फ़ाइल का नाम <n>.task_<slug>.md होता है और यह दस-खंड संरचना का अनुसरण करती है: Goal, Context, Touched Surface, Steps, Acceptance criteria, Validation, Files, Dependencies, Risks, और Completion & Log। ये खंड हमेशा उसी क्रम में आते हैं ताकि कोई भी पाठक जान सके कि कहाँ देखना है। हर कार्य कार्य करने से पहले योजना के लक्ष्य से फिर जुड़ता है, जो एक एजेंट को एक लंबे, बहु-घंटे क्षितिज पर भटकने से रोकता है।
Final Review
हर योजना ठीक एक अनिवार्य कार्य के साथ समाप्त होनी चाहिए: Final Review। यह योजना को तीन क्रमित चरणों में बंद करता है — सुरक्षा-जाँच में कुछ भी ढीला नहीं किया जाता:
- सुरक्षा-जाँच — योजना ने जो कुछ भी बदला उसका रहस्यों, इंजेक्शन जोखिमों और नई आक्रमण-सतह के लिए ऑडिट करें, और
docs/SECURITY.mdको अद्यतन रखें। सुरक्षा अंत में जोड़ी गई कोई अलग कार्यधारा नहीं है: हर योजना अपने स्वयं के परिवर्तनों को ऑडिट किया हुआ छोड़ती है, और एक गंभीर खोज पूर्णता को अवरुद्ध करती है। - अंतिम-स्थिति सत्यापन — रिपॉज़िटरी का पूर्ण सत्यापन अंतिम प्रासंगिक स्थिति पर, अंतिम सुधार के बाद, चलता है और उत्तीर्ण होता है।
- स्किल्स समाधान — हर कार्य ने अपने साक्ष्य के ताज़ा रहते अपनी स्वयं की स्किल्स-स्थिति दर्ज की; यह समीक्षा उस बहीखाते का मिलान करती है। Executive Report अनुरोध पर उपलब्ध रहता है।
README और PROGRESS परिपाटियाँ
योजना के README.md में एक शीर्षक (# Deep Work Plan: <name>), एक गद्य लक्ष्य-कथन, एक वैकल्पिक स्रोत-सामग्री खंड, एक कार्य-तालिका (संख्या, कार्य नाम, स्थिति चेकबॉक्स), और <n>/<total> tasks complete रूप में एक योजना-स्थिति पंक्ति होनी चाहिए।
PROGRESS.md एक केवल-जोड़ने योग्य निष्पादन लॉग है। हर प्रविष्टि एक ISO 8601 टाइमस्टैम्प, कार्य संख्या और नाम, क्या किया गया, और कोई विचलन या छोड़ने के कारण दर्ज करती है। क्योंकि यह केवल बढ़ता ही है, यह इस बात का एक भरोसेमंद इतिहास है कि योजना वास्तव में कैसे आगे बढ़ी।
शीर्षक और परस्पर-संदर्भ
सभी शीर्षक वाक्य-केस का उपयोग करते हैं, और दस्तावेज़ विपणन भाषा तथा विस्मयादिबोधक चिह्नों से बचते हैं। ये परिपाटियाँ योजनाओं को एजेंट्स के पार और समय के साथ संगत रखती हैं।