Claude 5 मॉडलों के लिए नए context engineering नियम

• Claude Opus 5 और Claude Fable 5 में Claude Code के system prompt को 80% से ज़्यादा कम करने पर भी coding evaluation में मापने योग्य performance drop नहीं दिखा
• पुराने मॉडलों के worst-case को रोकने वाले detailed rules system prompt, Skills, CLAUDE.md और user requests के बीच टकरा सकते हैं, इसलिए नए मॉडलों के लिए आसपास के context और अपनी judgement का उपयोग करने देना बेहतर है
• सभी निर्देश और tool examples पहले से देने के बजाय, expressive interfaces और ज़रूरत पड़ने पर जानकारी/टूल लोड करने वाली progressive disclosure अपनाई गई है
• CLAUDE.md में repository की pitfalls को संक्षेप में लिखने, लंबे निर्देशों को Skills में अलग करने, और spec, test suite, HTML mockup, code, rubric जैसे समृद्ध reference materials का उपयोग करने वाली संरचना की सिफारिश की गई है
• /doctor और claude doctor से Skills और CLAUDE.md का आकार समायोजित किया जा सकता है, और नए मॉडलों का context दोहराव और अत्यधिक पाबंदियों को घटाकर ज़रूरत पड़ने पर संबंधित जानकारी खोजने लायक बनाया जाना चाहिए

---

Prompt से आगे का context engineering

• जब Claude messages को process करता है, तो user prompt पूरे context का सिर्फ एक हिस्सा होता है; बाकी system prompt, Skills, CLAUDE.md, memory आदि से बनता है
• Context engineering कई requests पर समान रूप से लागू होता है, इसलिए इसे किसी individual prompt की तरह बहुत specific लिखना कठिन है, लेकिन यह Claude Code और internal agents के परिणामों पर बड़ा असर डालता है
• user request पहले से पता न होने की स्थिति में general prompts और instructions design करने पड़ते हैं, और Claude की capabilities बढ़ने के साथ सही approach भी बदलती है
• Claude Opus 5 और Claude Fable 5 में Claude Code system prompt का 80% से ज़्यादा हटाने पर भी coding evaluation में मापने योग्य performance drop नहीं था
• यह best practice claude doctor में शामिल की गई है, और Claude Code में /doctor से Skills और CLAUDE.md को उचित आकार में समायोजित किया जा सकता है

मॉडल को अत्यधिक constraints से मुक्त करना

• पहले Claude Code को system prompt के अलावा CLAUDE.md और Skills से भी बहुत ज़्यादा constraints मिलते थे
  • एक ही request में “उचित documentation छोड़ो” और “comments मत जोड़ो” जैसे निर्देश system prompt, Skills और user request के ज़रिए आपस में टकरा सकते हैं
  • Claude user intent समझ सकता है, फिर भी overlapping या conflicting instructions के कारण उसे action तय करने से पहले ज़्यादा सावधानी से सोचना पड़ता है
• पहले worst-case से बचने के लिए ये constraints ज़रूरी थे, लेकिन नए मॉडल कई constraints हटाकर आसपास के context और अपनी judgement का उपयोग कर सकते हैं
• Claude Code के पास उपलब्ध tools भी बढ़े हैं
  • पहले CLAUDE.md memory, information और instructions का मुख्य storage था
  • अब memory, artifacts और Skills के ज़रिए sessions के बीच context लाया और साझा किया जा सकता है

तयशुदा rules से बेहतर context-based judgement

• शुरुआती Claude Code में file deletion जैसे worst-case रोकने के लिए हमेशा उपयुक्त न होने वाले कड़े निर्देश डाले गए थे
• पुराने system prompt में code में default रूप से comments न लिखने, कई paragraphs वाले docstring या multi-line comments को मना करने, और user के कहे बिना plan/decision/analysis documents न बनाने की मांग थी
• ऐसे rules कुछ requests में अनुपयुक्त हो सकते हैं
  • user की अपनी documentation preference हो सकती है
  • complex code के कुछ हिस्सों में multi-line comments की ज़रूरत हो सकती है
• पुराने मॉडलों में safeguards न हों तो वे गलत comments अक्सर लिखते थे, इसलिए यह compromise ज़रूरी था; लेकिन नए मॉडल explicit rules के बिना भी ऐसे फैसले बेहतर संभालते हैं
• नया system prompt context-based instruction इस्तेमाल करता है: “ऐसा code लिखो जो आसपास के code जैसा पढ़े, और comment density, naming, तथा idioms को उसी के अनुरूप रखो”

examples से बेहतर expressive interfaces design करना

• पहले tool usage का मुख्य नियम Claude को usage examples देना था
• नए मॉडलों में examples खोज की सीमा को किसी खास क्षेत्र तक सीमित कर सकते हैं, इसलिए tool, script और file के interfaces व parameters की expressiveness को प्राथमिकता देनी चाहिए
• Todo tool में status को pending, in_progress, completed enum के रूप में define करने से usage स्वाभाविक रूप से संकेतित हो सकता है
• एक समय में सिर्फ एक item को in_progress रखना चाहिए जैसा निर्देश interface level पर requested behavior को स्पष्ट करता है

ज़रूरत के समय जानकारी खोलने वाली progressive disclosure

• जब Claude Code शुरू में coding पर केंद्रित था, तब code review और verification के तरीकों को system prompt में विस्तार से डाला जाता था
• यह जानकारी हमेशा ज़रूरी नहीं थी, लेकिन कुछ tasks में महत्वपूर्ण थी
• अब ज़रूरत पड़ने पर सही context लाने वाली progressive disclosure का उपयोग किया जा सकता है
  • verification और code review निर्देशों को अलग-अलग Skills में ले जाकर Claude Code उन्हें चुनिंदा रूप से call कर सकता है
  • कुछ tools lazy-loading के साथ आते हैं, और agent को इस्तेमाल से पहले ToolSearch से उनकी पूरी definition खोजनी पड़ती है
  • Task tool की तरह कई tools दिए जा सकते हैं, फिर भी ज़रूरत से पहले वे context पर जगह नहीं घेरते
• CLAUDE.md और Skill.md को हर संभव practice का केंद्रीय storage बनाने की ज़रूरत नहीं है
• इसके बजाय इन्हें ज़रूरत पड़ने पर खोले जाने वाले file tree के रूप में व्यवस्थित किया जा सकता है; इस approach पर हर task के लिए dynamic workflow harness में भी चर्चा की गई है

दोहराए गए निर्देशों को simple tool descriptions में समेटना

• पुराने Claude models में कभी-कभी एक ही instruction दोहरानी पड़ती थी, और वे context की शुरुआत की तुलना में अंत में दिए निर्देशों का बेहतर पालन भी करते थे
• इसी वजह से system prompt body और tool descriptions दोनों में वही tool usage instructions या examples डाले जाते थे
• नए मॉडलों में repeated examples हटाकर tool usage को सिर्फ tool descriptions में रखा जा सकता है

CLAUDE.md से automatic memory की ओर बदलाव

• पहले # shortcut से CLAUDE.md में जानकारी अपने-आप लिखी जाती थी और users को Claude की memory सीधे save करने के लिए प्रोत्साहित किया जाता था
• अब Claude task और user से जुड़ी जानकारी को अपने-आप memory में बदलता है

simple specs से आगे के समृद्ध reference materials

• plan mode में Claude Code ज़रूरत पड़ने पर दोबारा देखने के लिए Markdown plan files पर बहुत निर्भर करता था, और लंबे projects में codebase के अंदर specs भी store किए जाते थे
• नया Claude ज्यादा जटिल formats वाले reference materials संभाल सकता है
  • नई artifacts feature से बने HTML artifacts
  • दूसरी codebase से port किए जाने वाले functions जैसा code
  • detailed test suite के रूप में व्यक्त specs
• rubric एक और reference format है, जिससे Claude किसी खास domain की पसंद या quality criteria को आज़मा और validate कर सकता है
  • जैसे अच्छा API design किसे माना जाए, ऐसे criteria define किए जा सकते हैं
  • dynamic workflows के ज़रिए उस rubric का उपयोग करने वाला validation agent बनाया जा सकता है

context के हर component की भूमिका

• system prompt

  • यह product context से गहराई से जुड़ा होता है और Claude को बताता है कि वह किस product के अंदर कौन-सा काम कर रहा है
  • Claude Code users को इसे शायद ही कभी बदलना पड़े, लेकिन अगर आप अपना agent harness बना रहे हैं तो यही वह क्षेत्र है जिसमें बहुत समय देना होगा

• CLAUDE.md

  • इसे हल्का रखें, repository के उद्देश्य को संक्षेप में लिखें, और ज़्यादातर tokens codebase में मौजूद ध्यान देने लायक pitfalls लिखने में लगाएँ
  • अगर repository का नियम है कि सभी types सिर्फ एक single file में रहें, तो इसे दर्ज करना उपयोगी है
  • ऐसी स्पष्ट जानकारी से बचें जिसे Claude file system या repository देखकर खुद जान सकता है
  • अगर task verification के लिए कई unique instructions हैं, तो verification Skill बनाएँ और CLAUDE.md से उसे reference करें; यही progressive disclosure है

• Skills

  • इन्हें हल्के guides की तरह बनाएँ, ताकि Claude ज़रूरत पड़ने पर जानकारी खोज सके
  • जब तक कोई क्षेत्र बहुत critical न हो, अत्यधिक constraints से बचना चाहिए
  • लंबे Skills को कई files में बाँटकर progressive तरीके से लोड करना बेहतर है
  • ये personal, team या product-specific विचार, knowledge और best practices रखने के लिए सबसे उपयोगी हैं

• reference materials

  • @ से file mention करने पर Claude मौजूदा plan से जुड़ी detailed जानकारी देख सकता है
  • spec files, mockups और पूरा codebase भी reference material हो सकते हैं
  • code, Claude को अच्छी तरह ज्ञात भाषा में साफ और faithful instructions देता है, इसलिए आम तौर पर code format की files को प्राथमिकता देना बेहतर है
  • design descriptions या screenshots की तुलना में HTML design mockups आम तौर पर बेहतर परिणाम देते हैं

मौजूदा context को सरल बनाना

• system prompt, Skills और CLAUDE.md में अनावश्यक rules, repetition और information हटाकर context को सरल करना चाहिए
• claude doctor command इस simplification को अपने-आप support करता है
• advanced models के लिए prompting के तरीकों के बारे में Claude Fable field guide में और पढ़ा जा सकता है