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

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

AI-जनरेटेड कोड की क्वालिटी लगभग पूरी तरह इस पर निर्भर है कि आप क्या और कैसे मांगते हैं। यह गाइड उन पैटर्न को कवर करती है जो Claude Code से लगातार बेहतर नतीजे देते हैं।

काम स्कोपिंग से सिस्टम प्रॉम्प्ट तक, इटरेटिव रिफ़ाइनमेंट से रोल-विशिष्ट निर्देशों तक। व्यावहारिक तकनीकें जो अगले कोडिंग सेशन में लागू कर सकते हैं।

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

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

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

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

पांच मूल सिद्धांत

काम चाहे जो हो, नतीजे सुधारने वाले पैटर्न।

1

कदमों की बजाय परिणाम बताएं

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

Avoid

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

Better

कोलैप्सिबल साइडबार कंपोनेंट बनाओ जो प्रोजेक्ट नाम से सूचीबद्ध करे। ड्रैग-टू-रीऑर्डर सपोर्ट करे और डार्क थीम (bg-[#1a1a2e], border-[#2a2a40]) से मैच करे। कोलैप्स्ड स्टेट पेज रीलोड में बना रहे।

2

काम स्पष्ट स्कोप करें

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

Avoid

ऑथेंटिकेशन सिस्टम रिफ़ैक्टर करो।

Better

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

3

मायने रखने वाला कॉन्टेक्स्ट दो

Claude Code प्रोजेक्ट फ़ाइलें पढ़ सकता है, लेकिन दिमाग नहीं। कोई कन्वेंशन फ़ॉलो करते हैं, लाइब्रेरी पसंद करते हैं, या पैटर्न स्थापित है तो बताएं। रीवर्क बचता है।

Avoid

फ़ॉर्म वैलिडेशन जोड़ो।

Better

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

4

एक प्रॉम्प्ट एक काम

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

Avoid

यूज़र प्रोफ़ाइल पेज बनाओ, API एंडपॉइंट लिखो, टेस्ट जोड़ो, README अपडेट करो, और साथ में नेव बार भी ठीक करो।

Better

GET /api/user/profile एंडपॉइंट बनाओ। id, name, email, और plan फ़ील्ड रिटर्न करो। ऑथेंटिकेशन के लिए मौजूदा auth मिडलवेयर उपयोग करो।

5

दोबारा शुरू करने की बजाय इटरेट करें

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

Avoid

यह गलत है। शुरू से करो और कंपोनेंट अलग तरीके से बनाओ।

Better

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

सिस्टम प्रॉम्प्ट: बना रहने वाला कॉन्टेक्स्ट

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

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

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

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

You are a senior frontend developer. Focus on React components, CSS/Tailwind styling, accessibility (WCAG AA), and responsive design. Use the project's existing component library before creating new components. Prefer composition over inheritance. Write semantic HTML. Never modify backend files.

प्रभावी सिस्टम प्रॉम्प्ट लिखना

  • रोल और सीमाएं डिफ़ाइन करें। एजेंट किस पर ध्यान दे? क्या अनदेखा करे?
  • विशिष्ट टेक्नोलॉजी और वर्जन बताएं। 'React 19 with Server Components' 'modern React' से बेहतर।
  • प्रोजेक्ट कन्वेंशन रेफ़रेंस करें। 'Use Zustand for state' एजेंट को Redux या Context की तरफ़ जाने से रोकता है।
  • क्वालिटी अपेक्षाएं सेट करें। 'Write TypeScript with strict mode, no any types' शॉर्टकट रोकता है।
  • नकारात्मक बाधाएं शामिल करें। 'Never modify files in /api/' एजेंट को सीमा में रखता है।

CLAUDE.md: प्रोजेक्ट-लेवल कॉन्टेक्स्ट

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

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

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

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

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

वही निर्देश दोबारा लिखना बंद करें। जो काम करे उसे सेव करें और पुनः उपयोग करें।

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

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

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

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

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

Write unit tests for [file]. Use vitest. Cover the happy path, edge cases (empty input, null, invalid types), and error handling. Mock external dependencies. Aim for >90% branch coverage.

कोड रिव्यू

Review the changes in the current git diff. Check for: unused imports, missing error handling, type safety issues, potential race conditions, and naming inconsistencies. Suggest fixes for each issue found.

API एंडपॉइंट

Create a REST endpoint for [resource]. Include input validation with zod, proper error responses (400, 401, 404, 500), TypeScript types for request/response, and a JSDoc comment describing the endpoint. Follow the existing pattern in src/api/.

एडवांस्ड पैटर्न

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

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

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

क्रॉस-एजेंट रिव्यू

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

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

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

रेफ़रेंस इम्प्लीमेंटेशन

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

आम गलतियां

लगातार ख़राब नतीजे देने वाले पैटर्न।

इम्प्लीमेंटेशन ओवर-स्पेसिफ़ाई करना

एजेंट को ठीक बताना कौन से फ़ंक्शन लिखे, कौन से वेरिएबल नाम रखे, कौन से क्रम में करे। यह माइक्रोमैनेजमेंट बेहतर तरीका खोजने की एजेंट की क्षमता हटा देता है। नतीजा बताएं, प्रक्रिया नहीं।

स्कोप सीमाएं नहीं

एजेंट से बिना बाधाओं के 'कोडबेस सुधारो' कहना। सीमाओं बिना, एजेंट अनचाही फ़ाइलें रिफ़ैक्टर कर सकता है, दूसरे कोड पर निर्भर API बदल सकता है, या कम-प्राथमिकता सुधारों पर टोकन खर्च कर सकता है।

मौजूदा कोड अनदेखा करना

नहीं बताना कि कोई पैटर्न, यूटिलिटी, या कंपोनेंट प्रोजेक्ट में पहले से है। एजेंट नया बनाएगा। सिर्फ़ 'हमारे पास src/hooks/ में useAuth hook पहले से है' कहने से काफ़ी रीवर्क बचता है।

कंपाउंड मेगा-प्रॉम्प्ट

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

FAQ

कोडिंग प्रॉम्प्ट कितना लंबा होना चाहिए?+
अधिकतर प्रभावी कोडिंग प्रॉम्प्ट 2 से 5 वाक्य। परिणाम, स्कोप, और मुख्य बाधाएं बताने के लिए पर्याप्त लंबा। एजेंट विवरण में न खोए इतना छोटा। प्रॉम्प्ट पूरा पैराग्राफ़ हो तो सोचें कि कुछ कॉन्टेक्स्ट CLAUDE.md या सिस्टम प्रॉम्प्ट में होना चाहिए।
Opus vs Sonnet के लिए अलग प्रॉम्प्ट लिखूं?+
थोड़ा। Opus अस्पष्टता बेहतर संभालता है और कम कॉन्टेक्स्ट से इरादा समझ सकता है। Sonnet अधिक स्पष्ट निर्देश और स्पष्ट स्कोप सीमाओं से लाभान्वित होता है। दोनों मॉडल के लिए, अपेक्षित परिणाम में विशिष्टता नतीजे सुधारती है।
AgentsRoom प्रॉम्प्ट इंजीनियरिंग में कैसे मदद करता है?+
तीन तरीके: 14 एजेंट टाइप के लिए बिल्ट-इन रोल-विशिष्ट सिस्टम प्रॉम्प्ट, प्रभावी प्रॉम्प्ट सेव और पुनः उपयोग के लिए प्रॉम्प्ट लाइब्रेरी, और प्रोजेक्ट-लेवल कॉन्टेक्स्ट के लिए CLAUDE.md एडिटर। ये लेयर मतलब व्यक्तिगत मैसेज बनाने में कम समय क्योंकि बेसलाइन कॉन्टेक्स्ट पहले से अच्छा।
क्या टीम में प्रॉम्प्ट शेयर कर सकता हूं?+
हां। AgentsRoom प्रॉम्प्ट दो जगह स्टोर करता है: प्रोजेक्ट-लेवल प्रॉम्प्ट .agentsroom/prompts.json में (वर्जन-कंट्रोल्ड, git से शेयर) और पर्सनल प्रॉम्प्ट prompts-personal.json में (gitignored)। ग्लोबल प्रॉम्प्ट क्लाउड से सभी डिवाइस में सिंक।
सिस्टम प्रॉम्प्ट और CLAUDE.md में क्या अंतर है?+
CLAUDE.md प्रोजेक्ट कॉन्टेक्स्ट है जो हर एजेंट ऑटोमैटिक पढ़ता है: स्टैक, संरचना, कन्वेंशन। सिस्टम प्रॉम्प्ट एजेंट-विशिष्ट व्यवहार निर्देश: रोल, फ़ोकस एरिया, बाधाएं। दोनों पूरक हैं। CLAUDE.md कहता है 'यह प्रोजेक्ट Next.js 16 with Prisma उपयोग करता है।' सिस्टम प्रॉम्प्ट कहता है 'तुम API रूट पर केंद्रित बैकएंड डेवलपर हो।'

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

AgentsRoom बिल्ट-इन सिस्टम प्रॉम्प्ट, प्रॉम्प्ट लाइब्रेरी, और CLAUDE.md एडिटिंग देता है। प्रॉम्प्ट बनाने में कम समय, बिल्डिंग में ज़्यादा।

मुफ़्तmacOS के लिए डाउनलोड करें

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

किसी भी Claude प्लान के साथ संगत (Free, Pro, Max, Team, Enterprise)