पहले नियोजन, फिर काम: एक वाक्य के विचार को आवश्यकताओं की सूची में बदलें
पहले उत्तर देते हैं: AI प्रोग्रामिंग में सबसे बड़ी बर्बादी गलत कोड लिखना नहीं, बल्कि गलत दिशा में लिखना है। «AI प्रोग्रामिंग आवश्यकता नियोजन» का काम यही है — AI के काम शुरू करने से पहले, आपके दिमाग़ की तस्वीर को ऐसी आवश्यकताओं की सूची में अनुवादित करना जिसका पालन करके वह भटके नहीं।
यह काम प्रोडक्ट मैनेजर का लगता है, पर वास्तव में शून्य आधार से भी केवल 10 मिनट लगते हैं। यही पाठ vibe coding प्रोजेक्ट नियोजन का सार है: एक चार-पंक्ति की सूची, एक AI इंटरव्यू, एक उतारी गई स्पेसिफिकेशन फ़ाइल, और एक बार पहले योजना की समीक्षा फिर काम। Claude Code, Codex, OpenCode, WorkBuddy सभी पर लागू होता है, और पहले तीन में «प्लान मोड» नाम का समर्पित स्विच बिल्ट-इन है।
पिछले पाठ की वर्कफ़्लो गाइड ने पाँच अनुशासन स्थापित किए, यह पाठ पहले अनुशासन का विस्तार है: पहले नियोजन, फिर काम — इससे बचाया जाने वाला गड्ढा है «AI दिशा का अनुमान गलत लगाता है, लिखने के बाद पता चलता है कि यही चाहते नहीं थे»।
सीखने के बाद आप क्या कर सकेंगे
- «लक्ष्य / संदर्भ / बाधाएँ / पूर्णता के मानदंड» चार-भाग फ्रेमवर्क से, एक वाक्य के विचार को AI के पालन करने योग्य आवश्यकताओं की सूची में विस्तारित करना
- AI से उल्टा आपका इंटरव्यू करवाना: एक प्रॉम्प्ट से «मैं भी स्पष्ट नहीं कह सकता» वाले हिस्सों को स्पष्ट स्पेसिफिकेशन में बदलवाना और उन्हें SPEC.md फ़ाइल में उतारना
- Claude Code, Codex, OpenCode में प्लान मोड खोलना, ताकि AI पहले योजना प्रस्तुत करे और आपकी स्वीकृति के बाद ही कोड पर काम करे
- हर सूची के लिए सत्यापन योग्य «पूर्णता के मानदंड» लिखना, ताकि AI के पास खुद की जाँच करने का तरीका हो
- इस अनुशासन की सीमा तय करना: बनाकर फेंक देने वाले सप्ताहांत के छोटे प्रोजेक्ट में इसे छोड़ा जा सकता है, लेकिन दीर्घकालिक रखरखाव वाले या दूसरों के उपयोग वाले प्रोजेक्ट में नहीं
आपकी वर्तमान दुविधा
- «मेरे लिए एक लेखा-हिसाब टूल बना दो» कहकर फेंक देते हैं, AI जो लौटाता है वह आपके विचार से पूरी तरह अलग होता है — तीसरे दौर तक संशोधन करते-करते आप दोनों एक ही जगह घूमते रहते हैं
- आप जानते हैं कि ज़रूरतों का दस्तावेज़ लिखना चाहिए, लेकिन यह नहीं पता कि कितनी विस्तार से लिखें: कम लिखें तो वह अंदाज़ा लगाता है, ज़्यादा लिखें तो कोड लिखने से भी ज़्यादा थकाऊ हो जाता है
- आपने 「प्लान मोड」 के बारे में सुना है, लेकिन यह सुनिश्चित नहीं है कि यह सीधे सवाल पूछने से कैसे अलग है और कब यह एक अतिरिक्त कदम लेने लायक है
इस तरकीब का इस्तेमाल कब करें
जब आपको यह चाहिए:
- किसी ऐसी चीज़ को बनाना जो लंबे समय तक इस्तेमाल होगी, जिसे दूसरे लोग इस्तेमाल करेंगे, या जिसे बदलना बहुत मुश्किल है (वेबसाइट, मिनी-प्रोग्राम, प्लगइन)
- एक अस्पष्ट विचार (「एक काउंटडाउन पेज बना दें?」) को काम शुरू करने लायक कार्य में बदलना
- किसी टूल से पहली बार असली प्रोजेक्ट चलाना और कम उलझन में अनुभव बनाना
और जब आप यह नहीं चाहते:
- 「मेरा यह मतलब नहीं था, दोबारा करो」 वाले चक्र में पूरी रात बर्बाद करना
- हर नई सेशन में AI का आपकी ज़रूरतें दोबारा अंदाज़ा लगाना
- कोड लिखने के बाद पता चलना कि सबसे ज़रूरी फ़ीचर बनाया ही नहीं गया
🎒 शुरू करने से पहले की तैयारी
- पढ़ लें वर्कफ़्लो गाइड: पाँच अनुशासन, और जान लें कि यह पेज पहले अनुशासन का विस्तार है
- कम से कम एक टूल इंस्टॉल करके इस्तेमाल कर चुके हों: Claude Code, Codex, OpenCode या WorkBuddy
- पास में एक असली एक-लाइन वाला विचार अभ्यास सामग्री के रूप में हो (「मेरे लिए एक काउंटडाउन वेबपेज बना दो」 — इस स्तर का ही काफ़ी है)
- 10 मिनट और एक गिलास पानी ☕
मुख्य विचार
AI अंदाज़ा क्यों गलत लगाता है? इसकी वजह इसकी मूर्खता नहीं, बल्कि सूचना का अंतर है। Claude Code की आधिकारिक बेस्ट प्रैक्टिस 「बनी चीज़ वह नहीं निकली जो आप चाहते थे」 को सेशन फ़ेल होने का पहला कारण बताती है: मॉडल के पास जो कमी है वह है 「कोड पढ़कर न मिलने वाली सूचना」 — आपके दिमाग़ की तस्वीर, आपकी मीटिंग में तय हुए नियम, आपके मन में 「पूर्ण」 का मापदंड। यह सूचना न दें तो वह सिर्फ़ अंदाज़ा लगा सकता है।
ज़रूरतों की सूची = AI तक न पहुँचने वाली सूचना की पूर्ति। यह औपचारिक प्रोडक्ट ज़रूरत दस्तावेज़ लिखना नहीं है, बल्कि एक लाइन में जो तीन चीज़ें छूटी हैं उन्हें जोड़ना है: दायरा (क्या करें, क्या न करें), सीमाएँ (किन नियमों से करें), पूर्णता का मापदंड (किस स्तर तक होने पर काम पूरा माना जाए)। यही AI प्रोजेक्ट तोड़ने का पहला कदम भी है — 「कुछ बनाओ」 को ऐसी मदों में तोड़ना जिनकी एक-एक करके पुष्टि हो सके।
Codex की आधिकारिक बेस्ट प्रैक्टिस एक ऐसा ढाँचा देती है जिसे सीधे अपनाया जा सकता है: एक अच्छी प्रॉम्प्ट में डिफ़ॉल्ट रूप से चार चीज़ें होती हैं।
| # | समस्या | क्या भरें | उदाहरण (काउंटडाउन वेबपेज) |
|---|---|---|---|
| 1 | लक्ष्य Goal | क्या बदलना है, क्या बनाना है | एक ऐसा काउंटडाउन वेबपेज जो लोकल खोलते ही चल जाए |
| 2 | संदर्भ Context | कौन सी फ़ाइलें, दस्तावेज़, एरर कार्य से जुड़े हैं | शून्य से शुरुआत, कोई मौजूदा कोड नहीं |
| 3 | बाध्यकारी शर्तें (Constraints) | किन मानकों, परंपराओं और सुरक्षा आवश्यकताओं का पालन करना है | एकल फ़ाइल, कोई नई लाइब्रेरी नहीं, चीनी भाषा इंटरफ़ेस |
| 4 | पूर्णता मानदंड (Done when) | क्या सच होने पर कार्य पूरा माना जाए | ब्राउज़र में खोलने पर मिनट दर्ज करके काउंटडाउन चले, 0 पर पहुँचने पर सूचना मिले |
यह केवल Codex का अपना कहावत नहीं है। Claude Code की आधिकारिक सिफ़ारिश भी वही तर्क है: फ़ाइल का नाम बताना, लक्षणों का वर्णन करना, और स्पष्ट करना कि «ठीक होना» कैसा दिखेगा — आमतौर पर इससे पुनर्कार्य का एक पूरा चक्र बच जाता है। WorkBuddy का टास्क-निर्माण दस्तावेज़ भी कार्य विवरण में «लक्ष्य, दायरा, बाध्यकारी शर्तें और अपेक्षित आउटपुट स्पष्ट करने» की सलाह देता है। चार टूल, एक ढाँचा।
प्लानिंग का टूल-स्तर पर भी क्रियान्वयन है: प्लान मोड। आवश्यकता सूची वह जानकारी है जो आप AI को देते हैं; योजना वह है कि AI काम कैसे करने का इरादा रखता है। प्लान मोड इन दोनों चरणों को अलग करता है — AI केवल फ़ाइलें पढ़ता है, शोध करता है, योजना देता है, आपके कोड में एक शब्द भी नहीं बदलता; आपकी स्वीकृति के बाद ही वह हाथ चलाता है। Claude Code और Codex दोनों में plan mode है, OpenCode में रीड-ओनली plan agent है।
यह अनुशासन एक वाक्य में याद रखें: सूची पूरी लिखने के बाद ही काम शुरू करें, योजना देखने के बाद ही डिस्क पर लिखें।
मेरे साथ करें
(अपनी तैयारी सूची के उस एक-वाक्य विचार को अभ्यास सामग्री के रूप में लें, चार चरण पूरे करें, और वह काम शुरू करने योग्य आवश्यकता सूची में बदल जाएगा।)
चरण 1: चार-भाग ढाँचे से एक-वाक्य विचार को आवश्यकता सूची में विस्तारित करें (AI प्रोग्रामिंग आवश्यकता प्लानिंग का कंकाल)
क्यों: एक-वाक्य विचार में दायरा, बाध्यकारी शर्तें और पूर्णता मानदंड नहीं होते, AI केवल अनुमान से उन्हें भरता है — अनुमान गलत हुआ तो पुनर्कार्य का एक पूरा चक्र। चार-भाग ढाँचा आधिकारिक दस्तावेज़ द्वारा दिया गया न्यूनतम पूरक प्रारूप है, चार पंक्तियाँ पर्याप्त हैं।
अपने विचार को मुख्य विचारधारा की उस तालिका में प्रत्येक पंक्ति के लिए एक-एक पंक्ति लिखें। जो कोठरी भरी न जा सके उसे पहले खाली छोड़ दें, चरण 2 में AI से पूछवाएँ।
आधिकारिक रूप से दिखाए गए अंतर की तुलना स्वयं देखें (Claude Code सर्वोत्तम प्रथाओं की तुलना तालिका):
| ❌ एक वाक्य | ✅ जानकारी भरने के बाद |
|---|---|
| «लॉगिन bug ठीक करो» | «उपयोगकर्ता बताते हैं कि सेशन टाइमआउट के बाद लॉगिन विफल होता है। src/auth/ में token रिफ़्रेश की जाँच करें, पहले समस्या को पुन:उत्पन्न करने वाला एक विफल टेस्ट लिखें, फिर उसे ठीक करें» |
| «एक कैलेंडर कंपोनेंट जोड़ो» | «HotDogWidget.php के पैटर्न के अनुसार एक कैलेंडर कंपोनेंट बनाएँ: महीना चुन सकें, साल बदल सकें। कोई नई लाइब्रेरी न जोड़ें» |
आपको यह दिखना चाहिए: चार पंक्तियों की एक सूची, हर पंक्ति एक प्रश्न का उत्तर देती है — क्या करना है, किससे संबंधित है, किन नियमों से, और क्या होने पर पूरा माना जाए।
- छोटी जाँच: मेरी सूची की «पूर्णता मानदंड» पंक्ति सत्यापन योग्य है (खुल सके / पास हो सके / दोबारा न दिखे), केवल «हो गया» नहीं
चरण 2: AI से आपका साक्षात्कार करवाएँ, जिन कोठरियों के उत्तर नहीं आते उन्हें पूछ-पूछकर भरवाएँ
क्यों: कुछ कोठरियाँ आप स्वयं भी नहीं भर सकते — आलस्य नहीं, सचमुच सोचा ही नहीं गया है। कोई उत्तर ज़बरदस्ती घुसाने से बेहतर है कि AI प्रश्न पूछे। यही Claude Code और Codex की आधिकारिक सर्वोत्तम प्रथाओं द्वारा सुझाया गया «साक्षात्कार (interview)» मोड है।
यह वाक्य अपने टूल को भेजें (कोई भी हो):
मैं <अपना एक-वाक्य का विचार> चाहता/चाहती हूँ, लेकिन अभी ठीक से सोच नहीं पाया/पाई हूँ। मेरा इंटरव्यू लो, जब तक तुम एक स्पेसिफिकेशन लिख सको, और फिर उसे SPEC.md में लिख दो।आधिकारिक तौर पर दिया गया वास्तविक उदाहरण (Claude Code की बेस्ट प्रैक्टिसेज़ से रेट लिमिटिंग का उदाहरण): तुम कहते हो 「मैं पब्लिक API पर रेट लिमिटिंग जोड़ना चाहता हूँ, अभी पूरी तरह नहीं सोचा」, तो AI बहुविकल्पीय प्रश्न लेकर वापस आता है — यूज़र के हिसाब से लिमिट लगाएँ या API key के हिसाब से? सीमा पार करने वाले रिक्वेस्ट का क्या करें? किन्हें इसमें न गिना जाए? तब तक पूछता रहता है जब तक जवाब मिलकर एक पूरा स्पेसिफिकेशन न बन जाए।
Codex का कहना और भी सीधा है: इसे कहो 「मेरी धारणाओं को चुनौती दो, कोड लिखने से पहले अस्पष्ट विचारों को ठोस बना दो」।
तुम्हें यह दिखना चाहिए: AI ने कोड लिखना शुरू नहीं किया, बल्कि बहुविकल्पीय प्रश्न वापस फेंके हैं। अगर वह सीधे कोड लिखना शुरू कर दे, तो ऊपर वाला प्रॉम्प्ट एक बार फिर भेजो।
- छोटी जाँच: AI के पूछे प्रश्नों में से कम से कम एक ऐसा है जिसे मैंने मूल रूप से सोचा नहीं था
चरण 3: स्पेसिफिकेशन को फ़ाइल में उतारो, नया सेशन खोलकर ही कोड छुओ
क्यों: स्पेसिफिकेशन सिर्फ़ चैट इतिहास में मौजूद है, अगली बार AI को फिर से अंदाज़ा लगाना पड़ेगा। इसे फ़ाइल में उतारने के दो आधिकारिक फ़ायदे बताए गए हैं: काम शुरू करने वाला सेशन 「साफ़ कॉन्टेक्स्ट + लिखित हुआ परिभाषित-पूर्णता (definition of done)」 से शुरू होता है; और यह फ़ाइल आगे स्वीकृति (acceptance) के समय तुलना का आधार भी बनती है — आधिकारिक बेस्ट प्रैक्टिस का तरीका यही है कि समीक्षा करने वाला सबएजेंट 「हर आवश्यकता SPEC.md से मिलाकर जाँचे कि लागू हुई या नहीं」।
इंटरव्यू समाप्त होने पर, पुष्टि करो कि AI द्वारा लिखा गया SPEC.md तुम्हारा मतलब नहीं बिगाड़ता (खासकर 「पूर्णता के मानक」 वाला हिस्सा), और फिर:
- मौजूदा सेशन बंद करो, एक नया खोलो
- नए सेशन का पहला वाक्य कहो: 「SPEC.md पढ़ो, स्पेसिफिकेशन के अनुसार लागू करो; पूर्णता के सारे मानक पूरे होने से पहले, 'हो गया' मत कहना」
Codex यूज़र्स का एडवांस तरीका: लंबे टास्क, मल्टी-स्टेप टास्क के लिए PLANS.md या एग्ज़ीक्यूशन-प्लान टेम्पलेट कॉन्फ़िगर किया जा सकता है, ताकि प्लान हमेशा एक ही फ़ॉर्मेट में आए।
तुम्हें यह दिखना चाहिए: प्रोजेक्ट फ़ोल्डर में एक SPEC.md जुड़ गया है; नए सेशन में AI पहले फ़ाइल पढ़ता है फिर हाथ चलाता है, दोहरे प्रश्न नहीं पूछता।
- छोटी जाँच: SPEC.md के पूर्णता मानक, मैं हर एक को समझ सकता/सकती हूँ और पहचान सकता/सकती हूँ कि 「हो गया」 कैसा दिखता है
चरण 4: प्लान मोड खोलो, पहले तरीके की समीक्षा करो, फिर उसे हाथ लगाने दो
क्यों: आवश्यकताओं की सूची तय करती है 「क्या करना है」, तरीका तय करता है 「कैसे करना है」。प्लान मोड में AI सिर्फ़ फ़ाइलें पढ़ता है, रिसर्च करता है, तरीका लिखता है, कोई कोड नहीं बदलता — तुम्हारी मंज़ूरी के बाद ही हाथ चलाता है। यह तीनों कमांड-लाइन टूल्स में बिल्ट-इन फ़ीचर है, बस कीज़ अलग-अलग हैं:
| टूल | कैसे चालू करें | चालू होने पर |
|---|---|---|
| Claude Code | सेशन के दौरान Shift+Tab दबाकर स्टेटस बार पर ⏸ plan mode on दिखाने तक स्विच करें; किसी एक मैसेज में /plan प्रीफ़िक्स जोड़ें; या शुरू करते समय claude --permission-mode plan | सिर्फ़ फ़ाइलें पढ़ता है, एक्सप्लोरेशन कमांड चलाता है, तरीका लिखता है, तुम्हारा सोर्स कोड नहीं बदलता |
| Codex | /plan या Shift+Tab | कॉन्टेक्स्ट इकट्ठा करता है, तुमसे स्पष्टीकरण के प्रश्न पूछता है, पहले ज़्यादा मज़बूत तरीका बनाकर फिर लागू करता है |
| OpenCode | Tab दबाकर बिल्ट-इन agent के बीच plan पर स्विच करें | रीड-ओनली agent: डिफ़ॉल्ट रूप से फ़ाइल संपादन से इनकार करता है, bash कमांड चलाने से पहले अनुमति मांगता है |
जब योजना आ जाए (उदाहरण के लिए Claude Code), तो यह आपसे तीन में से एक चुनने को कहेगा:
- Yes, and use auto mode: मंज़ूरी दें, auto मोड पर स्विच करके काम शुरू करें
- Yes, manually approve edits: मंज़ूरी दें, लेकिन हर संपादन आपकी नज़र से गुज़रेगा
- No, keep planning: संतुष्ट नहीं, प्लानिंग मोड में रहकर और सुधारें
शक हो तो तीसरा चुनें — योजना चरण में मत बदलने का खर्च सिर्फ़ कुछ वाक्य हैं; कोड लिख जाने के बाद मत बदलने का खर्च एक पुनर्कार्य (rework) का दौर है। Claude Code में Ctrl+G भी दबा सकते हैं, टेक्स्ट एडिटर में उसकी योजना सीधे संपादित करके आगे बढ़ें।
💡 WorkBuddy उपयोगकर्ता
WorkBuddy की स्वायत्त प्लानिंग बिल्ट-इन है: आधिकारिक दस्तावेज़ कहते हैं कि यह "कार्य के लक्ष्य के अनुसार चरणों को स्वतः तोड़ता है, निष्पादन प्रक्रिया की योजना बनाता है और कार्य पूरा करता है"। आपको बस चरण 1 और 2 की सूची को कार्य विवरण में लिखना है — इसका कार्य-निर्माण दस्तावेज़ भी सुझाता है "लक्ष्य, दायरा, बाध्यताएँ और अपेक्षित आउटपुट स्पष्ट करें"।
आपको यह दिखना चाहिए: पहले एक योजना (कौन-सी फ़ाइलें छेड़ी जाएँगी, कितने चरण होंगे), आपके हामी भरने के बाद ही कोड बदलना शुरू होता है।
- छोटी जाँच: मैंने प्लानिंग मोड में योजना एक बार देखी है, बता सकता हूँ कि वह क्या करने वाली है
चेकपॉइंट ✅
- मैं चार चीज़ें कंठस्थ कह सकता हूँ: लक्ष्य, संदर्भ, बाध्यताएँ, पूर्णता के मानक — और हर एक किस गड़बड़ी से बचाता है
- मैंने "मुझसे साक्षात्कार लो" प्रॉम्प्ट इस्तेमाल किया है, AI से बहुविकल्पीय प्रश्नों के ज़रिए अस्पष्ट विचार को विनिर्देश में बदलवाया है
- मेरा विनिर्देश फ़ाइल (SPEC.md) में उतरा है, नया सत्र फ़ाइल पढ़ने से शुरू होता है
- मैं जानता हूँ कि अपने टूल में प्लानिंग मोड कैसे खोलें, "पहले योजना, फिर कोड" का क्रम देखा है
- मैं इस अनुशासन की सीमा जानता हूँ: बनाकर फेंक देने वाले वीकेंड मिनी-प्रोजेक्ट में इसे छोड़ा जा सकता है, लंबे समय रखरखाव वाले में नहीं
गड़बड़ी से बचने की चेतावनी
❌ "पूर्णता का मानक" को "अच्छा हो गया" लिखना
"अच्छा हो गया", "चलने लायक हो गया" की जाँच नहीं हो सकती, AI खुद ही अनुमान लगाएगा। आधिकारिक सर्वोत्तम प्रथाएँ सीधे कहती हैं: चलने योग्य कोई जाँच न हो तो AI "दिखता है पूरा हुआ" पर रुक जाता है, गलतियाँ वहीं आपके पकड़ने का इंतज़ार करती हैं। सत्यापन योग्य लिखें: "ब्राउज़र खोलकर 25 मिनट इनपुट करें, काउंटडाउन पूरा होने पर सूचना पॉपअप हो"। Codex देता है तीन योग्य रूप: टेस्ट पास होना, व्यवहार बदल जाना, bug दोबारा दिखना बंद होना।
❌ साक्षात्कार के बाद फ़ाइल में न उतारकर उसी सत्र में सीधे काम शुरू करना
प्रश्नोत्तर संदर्भ को भर-भर देते हैं, फिर कोड लिखना स्वाभाविक लगता है — आधिकारिक सर्वोत्तम प्रथाएँ स्पष्ट रूप से उल्टा सुझाती हैं: विनिर्देश SPEC.md बनने के बाद एक नया सत्र खोलें और निर्माण करें, ताकि काम साफ़ संदर्भ और लिखित पूर्णता-परिभाषा से शुरू हो। पुराना सत्र चर्चा का रिकॉर्ड रखने के लिए रहने दें।
❌ "कुछ गड़बड़ मत करना" को बाध्यता बनाना
बाध्यताएँ इतनी ठोस हों कि पालन किया जा सके। "कोड साफ़ हो", "सुरक्षा का ध्यान रखें" कहना न कहने जैसा है; "नई लाइब्रेरी न जोड़ें", "एक ही फ़ाइल", "चीनी भाषा का इंटरफ़ेस" — यही वे बाध्यताएँ हैं जिनका AI पालन कर सकता है — आधिकारिक तुलना-तालिका के सकारात्मक वाक्य का अंत भी सख़्त "नई लाइब्रेरी न जोड़ें" ही है।
❌ वीकेंड के छोटे खिलौने के लिए भी पूरा तमाम चरण अपनाना
Karpathy ने मूल तरीके (diff न देखकर पूरी चीज़ स्वीकार करना) की सीमा तय की है: «एक बार का वीकएंड मिनी-प्रोजेक्ट»। इसे उल्टा पढ़ना भी मान्य है: बनाकर फेंक देने वाली चीज़ों के लिए चार-भाग का सेट एक लाइन में सिमटाकर सीधे शुरू किया जा सकता है; जो चीज़ें लंबे समय तक इस्तेमाल होंगी या दूसरों के लिए हैं, केवल वही इन 10 मिनट के लायक हैं। अनुशासन को बोझ न बनाएँ।
उन्नत तकनीकें (वैकल्पिक)
«पूर्णता का मानक» को AI द्वारा स्वतंत्र रूप से चलाए जा सकने वाली जाँच में अपग्रेड करें। आधिकारिक बेस्ट प्रैक्टिस की केंद्रीय सलाह: AI को एक ऐसी जाँच दें जो «चल सके और जिसका नतीजा पास या फेल हो», तो वह खुद «संशोधन—चलाना—आउटपुट पढ़ना—फिर ठीक करना» का चक्र पूरा कर लेगा, जब तक पास न हो जाए। इसे प्रॉम्प्ट में लिखना ही काफ़ी है: «बदलाव के बाद अमुक टेस्ट चलाओ, पास न हो तो ठीक करते रहो»। यही स्वीकृति जाँच की नींव है।
बड़े कार्य के लिए पाँच सवाल (अटेंड-मोड छोड़ने से पहले एक बार देख लें)। आधिकारिक दस्तावेज़ ने बिना निगरानी वाले कार्यों के लिए पाँच सवाल सूचीबद्ध किए हैं, जो असल में एक बड़ा ज़रूरतों की सूची है:
- क्या वह जानता है कि «पूर्ण» कैसा दिखता है? (लक्ष्य शर्त / स्पेक फ़ाइल / हरे होने वाले टेस्ट)
- क्या वह खुद की जाँच कर सकता है? (टेस्ट सूट / कोई समीक्षा चरण)
- उसे क्या छूने की अनुमति है? (अनुमति नियम / सैंडबॉक्स / निर्दिष्ट ब्रांच)
- क्या उसे रोक सकता है? (राउंड की सीमा / बजट की सीमा)
- नतीजा कहाँ जाएगा, कौन साइन-ऑफ़ करेगा?
पाँचवें सवाल की रक्षा-पंक्ति लागत और सुरक्षा में विस्तार से आती है।
पूरा वर्ज़न चाहिए, तो साफ़ कहें। आधिकारिक बेस्ट प्रैक्टिस ने देखा है: AI सतर्क समझ बनाने की ओर झुकता है — «शाब्दिक ज़रूरतों को पूरा करने वाली सबसे छोटी चीज़» बनाता है, क्योंकि वह नहीं देख सकता कि आप मन में कितना बड़ा अपेक्षित कर रहे हैं। पूरा वर्ज़न चाहिए (खाली स्थिति, एरर संदेश, सेव फ़्लो — सब शामिल), तो ज़रूरतों में साफ़ लिखें। दायरा केवल आप जानते हैं, और यही वह जानकारी है जो ज़रूरतों की सूची में होनी चाहिए।
प्लान मोड को डिफ़ॉल्ट बनाएँ। Claude Code प्रोजेक्ट के .claude/settings.json में permissions.defaultMode को plan सेट करने का समर्थन करता है, जिससे इस प्रोजेक्ट के टर्मिनल सेशन प्लान मोड से ही शुरू होंगे।
इस पाठ का सारांश
✅ AI प्रोग्रामिंग की ज़रूरत-योजना की पूरी श्रृंखला आप पूरी कर चुके हैं: चार-भाग का विस्तार (लक्ष्य / संदर्भ / बाधाएँ / पूर्णता का मानक) → AI इंटरव्यू से अस्पष्ट बिंदु पूरे करना → स्पेक SPEC.md में सहेजना → नए सेशन से काम शुरू → प्लान मोड में पहले योजना की समीक्षा।
✅ आप जान गए कि AI के गलत अनुमान की जड़ जानकारी का अंतर है — वह कोड पढ़ सकता है, पर आपके दिमाग़ की तस्वीर नहीं; ज़रूरतों की सूची वही जानकारी पूरी करती है जो वह नहीं पा सकता।
✅ आपने टूल-पार प्लान मोड के स्विच में महारत पा ली: Claude Code (Shift+Tab / /plan / claude --permission-mode plan), Codex (/plan या Shift+Tab), OpenCode (Tab से plan agent पर स्विच); WorkBuddy की योजना सिस्टम में बनी हुई है, आपका काम सूची को कार्य विवरण में लिखना है।
✅ आपने इस अनुशासन की सीमा साफ़ कर ली: बनाकर फेंकने वाले वीकएंड मिनी-प्रोजेक्ट को छोड़ा जा सकता है; जो चीज़ें लंबे समय तक रखरखाव होंगी या दूसरों के इस्तेमाल की हैं, उनके लिए पहले योजना, फिर काम।
मुख्य अवधारणाओं की समीक्षा:
| अवधारणा | एक लाइन | कहाँ गहराई से |
|---|---|---|
| चार-भाग सेट | लक्ष्य / संदर्भ / बाधाएँ / पूर्णता का मानक | इस पृष्ठ का चरण 1 |
| इंटरव्यू मोड | «मुझे तब तक इंटरव्यू करो जब तक तुम स्पेक लिख सको» | इस पृष्ठ का चरण 2 |
| SPEC.md | डिस्क पर लिखी गई स्पेसिफिकेशन, शुरुआत और स्वीकृति दोनों में साझा | इस पेज का चरण 3 |
| प्लान मोड | केवल-पढ़ने योग्य रिसर्च + प्लान बनाना, मंज़ूरी के बाद ही हाथ बढ़ाना | इस पेज का चरण 4 |
| पूर्णता का मानक | सत्यापन योग्य "क्या होने पर काम पूरा माना जाए" | स्वीकृति जांच |
अगले पाठ की झलक
चेकलिस्ट तैयार है, अगला पाठ "चेकलिस्ट को ऐसे प्रॉम्प्ट में कैसे बदलें जिसे AI एक ही बार में सही लिखे" की समस्या सुलझाएगा: प्रॉम्प्ट लिखने का तरीका: AI से एक बार में सही लिखवाने का जादुई टेम्पलेट।
आप सीखेंगे:
- ज़रूरतों की चेकलिस्ट को एक अच्छे प्रॉम्प्ट में कैसे बदलें: फ़ाइल का नाम बताना, लक्षण बयान करना, "ठीक होने" का मानक स्पष्ट करना
- एक ही बार में सही लिखवाने की कोशिश कैसे करें, "तीसरे राउंड तक सुधारते रहने" वाला चक्कर कैसे कम करें
- अच्छे प्रॉम्प्ट का जो हिस्सा हमेशा वही रहता है, उसे प्रोजेक्ट मैनुअल (AGENTS.md / CLAUDE.md) में कैसे स्थायी करें, ताकि हर बार दोबारा लिखना न पड़े