टूल इंस्टॉल कर लिया, और कब कौन-सा इस्तेमाल करना है यह भी समझ लिया। अब जो सबसे ज़्यादा असर डालता है वह है 「AI से कैसे कहा जाए」। वही Claude Code होने पर भी, निर्देश देने के तरीके से आउटपुट की गुणवत्ता कई गुना बदल जाती है। इस अध्याय में हम AI के साथ काम की दो प्रमुख शैलियों को केंद्र में रखेंगे ― सहजता से बातचीत करते हुए बनाने वाली वाइब कोडिंग, और पहले स्पेसिफ़िकेशन तय करके सटीक रूप से बनवाने वाली स्पेक-ड्रिवन डेवलपमेंट ― और इनके ज़रिए「अच्छे से काम कहलवाने」की कला सीखेंगे। यही AI कोडिंग का सबसे अहम पेंच है।

इस अध्याय में आप क्या सीखेंगे

मूल मंत्र है「छोटी खोज के लिए vibe, बड़ी सटीकता के लिए spec」

दो शैलियाँ समझ आएँगी
वाइब कोडिंग और स्पेक-ड्रिवन डेवलपमेंट के फ़ायदे और नुकसान पकड़ में आएँगे।
मौके के हिसाब से चुन पाएँगे
जो बना रहे हैं उसके आकार और उद्देश्य के हिसाब से तय कर पाएँगे कि किससे काम कहलवाना है।
अच्छे निर्देश लिख पाएँगे
ठोस बनाना, संदर्भ, आउटपुट उदाहरण आदि ― असरदार प्रॉम्प्ट का ढाँचा हाथ लगेगा।

निर्देश की गुणवत्ता ही नतीजा तय करती है

AI कोडिंग में सबसे पहले जहाँ लोग अटकते हैं वह अक्सर「टूल का इस्तेमाल」नहीं, बल्कि 「कैसे कहा जाए」 होता है। AI आपके दिमाग को नहीं पढ़ सकता। एक अस्पष्ट-सी बात थमा देंगे तो AI कमी वाले हिस्सों को अपने-आप अनुमान लगाकर भर देगा, और ऐसा कोड लौटाएगा जो चलता तो दिखेगा पर आपके इरादे से हटकर होगा। इसके उलट, क्या-क्यों-कैसे बनाना है यह सटीक बता पाएँ, तो वह हैरान कर देने वाली सटीकता से पूरा कर देता है। 「निर्देश की गुणवत्ता」सीधे-सीधे「नतीजे की गुणवत्ता」बन जाती है ― यही इस पूरे अध्याय का केंद्रीय संदेश है। और इस कहने के तरीके की मोटे तौर पर दो शैलियाँ हैं।

वाइब कोडिंग ― बातचीत करते हुए बनाना

वाइब कोडिंग (vibe coding) का मतलब है, बारीक डिज़ाइन को पहले से पक्का किए बिना, AI के साथ बातचीत करते हुए आज़माइश से बनाते जाने वाली शैली। 「कुछ ऐसा-सा चाहिए」यह मोटे तौर पर बताते हैं, जो निकलकर आता है उसे देखकर 「थोड़ा और ऐसे」「यहाँ ठीक करो」कहकर संवाद जोड़ते जाते हैं, और माहौल (vibe) पर भरोसा करते हुए आकार देते जाते हैं। आसान, खोजी, और आइडिया को झटपट आकार दे देना ― यही इसका सबसे बड़ा आकर्षण है।

🎨 कल्पना कीजिए: नक्शा खींचे बिना, मिट्टी को गूँधते हुए आकार टटोलने जैसा एहसास। 「बनाते-बनाते सोचना」होता है, इसलिए दिमाग में जो आइडिया अभी पक्का नहीं हुआ है, उसे भी बस हाथ चलाकर परख सकते हैं।

किन मौकों पर यह जँचती है, और किन नुकसानों से सावधान रहना है ― दोनों साथ रखकर देखते हैं।

✅ किन मौकों पर जँचती है
  • छोटी चीज़ें: एकल स्क्रिप्ट, सरल टूल, एक स्क्रीन वाली ऐप।
  • प्रोटोटाइप/नमूना: आकार देखकर फ़ैसला करना हो। फेंक देने की शर्त पर किया गया प्रयोग।
  • सीखना/अभ्यास: नई तकनीक को छूकर उसका एहसास पकड़ना हो।
⚠ नुकसान
  • समग्र डिज़ाइन डगमगाता है: हर बातचीत के साथ दिशा हिलती है, एकरूपता खोने का ख़तरा।
  • आकार बढ़ने पर टूट जाता है: फ़ाइलें जितनी बढ़ें, AI और इंसान दोनों पूरे को समझ नहीं पाते।
  • अंदर का हिस्सा ब्लैक-बॉक्स बन जाता है: चलता है, पर क्यों चलता है यह समझा न पाने वाला कोड जमा होता जाता है।

💡 एक लाइन में: वाइब कोडिंग「तेज़ी से आज़माने」के लिए सबसे दमदार है, पर「बड़ा बढ़ाने/लंबे समय तक संभालने」के लिए नहीं जँचती। छोटा, इस्तेमाल-के-बाद-फेंक-देने वाला, खोजी ― इन तीन शब्दों को कसौटी मानें, तो गड़बड़ी कम होगी।

स्पेक-ड्रिवन डेवलपमेंट ― पहले तय करके सटीक बनाना

स्पेक-ड्रिवन डेवलपमेंट (spec-driven development) वाइब कोडिंग के बिल्कुल उलट शैली है। कोड लिखना शुरू करने से पहले, 「क्या और कैसे बनाना है」को स्पेसिफ़िकेशन के रूप में दस्तावेज़ में समेट लिया जाता है, और उस स्पेसिफ़िकेशन को AI को देकर सटीक रूप से लागू करवाया जाता है। जो सामने आए उसी के हिसाब से हड़बड़ी में बातचीत करने के बजाय, सहमति वाले नक्शे के अनुसार AI को चलाना ― यही तरीका है।

तरीका सीधा है। पहले AI से सलाह-मशविरा करते हुए स्पेसिफ़िकेशन दस्तावेज़ बनाते हैं, उसे (अक्सर एक फ़ाइल के रूप में) प्रोजेक्ट में रखते हैं, और उसी स्पेसिफ़िकेशन का हवाला देते हुए काम को आगे बढ़ाते हैं।

STEP 1
स्पेसिफ़िकेशन लिखें

उद्देश्य, फ़ीचर, इनपुट-आउटपुट, बाधाओं को शब्दों में उतारें। AI से मसौदा बनवाकर फिर ठीक करना तेज़ रहता है।

STEP 2
सहमत हों

लागू करने से पहले स्पेसिफ़िकेशन को ख़ुद पढ़ें, चूक और विरोधाभास मिटाएँ। यहीं गुणवत्ता की रेखा खिंचती है।

STEP 3
स्पेसिफ़िकेशन के अनुसार बनवाएँ

「इस स्पेसिफ़िकेशन के अनुसार लागू करो」यह निर्देश दें। हटे तो स्पेसिफ़िकेशन पर लौटकर ठीक करें।

✅ किन मौकों पर जँचती है
  • थोड़ी बड़ी चीज़ें: कई फ़ीचर, कई फ़ाइलों में फैला विकास।
  • गुणवत्ता पर ज़ोर: बाद में टूटे तो मुसीबत हो, लंबे समय तक संभालनी हो।
  • टीम या दूसरे लोग पढ़ें: स्पेसिफ़िकेशन साझा आधार बन जाता है।
🧭 तरकीबें
  • शुरू से ही परिपूर्णता का लक्ष्य न रखें, स्पेसिफ़िकेशन भी छोटा शुरू करके बढ़ाएँ।
  • स्पेसिफ़िकेशन आप ज़रूर पढ़ें। AI के भरोसे छोड़ा स्पेसिफ़िकेशन छेदों से भरा रहता है।
  • लागू किया गया काम हटे तो बातचीत में तात्कालिक जुगाड़ न करें, पहले स्पेसिफ़िकेशन ठीक करके दोबारा करें

📐 यह क्यों असरदार है: AI सिर्फ़「अभी की यह बातचीत」ही देखता है। स्पेसिफ़िकेशन दस्तावेज़ जैसा जब चाहे लौटा जा सकने वाला मानक पहले रख देने से, बातचीत लंबी खिंचने पर भी दिशा नहीं डगमगाती, और लागू करने में चूक तथा दोबारा-काम घटता है। बात बस इतनी है कि「AI को नक्शा देकर फिर बनवाना」, पर असर ज़बरदस्त है।

कब कौन-सा ― छोटी खोज या बड़ी सटीकता

बात यह नहीं कि कौन-सा बेहतर है। जो बना रहे हैं उसके「आकार」और「उद्देश्य」के हिसाब से चुनना ही सही रास्ता है। दोनों शैलियों को अलग-अलग पहलुओं पर आमने-सामने रखकर देखते हैं।

🎨 वाइब कोडिंग
छोटा · खोज
आकारछोटा
उद्देश्यप्रोटोटाइप · खोज · सीखना
तरीकाबातचीत से आज़माइश
रफ़्तारबहुत तेज़
कमज़ोरीबड़ा होने पर टूटता है
📐 स्पेक-ड्रिवन डेवलपमेंट
बड़ा · सटीक
आकारमध्यम से बड़ा
उद्देश्यगुणवत्ता · रखरखाव · प्रोडक्शन
तरीकास्पेसिफ़िकेशन → लागू
रफ़्तारशुरुआत धीमी
कमज़ोरीछोटी चीज़ों के लिए भारी

✅ असल में तो「आना-जाना」होता है। दो में से एक पर टिके रहना ज़रूरी नहीं। पहले वाइब कोडिंग से फटाफट प्रोटोटाइप बनाएँ, और जब「बात बनेगी」का भरोसा हो जाए तो उसे स्पेसिफ़िकेशन में उतारकर असली लागूकरण की ओर बढ़ें ― यही प्रवाह असल काम में सबसे दमदार है। छोटी खोज vibe, बढ़ाने का चरण spec। एक ही प्रोजेक्ट के भीतर शैली बदलते चलें।

अच्छे निर्देश की 5 तरकीबें

चाहे कोई भी शैली हो, AI को दिया जाने वाला निर्देश (प्रॉम्प्ट) अच्छा हो तो नतीजा सुधरता है। आज से इस्तेमाल हो सकने वाली 5 बुनियादी तरकीबें कार्ड में पकड़ लें। गहराई में जाने के लिए प्रॉम्प्ट इंजीनियरिंग व्यावहारिक गाइड देखें।

① ठोस बनाएँ

「अच्छा-सा कर दो」के बजाय, क्या-कैसे चाहिए यह ठोस रूप में। संख्या, शर्त, विषय जितना साफ़ बताएँगे, सटीकता उतनी बढ़ेगी।

② संदर्भ दें

इस्तेमाल हो रही भाषा, फ़्रेमवर्क, संबंधित फ़ाइलें, बाधाएँ बताएँ। पृष्ठभूमि जितनी जानेगा, AI उतना सटीक होगा।

③ एक बार में एक काम

यह भी वह भी एक साथ न कहें। छोटा-छोटा बाँटकर एक-एक करके कहें, तो जाँच और सुधार दोनों आसान हो जाते हैं।

④ अपेक्षित आउटपुट दिखाएँ

जो रूप चाहिए (फ़ंक्शन नाम, रिटर्न वैल्यू, आउटपुट उदाहरण, फ़ॉर्मैट) पहले दिखा दें। लक्ष्य साझा कर लें तो हटने की गुंजाइश घटती है।

⑤ ठीक करते हुए दोहराएँ

एक ही बार में परिपूर्णता का लक्ष्य न रखें। आउटपुट देखकर 「यहाँ ऐसे」यह ठोस रूप से सुधार जोड़ते जाना ज़्यादा तेज़ है।

सिर्फ़ शब्दों से पकड़ में नहीं आता, इसलिए एक ही अनुरोध को「बुरा निर्देश」और「अच्छा निर्देश」के रूप में आमने-सामने रखते हैं।

❌ बुरा निर्देश

「लॉगिन फ़ीचर बना दो।」

भाषा भी, सेव कहाँ हो यह भी, सफलता-असफलता पर क्या हो यह भी अस्पष्ट। AI सब कुछ अनुमान से भर देगा, और आपकी सोच से न मिलने वाला कोड लौटाएगा। दोबारा-काम की जड़।

✅ अच्छा निर्देश

「Laravel के प्रोजेक्ट में, ईमेल और पासवर्ड से लॉगिन फ़ीचर जोड़ो। मौजूदा users टेबल का इस्तेमाल करो। प्रमाणीकरण सफल होने पर /dashboard पर भेजो, असफल होने पर एरर संदेश दिखाओ। पासवर्ड मौजूदा हैश तरीके के अनुरूप रखो। पहले सिर्फ़ routes और Controller का सुझाव दो, लागूकरण मेरी जाँच के बाद।」

उद्देश्य, संदर्भ, सफलता की शर्त, आउटपुट का दायरा, आगे बढ़ने का तरीका तक साफ़। पाँचों तरकीबें इसमें मौजूद हैं।

🧩 एक कदम आगे: AI को「क्या बताना है」भर नहीं, बल्कि पूरे प्रोजेक्ट में कौन-सी जानकारी कैसे पहुँचाई जाए यह डिज़ाइन करने की सोच को कॉन्टेक्स्ट इंजीनियरिंग, और AI जिस माहौल में काम करता है (टूल, अनुमतियाँ, निर्देश फ़ाइलें) उसे समूचा व्यवस्थित करने की सोच को हार्नेस इंजीनियरिंग कहते हैं। और आगे बढ़ना चाहें तो झाँककर देखिए।

जब AI नियमों को अनदेखा करे

Claude Code में हर प्रोजेक्ट के निर्देश CLAUDE.md जैसी फ़ाइल में समेटकर, AI से उन्हें हमेशा मनवाने की व्यवस्था होती है। पर असल में इस्तेमाल करने पर, 「जो नियम लिख रखे थे उन्हें AI अनदेखा कर देता है」 ऐसे मौके सामने आते हैं। इसके कई कारण होते हैं।

📄 निर्देश बहुत लंबे/बहुत ज़्यादा

नियम बेतहाशा हों तो अहम वाले दब जाते हैं। संख्या घटाएँ, प्राथमिकता साफ़ रखें

🌀 अस्पष्ट/विरोधाभासी

व्याख्या की गुंजाइश हो तो नियम नहीं मनते। ठोस और जाँचे जा सकने वाले तरीके से लिखें।

🗂 बातचीत लंबी हो गई

आदान-प्रदान लंबा खिंचे तो शुरुआती निर्देश धुंधले पड़ जाते हैं। अहम मोड़ों पर याद दिलाना कारगर है।

💡 उपाय का सार: नियम 「छोटे, ठोस, और प्राथमिकता के साथ」 लिखें। और अहम नियमों को, ज़रूरत के मौके पर बातचीत में एक बार फिर दोहराकर पक्का करें। कारणों की विस्तृत छानबीन और ठोस सुधार के तरीके AI CLAUDE.md के नियमों को क्यों अनदेखा करता है और उसका उपाय में समझाए गए हैं।

इस अध्याय का सार
  • निर्देश की गुणवत्ता ही नतीजे की गुणवत्ता। AI कमी वाले हिस्सों को अनुमान से भरता है, इसलिए जितना सटीक कह पाएँगे उतना सटीक लौटेगा।
  • वाइब कोडिंग = बातचीत करते हुए आज़माइश। छोटे, इस्तेमाल-के-बाद-फेंक, खोज में दमदार। बड़ा करने पर टूट जाता है।
  • स्पेक-ड्रिवन डेवलपमेंट = पहले स्पेसिफ़िकेशन तय करके सटीक लागू। मध्यम से बड़ा, गुणवत्ता पर ज़ोर में दमदार।
  • कब कौन-सा है 「छोटी खोज के लिए vibe, बड़ी सटीकता के लिए spec」। असल में आना-जाना होता है।
  • अच्छे निर्देश की तरकीबें ठोस बनाना, संदर्भ, एक बार में एक काम, आउटपुट उदाहरण, दोहराना ― ये पाँच।
  • AI नियमों को इसलिए अनदेखा करता है क्योंकि निर्देश लंबे, अस्पष्ट, बातचीत लंबी होती है। छोटा-ठोस लिखें, दोहराकर पक्का करें।

कहने का तरीका आ जाए तो AI कोडिंग एकदम स्थिर हो जाती है। फिर भी असल में हाथ चलाएँगे तो एरर और अटकावों से ज़रूर सामना होगा। अगले अध्याय 5「अटकाव से निकलना」 में, आम एरर के कारण और उनसे निकलने के तरीके व्यवस्थित रूप से पकड़ें।