प्रॉम्प्ट इंजीनियरिंग

बेहतर प्रॉम्प्ट बेहतर कोड.

एआई-generated कोड की गुणवत्ता लगभग पूरी तरह से निर्भर करती है कि आप क्या पूछते हैं और आप इसके लिए कैसे पूछते हैं। यह गाइड उन पैटर्न को कवर करता है जो लगातार Claude Code के साथ बेहतर परिणाम उत्पन्न करते हैं।

कार्य स्कोपिंग से लेकर सिस्टम प्रॉम्प्ट तक, क्षणिक शोधन से लेकर भूमिका-विशिष्ट निर्देशों तक। प्रैक्टिकल तकनीक आप अपने अगले कोडिंग सत्र में आवेदन कर सकते हैं।

क्यों कोड के लिए प्रोम्प्ट इंजीनियरिंग मामले

जब आप किसी इंसानी डेवलपर से 'लॉगिन पेज बनाओ' कहते हैं, तो वह साफ़ करने वाले सवाल पूछता है: कौन-सा auth प्रोवाइडर? कौन-कौन से फ़ील्ड? क्या OAuth संभालना है? एरर मैसेज? लोडिंग स्टेट?

एआई कोडिंग एजेंट उन सभी सवालों का जवाब देने की कोशिश करेंगे। कभी कभी वे सही अनुमान लगाते हैं। अक्सर वे कुछ उचित लगता है लेकिन क्या आप चाहते थे? 'reasonable' और 'exactly right' के बीच की खाई को प्रॉम्प्ट इंजीनियरिंग पाटती है।

अच्छे प्रॉम्प्ट लंबे होने ज़रूरी नहीं हैं। उन्हें ज़रूरी बातों पर सटीक होना चाहिए और गैरज़रूरी बातों पर चुप रहना चाहिए। यही संतुलन इस गाइड का विषय है।

पांच प्रमुख सिद्धांत

पैटर्न जो कार्य की परवाह किए बिना परिणामों में सुधार करते हैं।

1

Outcomes, नहीं कदम के बारे में विशिष्ट होना

'एक React कंपोनेंट बनाओ, फिर स्टेट जोड़ो, फिर स्टाइल जोड़ो' कहने के बजाय अंतिम नतीजा बताएं: 'एक कोलैप्सिबल साइडबार बनाओ जो प्रोजेक्ट के नाम दिखाए, ड्रैग-टू-रीऑर्डर सपोर्ट करे और हमारी मौजूदा Tailwind थीम इस्तेमाल करे।' वहां तक कैसे पहुंचना है, यह एजेंट को तय करने दें।

Avoid

एक कंपोनेंट बनाओ। useState जोड़ो। एक टॉगल बटन जोड़ो। उसे Tailwind से स्टाइल करो।

Better

एक कोलैप्सिबल साइडबार कंपोनेंट बनाओ जो प्रोजेक्ट्स को नाम से सूचीबद्ध करे। उसे ड्रैग-टू-रीऑर्डर सपोर्ट करना चाहिए और हमारी डार्क थीम (bg-[#111318], border-[#262b38]) से मेल खाना चाहिए। कोलैप्स की गई स्थिति पेज रीलोड के बाद भी बनी रहनी चाहिए।

2

स्पष्ट रूप से काम करना

एजेंट जब वे सीमाओं को जानते हैं तो सबसे अच्छा काम करते हैं। निर्दिष्ट करें कि कौन से फ़ाइलों को स्पर्श करने के लिए (या बचने के लिए), कौन से पैटर्न का पालन करने के लिए, और क्या 'डोन' दिखता है। असीमित कार्य उन परिवर्तनों का कारण बनता है जो समीक्षा करना मुश्किल है।

Avoid

प्रमाणीकरण प्रणाली Refactor।

Better

src/api/auth/login.ts में लॉगिन हैंडलर को रीफ़ैक्टर करें ताकि पासवर्ड हैशिंग के लिए sha256 की जगह bcrypt इस्तेमाल हो। JWT लॉजिक या सेशन कुकी हैंडलिंग को न बदलें। tests/auth/ में संबंधित टेस्ट अपडेट करें।

3

संदर्भ दें कि मामले

Claude Code अपनी परियोजना फ़ाइलों को पढ़ सकता है, लेकिन यह आपके दिमाग को नहीं पढ़ सकता है। यदि आप एक सम्मेलन का पालन करते हैं, तो एक पुस्तकालय जिसे आप पसंद करते हैं, या आपके द्वारा पहले से ही स्थापित किया गया एक पैटर्न, ऐसा कहते हैं। यह फिर से काम करता है।

Avoid

फॉर्म सत्यापन जोड़ें।

Better

Zod का उपयोग करके साइनअप फॉर्म में फॉर्म सत्यापन जोड़ें (हम पहले से ही इसे src/forms/settings.ts में सेटिंग फॉर्म के लिए इस्तेमाल करते हैं)। प्रत्येक क्षेत्र के नीचे इनलाइन त्रुटि संदेश दिखाएं। लॉगिन फॉर्म के रूप में उसी त्रुटि स्टाइल का पालन करें।

4

प्रति प्रॉम्प्ट एक कार्य

कम्पाउंड प्रॉम्प्ट (API का निर्माण, टेस्ट लिखने, डॉक्स को अद्यतन करने और तैनात करने के लिए) एजेंट को एक बार में बहुत सारे लक्ष्य रखने के लिए मजबूर करता है। परिणामी, केंद्रित कार्यों में जटिल काम तोड़ो। प्रत्येक पिछले परिणाम पर बनाता है।

Avoid

उपयोगकर्ता प्रोफ़ाइल पृष्ठ का निर्माण करें, एपीआई समापन बिंदुओं को लिखें, परीक्षण जोड़ें, README को अद्यतन करें, और जब आप उस पर हों तो नेव बार को ठीक करें।

Better

GET/api/user/profile endpoint. रिटर्न आईडी, नाम, ईमेल और योजना फ़ील्ड। प्रमाणीकरण के लिए मौजूदा auth मिडलवेयर का उपयोग करें।

5

Iterate, पुनरारंभ न करें

अगर पहला नतीजा सही नहीं है, तो फिर से शुरू करने के बजाय प्रॉम्प्ट को निखारें। Claude पूरी बातचीत का कॉन्टेक्स्ट याद रखता है। बताएँ कि क्या गलत है, क्या बदलना है और क्या रखना है। सुधार करते जाना नए सिरे से बनाने से तेज़ है।

Avoid

यह गलत है। शुरू करें और अलग-अलग घटक का निर्माण करें।

Better

लेआउट अच्छा है लेकिन मोबाइल ब्रेकपॉइंट गलत है। 768px के नीचे, एक ग्रिड का उपयोग करने के बजाय कार्ड को लंबवत रूप से स्टैक करें। जैसा है, सब कुछ रखें।

सिस्टम प्रॉम्प्ट: कॉन्टेक्स्ट कि पेर्सिस्ट

सिस्टम प्रॉम्प्ट आपके कुछ भी कहने से पहले एजेंट का बुनियादी व्यवहार तय करते हैं। AI कोडिंग में ये सबसे कम इस्तेमाल होने वाला टूल हैं।

एक सिस्टम प्रॉम्प्ट एजेंट को बताता है कि यह क्या है, यह क्या ध्यान केंद्रित करना चाहिए, और इसे क्या बचना चाहिए। यह सत्र में हर संदेश पर लागू होता है। इसके बारे में एजेंट के नौकरी विवरण के रूप में सोचें।

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

उदाहरण: फ्रंटेंड एजेंट सिस्टम प्रॉम्प्ट

आप एक वरिष्ठ फ्रंटएंड डेवलपर हैं। प्रतिक्रिया घटकों, सीएसएस / टेलिविंड स्टाइलिंग, एक्सेसिबिलिटी (WCAG AA), और उत्तरदायी डिजाइन पर ध्यान केंद्रित करें। नए घटकों को बनाने से पहले परियोजना के मौजूदा घटक पुस्तकालय का उपयोग करें। विरासत पर संरचना को प्राथमिकता दें। semantic HTML लिखें। कभी बैकेंड फ़ाइलों को संशोधित नहीं किया जाता है।

लेखन प्रभावी प्रणाली प्रॉम्प्ट

  • ✓भूमिका और इसकी सीमाओं को परिभाषित करें। एजेंट किस पर ध्यान देना चाहिए? यह क्या है?
  • ✓विशिष्ट तकनीकों और संस्करणों में उल्लेख। 'React 19 सर्वर घटक के साथ' 'modern React' से बेहतर है।
  • ✓प्रोजेक्ट के कन्वेंशन का हवाला दें। 'स्टेट के लिए Zustand इस्तेमाल करो' एजेंट को बता देता है कि Redux या Context की तरफ़ न जाए।
  • ✓गुणवत्ता की उम्मीद निर्धारित करना। 'Write TypeScript with कड़े मोड, कोई भी प्रकार नहीं' शॉर्टकट को रोकता है।
  • ✓नकारात्मक बाधाओं को शामिल करें। '/api में फ़ाइलों को संशोधित करने में कभी भी' एजेंट को अपने लेन में रखता है।

CLAUDE.md: परियोजना स्तरीय संदर्भ

सबसे असरदार प्रॉम्प्ट चैट में टाइप नहीं होता। वह आपकी रिपॉज़िटरी में रहता है।

CLAUDE.md आपकी परियोजना की जड़ पर एक मार्कडाउन फ़ाइल है जिसे Claude Code स्वचालित रूप से पढ़ता है। इसमें परियोजना संरचना, सम्मेलन, ढेर विवरण और दिशानिर्देश शामिल हैं जो परियोजना में प्रत्येक एजेंट सत्र पर लागू होते हैं।

दोहराने के बजाय 'हम हर बातचीत में Tailwind CSS 4, Prisma ORM और Next.js 16' का उपयोग करते हैं, इसे एक बार CLAUDE.md में लिखते हैं। प्रत्येक एजेंट इस संदर्भ को प्राप्त करता है। AgentsRoom में CLAUDE.md के लिए एक अंतर्निहित संपादक शामिल है ताकि आप इसे ऐप छोड़ने के बिना अपडेट कर सकें।

अच्छी तरह लिखी गई एक CLAUDE.md, ध्यान से बनाए गए दर्जनों अलग-अलग प्रॉम्प्ट से ज़्यादा कीमती है। इसका फ़ायदा जुड़ता जाता है: हर सत्र को इसका लाभ मिलता है।

प्रोम्प्ट लाइब्रेरी बनाएं

उसी निर्देश को फिर से लिखना बंद करें। क्या काम करता है और इसका पुन: उपयोग करता है.

अगर आप अलग-अलग प्रोजेक्ट में एक ही तरह का अनुरोध बार-बार टाइप करते हैं ('इस फ़ाइल के लिए यूनिट टेस्ट लिखो', 'इसे repository पैटर्न इस्तेमाल करने के लिए रिफैक्टर करो', 'सभी API routes में एरर हैंडलिंग जोड़ो'), तो उसे दोबारा इस्तेमाल होने वाले प्रॉम्प्ट के रूप में सहेज लें।

AgentsRoom में दो स्तरों वाली प्रॉम्प्ट लाइब्रेरी है: प्रोजेक्ट-विशिष्ट कामों के लिए प्रति-प्रोजेक्ट प्रॉम्प्ट, और हर जगह इस्तेमाल होने वाले पैटर्न के लिए ग्लोबल प्रॉम्प्ट (क्लाउड से सिंक)।

लाइब्रेरी प्रॉम्प्ट के लिए अच्छे उम्मीदवार: कोड समीक्षा चेकलिस्ट, टेस्ट लेखन टेम्पलेट्स, माइग्रेशन स्क्रिप्ट, घटक मचान निर्देश, सुरक्षा लेखा परीक्षा चरण। कुछ भी आप एक मानक प्रक्रिया के रूप में एक टीम विकि में डाल दिया है।

प्रॉम्प्ट लाइब्रेरी के उदाहरण

यूनिट टेस्ट लिखें

[फ़ाइल] के लिए यूनिट परीक्षण लिखें। vitest का उपयोग करें। खुश पथ, किनारे के मामलों (खाली इनपुट, नल, अवैध प्रकार), और त्रुटि हैंडलिंग को कवर करें। Mock बाह्य निर्भरता > 90% शाखा कवरेज के लिए लक्ष्य।

कोड समीक्षा

वर्तमान git diff में परिवर्तन की समीक्षा करें। इसके लिए जाँच करें: अप्रयुक्त आयात, लापता त्रुटि हैंडलिंग, सुरक्षा मुद्दों, संभावित दौड़ की स्थिति, और असंगति का नाम देना। प्रत्येक मुद्दे के लिए निर्धारित सुझाव मिलता है।

एपीआई समापन बिंदु

[resource] के लिए एक REST समापन बिंदु बनाएं। zod, उचित त्रुटि प्रतिक्रियाओं (400, 401, 404, 500) के साथ इनपुट सत्यापन शामिल है, अनुरोध / प्रतिक्रिया के लिए टाइपस्क्रिप्ट प्रकार, और एक JSDoc टिप्पणी समापन बिंदु का वर्णन। src/api/ में मौजूदा पैटर्न का पालन करें।

उन्नत पैटर्न

जटिल कामों के लिए तकनीकें, जो एक अकेले प्रॉम्प्ट से आगे जाती हैं।

प्रॉम्प्ट चेनिंग

आदेशित चरणों में एक बड़ा कार्य तोड़ो। चरण एक के साथ पहला एजेंट शुरू करें, पूरा होने की प्रतीक्षा करें, फिर अगले एजेंट को चरण दो के साथ शुरू करें (चरण एक के आउटपुट को संदर्भित करें)। प्रत्येक चरण छोटा और अधिक केंद्रित है। उदाहरण: एजेंट 1 डेटाबेस स्कीमा को डिजाइन करता है, एजेंट 2 उस स्कीमा का उपयोग करके एपीआई लिखते हैं, एजेंट 3 एपीआई के खिलाफ परीक्षण लिखते हैं।

क्रॉस-एजेंट समीक्षा

एक एजेंट का काम पूरा होने के बाद उसके आउटपुट पर दूसरा एजेंट लगाएं। 'src/components/ में फ्रंटएंड एजेंट ने अभी जो बदलाव किए हैं, उनकी समीक्षा करो। एक्सेसिबिलिटी की समस्याएं और छूटे हुए एरर स्टेट जांचो।' अलग भूमिका वाला नया एजेंट वह पकड़ लेता है जो पहला एजेंट चूक गया था।

प्रगतिशील बाधाएं

पहले एक ढीले प्रॉम्प्ट से शुरू करें, ताकि दिखे कि एजेंट समस्या को कैसे देखता है। फिर अगले संदेशों में शर्तें जोड़ें: 'संरचना अच्छी है, लेकिन client components की जगह server components इस्तेमाल करो।' 'hook रखो, लेकिन useEffect हटाकर उसकी जगह React Query mutation इस्तेमाल करो।' हर दौर आपको मनचाहे समाधान के और करीब ले जाता है।

संदर्भ कार्यान्वयन

मौजूदा कोड में एजेंट को इंगित करें: 'src/pages/profile.tsx के समान पैटर्न के बाद एक सेटिंग पृष्ठ का निर्माण करें। समान लेआउट संरचना, समान फॉर्म हैंडलिंग, समान त्रुटि प्रदर्शन। यह अक्सर शब्दों में पैटर्न का वर्णन करने से अधिक प्रभावी होता है।

आम गलतियाँ

पैटर्न जो लगातार खराब परिणाम उत्पन्न करते हैं।

ओवर-निर्दिष्ट कार्यान्वयन

एजेंट को वास्तव में बताते हुए जो लिखने के लिए कार्य करता है, जिसका नाम बदलता रहता है, और कौन सी चीजों को लागू करने का आदेश देता है। यह micromanagement बेहतर दृष्टिकोण खोजने के लिए एजेंट की क्षमता को हटा देता है। परिणाम का वर्णन करें, प्रक्रिया नहीं।

नो स्कोप सीमा

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

मौजूदा संहिता की पहचान करना

उल्लेख नहीं है कि परियोजना में पहले से ही एक पैटर्न, उपयोगिता या घटक मौजूद है। एजेंट एक नया बना देगा। एक साधारण 'हमने पहले से ही एक useAuth हुक src/हुक/' में महत्वपूर्ण फिर से काम को बचा लिया है।

मिश्रित मेगा प्रॉम्प्ट

पांच कार्यों को एक संदेश में परिक्रमा करना। एजेंट उन सभी का प्रयास करेगा, लेकिन गुणवत्ता में गिरावट आती है क्योंकि यह प्रतिस्पर्धा के लक्ष्यों को जगाता है। उन्हें इसके बजाय अनुक्रमिक, केंद्रित अनुरोध में विभाजित करें।

कब तक एक कोडिंग प्रॉम्प्ट होना चाहिए?
सबसे असरदार कोडिंग प्रॉम्प्ट 2 से 5 वाक्यों के होते हैं। इतने लंबे कि नतीजा, दायरा और मुख्य शर्तें साफ़ हों। इतने छोटे कि एजेंट ब्योरों में न खो जाए। अगर आपका प्रॉम्प्ट पूरा पैराग्राफ है, तो सोचें कि क्या उसका कुछ कॉन्टेक्स्ट CLAUDE.md या सिस्टम प्रॉम्प्ट में होना चाहिए।
क्या मुझे Opus और Sonnet के लिए प्रॉम्प्ट अलग तरह से लिखने चाहिए?
थोड़ा। ओपस अस्पष्टता को बेहतर ढंग से संभालता है और कम संदर्भ से इरादा को प्रभावित कर सकता है। अधिक स्पष्ट निर्देशों और स्पष्ट दायरे सीमाओं से Sonnet लाभ। दोनों मॉडलों के लिए, अपेक्षित परिणाम के बारे में विशिष्टता परिणाम में सुधार करती है।
कैसे AgentsRoom तत्काल इंजीनियरिंग के साथ मदद?
तीन तरीकों से: 14 एजेंट प्रकारों में से हर एक के लिए बिल्ट-इन भूमिका-विशिष्ट सिस्टम प्रॉम्प्ट, असरदार प्रॉम्प्ट सहेजने और दोबारा इस्तेमाल करने के लिए एक प्रॉम्प्ट लाइब्रेरी, और प्रोजेक्ट-स्तर के कॉन्टेक्स्ट के लिए एक CLAUDE.md एडिटर। इन परतों की वजह से आपको हर संदेश गढ़ने में कम समय लगता है, क्योंकि बुनियादी कॉन्टेक्स्ट पहले से अच्छा होता है।
क्या मैं एक टीम में प्रॉम्प्ट साझा कर सकता हूं?
हाँ। AgentsRoom आपके प्रॉम्प्ट आपके अकाउंट पर रखता है: हर प्रोजेक्ट के लिए एक लाइब्रेरी, और साथ में एक ग्लोबल लाइब्रेरी जो हर प्रोजेक्ट में उपलब्ध है, दोनों आपकी मशीनों और मोबाइल ऐप के बीच सिंक, ऑफ़लाइन काम के लिए लोकल कैश के साथ। व्यक्तिगत प्रॉम्प्ट सिर्फ़ आपको दिखते हैं, और रिपॉजिटरी में कुछ भी कमिट नहीं होता।
सिस्टम प्रॉम्प्ट और CLAUDE.md के बीच क्या अंतर है?
CLAUDE.md परियोजना संदर्भ है कि प्रत्येक एजेंट स्वचालित रूप से पढ़ता है: स्टैक, स्ट्रक्चर, कन्वेंशन। सिस्टम प्रॉम्प्ट एजेंट-विशिष्ट व्यवहार निर्देश हैं: भूमिका, फोकस क्षेत्र, बाधाएं। वे एक दूसरे के पूरक हैं। CLAUDE.md कहते हैं कि यह परियोजना Prisma के साथ Next.js 16 का उपयोग करती है। सिस्टम प्रॉम्प्ट कहता है कि आप एक बैकएंड डेवलपर हैं जो एपीआई मार्गों पर केंद्रित है।

और जानें

बेहतर प्रॉम्प्ट लिखें, बेहतर कोड डिलीवर करें

AgentsRoom आपको सिस्टम प्रॉम्प्ट्स, एक प्रॉम्प्ट लाइब्रेरी और CLAUDE.md संपादन देता है। कम समय की क्राफ्टिंग प्रॉम्प्ट, अधिक समय की इमारत।

डाउनलोडमुफ़्त

कंपेनियन ऐप: चलते-फिरते अपने एजेंट्स मॉनिटर करें

Claude, Codex, Antigravity CLI या किसी अन्य AI प्रदाता का उपयोग करें।

बग और अनुरोध सीधे अपने सार्वजनिक बैकलॉग में भेजें।