AI कोडिंग एजेंट को प्रॉम्प्ट देने से पहले स्पेक लिखें

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

स्पेक काम का क्रम बदल देता है। कोड लिखे जाने से पहले आप सरल भाषा में तीन बातें लिखते हैं: यह चीज़ क्या करेगी, किसके लिए है, और वे पूरा-होने की जाँचें जो साबित करें कि यह काम करती है। यह कोई तकनीकी दस्तावेज़ नहीं है। यह उस नोट जैसा है जो आप किसी सक्षम सहायक के लिए छोड़ते हैं जो आपसे कभी मिला नहीं: इतना ब्योरा कि उसे ज़रूरी हिस्सों पर अंदाज़ा न लगाना पड़े।

यह एक सीधी वजह से काम करता है। एजेंट आपके अनुरोध के खाली हिस्से अपनी मान्यताओं से नहीं भरता, क्योंकि भरने को खाली हिस्से कम बचते हैं। और आपको अपनी असली ज़रूरत बाद में एजेंट का आउटपुट पढ़कर नहीं पता चलती, क्योंकि कुछ माँगने से पहले ही आप उसे लिख चुके होते हैं।

यह किसी एक टूल तक सीमित नहीं है। Claude Code, Codex, Copilot, Cursor और हर दूसरा कोडिंग एजेंट मूल रूप से एक ही तरह काम करते हैं: सरल भाषा में निर्देश अंदर, कोड और कमांड बाहर। स्पेक यह बदल देता है कि अंदर क्या जाता है, और इसी से बदल जाता है कि बाहर क्या आता है, चाहे आप किसी से भी बात कर रहे हों।

GitHub का Spec Kit एक ओपन-सोर्स टूलकिट है, जो GitHub की अपनी रिपॉज़िटरी में MIT लाइसेंस के तहत संभाला जाता है। इसे इसलिए बनाया गया है कि AI कोडिंग एजेंटों को एक-बार की बातचीत के बजाय संरचित प्रक्रियाएँ, दोबारा इस्तेमाल होने वाले टेम्पलेट और दर्ज नतीजे मिलें। यह अपने कमांड-लाइन टूल से इंस्टॉल होता है, और इसका अपना README इसे स्पेक-आधारित डेवलपमेंट, या किसी भी दूसरी संरचित प्रक्रिया से शुरुआत करने का टूलकिट बताता है जिसे आप एजेंट से करवाना चाहें।

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

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

यह किन एजेंटों से जुड़ता है, इस बारे में Spec Kit के अपने सेटअप दस्तावेज़ कई एजेंटों को उस इंटीग्रेशन कुंजी से नाम देते हैं जो आप इंस्टॉल के समय देते हैं, जिनमें Claude Code और GitHub Copilot शामिल हैं, और सीधे नामित एजेंटों से आगे और एजेंट जोड़ने के लिए अपने अलग दस्तावेज़ों की ओर इशारा करते हैं। किसी भी ख़ास एजेंट सूची को, इस सूची समेत, एक झलक भर मानें: यह मान लेने से पहले कि कोई टूल आज समर्थित है या नहीं, Spec Kit के मौजूदा दस्तावेज़ देख लें।

किसी ग़ैर-डेवलपर के लिए, जो एक छोटी-सी चीज़ बना रहा है, पूरा Spec Kit वर्कफ़्लो चलाना काम की ज़रूरत से ज़्यादा औपचारिकता हो सकती है। तीन हिस्सों वाला स्पेक अकेले ही, अपने किसी भी पसंदीदा एजेंट को पहले संदेश के रूप में टाइप किया जाए, ज़्यादातर असली काम खुद कर देता है, और इंस्टॉल कुछ नहीं करना पड़ता।

स्पेक चिपकाएँ, फिर एजेंट को कुछ भी लिखने से पहले आपसे स्पष्टीकरण वाले सवाल पूछने दें। एक सक्षम एजेंट कुछ अस्पष्ट होने पर पूछेगा, और स्पेक उसे पूछने के लिए कोई ठोस चीज़ देता है, ताकि वह चुपचाप अंदाज़ा लगाकर आत्मविश्वास से ग़लत चीज़ न बना दे।

आदत का यह सीधा रूप हर जगह चलता है। यही तीन हिस्सों वाला ब्रीफ़ Claude Code, Codex, Copilot, Cursor या किसी भी दूसरे कोडिंग एजेंट के साथ काम करता है, क्योंकि इसमें कुछ भी किसी एक टूल की ख़ास सुविधा पर निर्भर नहीं है। यह एक आदत है जो आप बना रहे हैं, कोई प्लगइन नहीं जो आप इंस्टॉल कर रहे हैं।

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

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

दोनों तरह से असली हुनर एक ही है: एक भी लाइन कोड लिखे जाने से पहले यह कहना कि वह क्या करता है, किसके लिए है, और आपको कैसे पता चलेगा कि वह पूरा हो गया। टूलकिट बस इसे लगातार एक ढंग से लिख देने का काम स्वचालित करता है, तब, जब यह आदत इतनी बार काम आने लगे कि उसे स्वचालित करना सार्थक हो।