शीघ्र इंजीनियरिंग

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

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

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

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

जब आप एक मानव डेवलपर से लॉगइन पेज बनाने के लिए पूछते हैं, तो वे स्पष्ट प्रश्न पूछते हैं: कौन से auth प्रदाता? क्या क्षेत्र है? क्या यह OAuth को संभाल सकता है? त्रुटि संदेश? राज्य लोड हो रहा है?

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

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

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

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

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

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

Avoid

एक घटक बनाएँ। उपयोग स्टेट जोड़ें। एक टॉगल बटन जोड़ें। इसे टेलिविंड के साथ स्टाइल करें।.

Better

एक खुलने योग्य साइडबार घटक बनाएँ जो नाम से परियोजनाओं को सूचीबद्ध करता है। इसे ड्रैग-टू-रेऑर्डर का समर्थन करना चाहिए और हमारे अंधेरे विषय (bg-[#111318], सीमा-[#262b38]) से मेल खाना चाहिए। राज्य को पृष्ठ रीलोड में जारी रखना चाहिए।.

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

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

Avoid

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

Better

Refactor the log handler in src/api/auth/login.ts to use bcrypt बजाय sha256 for password hashing. JWT लॉजिक या सत्र कुकी हैंडलिंग को न बदलें। परीक्षण/औथ में संबंधित परीक्षणों को अद्यतन करें।.

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

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

Avoid

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

Better

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

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

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

Avoid

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

Better

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

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

यदि पहला परिणाम सही नहीं है, तो शुरू होने के बजाय संकेत को परिष्कृत करें। Claude पूर्ण बातचीत संदर्भ को बरकरार रखता है। क्या गलत है, क्या बदलना है और क्या रखना है? पुनरावृत्ति की तुलना में पुनरावृत्ति तेज है।.

Avoid

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

Better

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

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

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

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

AgentsRoom जहाजों के साथ 14 भूमिका-विशिष्ट प्रणाली संकेत: प्रत्येक एजेंट प्रकार के लिए एक। फ्रंटेंड एजेंट का संकेत इसे घटकों, अभिगम्यता और उत्तरदायी डिजाइन पर ध्यान केंद्रित करने के लिए कहता है। 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 के लिए एक अंतर्निहित संपादक शामिल है ताकि आप इसे ऐप छोड़ने के बिना अपडेट कर सकें।.

एक well-written CLAUDE.md ध्यान से तैयार व्यक्तिगत संकेतों के दर्जनों से अधिक के लायक है। यह यौगिक: हर सत्र में इसका लाभ होता है।.

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

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

यदि आप अपने आप को परियोजनाओं (इस फ़ाइल के लिए यूनिट टेस्ट लिखने) भर में अनुरोध के समान टाइपिंग पाते हैं, तो 'Repository पैटर्न का उपयोग करने के लिए इसे रिफैक्टर करें', 'सभी एपीआई मार्गों के लिए त्रुटि हैंडलिंग जोड़ें'), इसे एक पुन: प्रयोज्य संकेत के रूप में सहेजें।.

AgentsRoom में दो स्तरों के साथ एक शीघ्र पुस्तकालय सुविधा शामिल है: परियोजना-विशिष्ट कार्यों के लिए प्रति-परियोजना संकेत और वैश्विक संकेत (बंद-synced) उन पैटर्नों के लिए जो आप हर जगह उपयोग करते हैं।.

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

शीघ्र पुस्तकालय उदाहरण

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

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

कोड समीक्षा

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

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

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

उन्नत पैटर्न

जटिल कार्यों के लिए तकनीक जो एकल संकेत से परे जाती हैं।.

शीघ्र जंजीर

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

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

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

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

यह देखने के लिए कि एजेंट कैसे समस्या पर पहुंचता है, एक ढीले संकेत के साथ शुरू करें। फिर अनुवर्ती संदेशों में बाधाएं जोड़ें: 'अच्छी संरचना, लेकिन क्लाइंट घटकों के बजाय सर्वर घटकों का उपयोग करें।' 'हॉक को रखें, लेकिन इसके बजाय React Query mutation का उपयोग करें।' प्रत्येक पुनरावृत्ति उस समाधान की ओर संकुचित होती है जिसे आप चाहते हैं।.

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

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

आम गलतियाँ

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

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

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

नो स्कोप सीमा

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

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

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

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

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

सामान्य

कब तक एक कोडिंग प्रॉम्प्ट होना चाहिए?+

सबसे प्रभावी कोडिंग संकेत 2 से 5 वाक्य हैं। परिणाम, गुंजाइश और प्रमुख बाधाओं को निर्दिष्ट करने के लिए काफी लंबा। इस बात से काफी कम कि एजेंट विवरण में खो नहीं पाता है। यदि आपका प्रॉम्प्ट एक पूर्ण पैराग्राफ है, तो विचार करें कि उस संदर्भ में से कुछ CLAUDE.md या इसके बजाय सिस्टम प्रॉम्प्ट में है।.

क्या मैं ओपस बनाम सोनेट के लिए अलग-अलग तरीके से संकेत लिख सकता हूं?+

थोड़ा। ओपस अस्पष्टता को बेहतर ढंग से संभालता है और कम संदर्भ से इरादा को प्रभावित कर सकता है। अधिक स्पष्ट निर्देशों और स्पष्ट दायरे सीमाओं से Sonnet लाभ। दोनों मॉडलों के लिए, अपेक्षित परिणाम के बारे में विशिष्टता परिणाम में सुधार करती है।.

कैसे AgentsRoom तत्काल इंजीनियरिंग के साथ मदद?+

तीन तरीके: अंतर्निहित भूमिका-विशिष्ट प्रणाली प्रत्येक 14 एजेंट प्रकार के लिए प्रेरित करती है, प्रभावी संकेतों को बचाने और पुन: उपयोग करने के लिए एक त्वरित पुस्तकालय और परियोजना-स्तर संदर्भ के लिए CLAUDE.md संपादक। इन परतों का मतलब है कि आप व्यक्तिगत संदेशों को कम समय में शिल्प करते हैं क्योंकि बेसलाइन संदर्भ पहले से ही अच्छा है।.

क्या मैं एक टीम में प्रॉम्प्ट साझा कर सकता हूं?+

हां। AgentsRoom स्टोर दो स्थानों में संकेत देते हैं: प्रोजेक्ट-लेवल प्रॉम्प्ट्स इन .agentsroom/prompts.json (version-नियंत्रित, गिट के माध्यम से साझा) और व्यक्तिगत प्रॉम्प्ट्स इन प्रॉम्प्ट-personal.json (gitignored). वैश्विक संकेत आपके सभी उपकरणों में क्लाउड के माध्यम से सिंक करते हैं।.

सिस्टम प्रॉम्प्ट और CLAUDE.md के बीच क्या अंतर है?+

CLAUDE.md परियोजना संदर्भ है कि प्रत्येक एजेंट स्वचालित रूप से पढ़ता है: स्टैक, स्ट्रक्चर, कन्वेंशन। सिस्टम प्रॉम्प्ट एजेंट-विशिष्ट व्यवहार निर्देश हैं: भूमिका, फोकस क्षेत्र, बाधाएं। वे एक दूसरे के पूरक हैं। CLAUDE.md कहते हैं कि यह परियोजना Prisma के साथ Next.js 16 का उपयोग करती है। सिस्टम प्रॉम्प्ट कहता है कि आप एक बैकएंड डेवलपर हैं जो एपीआई मार्गों पर केंद्रित है।