Claude Code का /doctor prompt-audit एक ऐसा कमांड है जो Claude से आपकी इंस्ट्रक्शन फ़ाइलें (CLAUDE.md, AGENTS.md, स्किल, कमांड वगैरह) पढ़वाता है, उनमें पुराने पड़ चुके या आपस में टकराने वाले निर्देश खोजता है और उन्हें ठीक करने के सुझाव देता है। आपको सिर्फ़ एक रिपोर्ट और सुझाए गए diff मिलते हैं: जब तक आप Claude से कुछ लागू करने को न कहें, आपकी फ़ाइलों में एक अक्षर भी नहीं बदलता। /checkup prompt-audit टाइप करने पर भी ठीक यही ऑडिट चलता है।

यह लेख Claude Code के आधिकारिक दस्तावेज़ (How Claude remembers your project का "Audit your instruction files" सेक्शन, साथ में Commands और Skills), CHANGELOG और Claude Code के अंदर आने वाली ऑडिट गाइड के मूल पाठ के आधार पर बताता है कि प्रॉम्प्ट ऑडिट क्या जाँचता है, इसे कैसे चलाएँ और नतीजों का क्या करें। विशेषताओं से जुड़ी हर बात को 3 अक्टूबर 2026 को इन्हीं मूल स्रोतों से मिलाकर जाँचा गया है। सेक्शन 7 और 8 में यह भी है कि इस साइट की अपनी इंस्ट्रक्शन फ़ाइलों पर इसे चलाने पर क्या हुआ (9 सुझाव, जिनमें से 7 लागू किए) और कौन-सी सावधानियाँ सामने आईं।

संक्षेप में: /doctor prompt-audit एक नज़र में

स्रोत: Claude Code आधिकारिक दस्तावेज़ "How Claude remembers your project" और "Commands" (3 अक्टूबर 2026 को जाँचा गया)

क्या करता है

इंस्ट्रक्शन फ़ाइलों का ऑडिट

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

आउटपुट

रिपोर्ट और सुझाए गए diff

आपके कहे बिना कुछ नहीं बदलता। कौन-सा सुझाव लागू हो, यह आप एक-एक करके तय करते हैं।

दायरा

CLAUDE.md, स्किल और भी बहुत कुछ

AGENTS.md, rules, कमांड और सबएजेंट भी। सिर्फ़ एक जगह का ऑडिट करना हो तो पाथ दें।

वर्ज़न

v2.1.283 या उसके बाद

इसे सेशन के अंदर चलाएँ। यह टर्मिनल वाले claude doctor जैसा नहीं है।

1. /doctor prompt-audit क्या है? पुराने और टकराते निर्देशों का ऑडिट

Claude Code हर बार शुरू होने पर CLAUDE.md और बाकी इंस्ट्रक्शन फ़ाइलें लोड करता है। इस्तेमाल के साथ ये फ़ाइलें बढ़ती जाती हैं, और इनमें पुराने मॉडलों के लिए लिखी गई ज़रूरत से ज़्यादा सख़्त भाषा, अब मौजूद न रहीं फ़ाइलों और कमांड के नाम, और किसी दूसरी फ़ाइल से उलटे नियम जमा होते जाते हैं। /doctor prompt-audit वही कमांड है जो Claude से ठीक यही चीज़ें खोजवाता है।

आधिकारिक दस्तावेज़ का सार:

  • क्या खोजता है: पुराने मॉडलों के लिए लिखे गए निर्देश, मौजूद न रहीं फ़ाइलों या कमांड के हवाले, और एक-दूसरे से टकराती फ़ाइलें।
  • क्या लौटाता है: मिली समस्याओं की रिपोर्ट और diff के रूप में सुधार के सुझाव। जब तक आप Claude से उन्हें लागू करने को न कहें, आपकी फ़ाइलों में कुछ नहीं बदलता।
  • कैसे चलता है: Claude Code के साथ आने वाली /claude-api स्किल के ज़रिए। अगर आपने सेटिंग में यह स्किल बंद कर रखी है (skillOverrides से डिसेबल की है या disableBundledSkills चालू किया है), तो यह ऑडिट उपलब्ध नहीं होगा।
  • वर्ज़न: Claude Code v2.1.283 या उसके बाद। /checkup prompt-audit भी यही कमांड है।

CHANGELOG की v2.1.283 वाली एंट्री में /doctor prompt-audit (और /checkup prompt-audit) जोड़ा गया है, जो CLAUDE.md, स्किल, एजेंट और कमांड में पुराने मॉडलों के लिए लिखे गए प्रॉम्प्टिंग पैटर्न का ऑडिट करता है। उसी रिलीज़ में ऑडिट को इस तरह बदला गया कि पुराने पाथ, पुराने कमांड और टकराती इंस्ट्रक्शन फ़ाइलें रिपोर्ट में सबसे ऊपर आएँ, और "think" जैसे सोच की गहराई तय करने वाले कीवर्ड, जिन्हें Claude Code आधिकारिक तौर पर सपोर्ट करता है, बने रहें।

पुराने निर्देशों से फ़र्क़ क्यों पड़ता है? साथ आने वाली ऑडिट गाइड इसे यूँ समझाती है: आज के मॉडल पुराने मॉडलों की तुलना में निर्देशों का पालन ज़्यादा बारीकी से और ज़्यादा शब्दशः करते हैं। "CRITICAL" और "MUST" जैसा परत-दर-परत ज़ोर, जो इसलिए जोड़ा गया था कि पुराने मॉडल कोई नियम न चूकें, अब ज़रूरत से ज़्यादा भारी पड़ता है, जिससे नियम वहाँ भी लागू हो जाता है जहाँ उसकी ज़रूरत नहीं और मॉडल अड़ियल हो जाता है। गाइड साफ़ कहती है कि मक़सद निर्देशों को छोटा करना नहीं, बल्कि उन निर्देशों को खोजना है जो अब मौजूदा मॉडल, मौजूदा प्रोजेक्ट या आपके दूसरे निर्देशों से मेल नहीं खाते।

2. इस्तेमाल कैसे करें: बस टाइप करें, और पाथ देकर दायरा छोटा करें

Claude Code सेशन के अंदर बस इतना टाइप करें:

/doctor prompt-audit

बिना किसी आर्ग्युमेंट के, आधिकारिक दस्तावेज़ के मुताबिक़ यह इन फ़ाइलों का ऑडिट करता है:

प्रकारक्या शामिल है
इंस्ट्रक्शन फ़ाइलेंCLAUDE.md, CLAUDE.local.md, AGENTS.md
.claude/ और ~/.claude/ के अंदरrules, स्किल, कमांड, सबएजेंट, आउटपुट स्टाइल

सिर्फ़ एक फ़ाइल या फ़ोल्डर का ऑडिट करना हो तो पाथ दें। आधिकारिक दस्तावेज़ में दिया गया उदाहरण:

/doctor prompt-audit .claude/skills/deploy

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

गाइड यह भी कहती है कि ऑडिट Claude Code की सेटिंग फ़ाइलें (.claude/settings*.json) और MCP कॉन्फ़िगरेशन (.mcp.json) नहीं पढ़ता, क्योंकि उनमें सीक्रेट हो सकते हैं। परमिशन या hooks की समस्याएँ इस ऑडिट के दायरे से बाहर हैं; वह सादे /doctor का काम है (सेक्शन 6 देखें)।

3. ऑडिट किसे "पुराना" मानता है

ऑडिट क्या जाँचता है, यह Claude Code के साथ आने वाली गाइड (/claude-api स्किल के अंदर prompt-audit के निर्देश) में लिखा है। v2.1.286 के साथ आई फ़ाइलें पढ़ने पर जाँचें चार समूहों में बँटी मिलीं। इंस्ट्रक्शन फ़ाइलों के लिए ज़्यादातर काम पहले दो समूह करते हैं।

समूहमुख्य जाँचेंउदाहरण
1. प्रॉम्प्ट लिखने का पुराना तरीक़ाज़रूरत से ज़्यादा सख़्त भाषा, अब ग़ैरज़रूरी हो चुके सोचने के निर्देश, ज़रूरत से ज़्यादा तय किए गए क़दम, पुराने मॉडल की ख़ामियों के लिए किए गए जुगाड़ जो रह गएबार-बार "CRITICAL: you MUST...", "Think step by step", सोच-समझ माँगने वाले काम को "STEP 1... STEP 2..." में बाँधना
2. नाज़ुक कॉन्फ़िग फ़ाइलेंमौजूद न रहे पाथ और कमांड, एक-दूसरे से टकराती फ़ाइलें, फ़ाइल में लिखा घटनाओं का इतिहास, एक बार की चूक जो स्थायी नियम बन गई, तारीख़ से बँधी शर्तेंहटाई जा चुकी स्क्रिप्ट का नाम, दो फ़ाइलों में उलटे नियम, "क्योंकि [तारीख़] को यह फ़ेल हुआ था..."
3. टूल के विवरणAPI में टूल परिभाषित करते समय लिखे गए विवरण (बहुत छोटे विवरणों पर और ब्योरा जोड़ने का सुझाव आता है)एक लाइन के विवरण, विवरण के अंदर "यह टूल हमेशा इस्तेमाल करो"
4. API कॉल की सेटिंगऐसे पैरामीटर जो अब मौजूदा मॉडलों पर एरर देते हैं या डिप्रिकेटेड हैं, कैशिंग तोड़ने वाला क्रम, वगैरहसिर्फ़ तब जब ऐप्लिकेशन कोड हो (जिस प्रोजेक्ट में सिर्फ़ इंस्ट्रक्शन फ़ाइलें हों, उस पर लागू नहीं)

समूह 2 में "मौजूद न रहे पाथ और कमांड" को गाइड ख़ास सख़्ती से लेती है। यह जाँचता है कि इंस्ट्रक्शन फ़ाइलों में लिखा हर पाथ प्रोजेक्ट में सच में मौजूद है या नहीं, और कमांड व फ़्लैग आपकी स्क्रिप्ट या कॉन्फ़िग में परिभाषित हैं या नहीं, और यह सब कोई कमांड चलाए बिना, सिर्फ़ फ़ाइलें पढ़कर करता है। प्रोजेक्ट में असल में जो है, उससे जो भी उलटा निकले, वह high confidence वाला सुझाव बन जाता है।

जब दो फ़ाइलें टकराती हैं, तो ऑडिट git blame (किसने कौन-सी लाइन कब लिखी, इसका रिकॉर्ड) से तय करता है कि कौन-सी नई है, और पुरानी को उसके हिसाब से ठीक करने का सुझाव देता है। लेकिन अगर एक पक्ष कोई पाबंदी या सुरक्षा नियम है जिसे सुधार ढीला कर देगा, या इतिहास से पता न चले कि कौन-सी नई है, तो गाइड कहती है कि कोई सुधार न सुझाया जाए और उसे बस यूज़र के फ़ैसले के लिए रिपोर्ट किया जाए।

4. यह क्या नहीं हटाता: यह "छोटा करो" वाला ऑडिट नहीं है

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

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

यह उलटी दिशा में भी काम करता है। अगर मौजूदा मॉडलों को कोई नया निर्देश जोड़ने से फ़ायदा हो, तो यह उसका सुझाव भी देता है। और यह कहता है कि जब कुछ न मिले, तो कुछ भी न बदलना ही सही नतीजा है।

5. नतीजे कैसे पढ़ें: रिपोर्ट और सुझाए गए diff

आपको दो चीज़ें मिलती हैं: ऑडिट रिपोर्ट और diff के रूप में सुधार के सुझाव। रिपोर्ट के हर सुझाव में छह फ़ील्ड होते हैं:

फ़ील्डसामग्री
जगहफ़ाइल का नाम और लाइन नंबर
सबूतसमस्या वाला पाठ, शब्दशः उद्धृत
पैटर्नसेक्शन 3 के किस पैटर्न से मेल खाता है
पुराना क्यों हैकिससे टकराता है: मौजूदा मॉडल का व्यवहार, या प्रोजेक्ट में असल में मौजूद कोई चीज़
ConfidenceHigh (आधिकारिक दस्तावेज़ या प्रोजेक्ट से ही उलटा), medium (बड़े पैमाने पर देखा गया व्यवहार), low (भाषा से अनुमान)
कार्रवाईहटाना, दोबारा लिखना (नए पाठ के साथ), ले जाना (मंज़िल के साथ), जोड़ना, या सिर्फ़ ध्यान दिलाना

सुझाए गए diff में सिर्फ़ high और medium confidence वाले सुझाव आते हैं। Low confidence वाले सुझाव सिर्फ़ रिपोर्ट में दिखते हैं। Diff हर सुझाव के लिए अलग hunk में बँटे होते हैं, इसलिए आप सिर्फ़ वही चुन सकते हैं जो आपको चाहिए।

लागू करने के लिए Claude से कुछ ऐसा कहें: "1, 3 और 4 लागू करो"। गाइड यह भी कहती है कि फ़ाइलों के बीच के टकराव और प्रोजेक्ट से मेल न खाने वाले पाठ को दोबारा लिखने के सुझाव "सब साफ़ कर दो" जैसे एकमुश्त अनुरोध पर लागू नहीं होते। रिपॉज़िटरी में लिखने की अनुमति वाला कोई भी व्यक्ति नया पाठ या ख़ुद प्रोजेक्ट बदल सकता था, इसलिए डिज़ाइन यह मानकर चलता है कि हर एक को कोई इंसान जाँचे।

6. /doctor, /claude-api prompt-audit और claude doctor से अंतर

मिलते-जुलते नाम वाली चार चीज़ें हैं। आधिकारिक दस्तावेज़ (Commands और Skills) और CHANGELOG के आधार पर तुलना:

कमांडक्या करता हैफ़ाइलें बदलता है?वर्ज़न
/doctor prompt-auditइंस्ट्रक्शन फ़ाइलों (CLAUDE.md, स्किल वगैरह) में पुराने और टकराते निर्देशों का ऑडिटसिर्फ़ रिपोर्ट और सुझाव (कहने पर लागू करता है)v2.1.283 या उसके बाद
/doctor (उपनाम /checkup)आपके सेटअप की हेल्थ चेक (डुप्लिकेट इंस्टॉल, PATH, टूटी सेटिंग, इस्तेमाल न होने वाली स्किल और MCP सर्वर, धीमे hooks, उपलब्ध अपडेट), साथ में CLAUDE.md की वह सामग्री छाँटने के सुझाव जो कोड से पहले ही साफ़ है, और हमेशा लोड होने वाले निर्देशों को स्किल या नेस्टेड CLAUDE.md फ़ाइलों में ले जाने के सुझावपहले रिपोर्ट, आपकी पुष्टि के बाद सुधार(CLAUDE.md छाँटने के सुझाव: v2.1.206 या उसके बाद)
/claude-api prompt-auditClaude API पर बने ऐप के प्रॉम्प्ट और टूल विवरणों में पुराने मॉडलों के लिए लिखे पैटर्न का ऑडिटdiff सुझाता हैv2.1.221 या उसके बाद
claude doctor (टर्मिनल)सेशन शुरू किए बिना इंस्टॉलेशन की स्थिति दिखाता हैनहीं (सिर्फ़ पढ़ता है)—

उलझन की बात यह है कि /doctor भी CLAUDE.md से जुड़ा काम करता है। अंतर मक़सद का है। /doctor का लक्ष्य हमेशा लोड होने वाली चीज़ों को घटाना है (डुप्लिकेट हटाना, जो कोड पहले ही Claude को बता देता है उसे काटना, चीज़ों को ऐसी जगह ले जाना जहाँ वे ज़रूरत पड़ने पर ही लोड हों)। /doctor prompt-audit यह जाँचता है कि सामग्री पुरानी तो नहीं हो गई या ख़ुद से टकरा तो नहीं रही। टर्मिनल वाला claude doctor प्रॉम्प्ट ऑडिट नहीं चलाता।

अगर Claude आपके निर्देश इसलिए नहीं मान रहा कि वे लोड ही नहीं हो रहे, तो यह ऑडिट उसे ठीक नहीं करेगा। क्या लोड होता है, यह कैसे जाँचें, इसके लिए "AI आपके .md नियम क्यों नज़रअंदाज़ करता है" देखें, और इंस्ट्रक्शन फ़ाइलें आपके कॉन्टेक्स्ट का कितना हिस्सा लेती हैं, यह मापने के लिए "Claude Code का कॉन्टेक्स्ट आख़िर खा कौन रहा है?" देखें।

7. हमने आज़माया: इस साइट की CLAUDE.md और AGENTS.md का ऑडिट

3 अक्टूबर 2026 को हमने इस साइट के डेवलपमेंट में इस्तेमाल होने वाली इंस्ट्रक्शन फ़ाइलों पर /doctor prompt-audit चलाया। इसे Claude Code डेस्कटॉप ऐप में चलाया गया (बंडल किया गया Claude Code 2.1.286, मॉडल Opus 5.5)। हमारी इंस्ट्रक्शन फ़ाइलें हैं AGENTS.md (मुख्य नियम, जो Claude Code और Codex दोनों में साझा हैं) और CLAUDE.md (जो उसे इम्पोर्ट करती है और Claude Code से जुड़ी बातें जोड़ती है), दोनों मिलाकर लगभग 10,700 अक्षर। .claude/ के अंदर हम कोई rules, स्किल या कमांड नहीं रखते।

एक बार चलाने के नतीजे

स्रोत: हमारा अपना परीक्षण (3 अक्टूबर 2026, CLAUDE.md और AGENTS.md पर /doctor prompt-audit)

सुझाव

9

जाँचकर लागू किए

7

छोड़े (low confidence)

2

पहला आश्चर्य यह था कि पुराने मॉडलों के लिए लिखी गई प्रॉम्प्टिंग लगभग नहीं मिली। "think step by step" जैसा एक भी निर्देश नहीं था, न ही क़दम-दर-क़दम बाँधने वाली कोई स्क्रिप्ट। ज़्यादातर सुझाव सेक्शन 3 के समूह 2 (नाज़ुक कॉन्फ़िग फ़ाइलें) से आए।

Confidenceसंख्याक्या मिलाहमने क्या किया
High1उसी दिन हमने दो ऑडिट टूल जोड़े थे, लेकिन कोष्ठक में लिखी एक टिप्पणी अब भी "दोनों" कह रही थी और नए दो टूल के विवरण से मेल नहीं खाती थीलागू किया (टिप्पणी को दोबारा लिखकर जोड़े गए टूल को अलग-अलग कवर किया)
Medium5इंस्ट्रक्शन फ़ाइलों में तारीख़ और गिनती के साथ बचे घटनाओं के रिकॉर्ड (उसी फ़ाइल के एक नियम से उलटे: शुरुआती फ़ाइलों में घटनाओं के रिकॉर्ड जमा न करें)लागू किया (लेकिन हटाने के बजाय अलग रिकॉर्ड फ़ाइल में ले गए)
Medium1एक हेडिंग में बिना कारण बताए "(CRITICAL)"लागू किया (हटा दिया)
Low2लोकल में न चलने वाले कमांड की सूची, और तारीख़ वाली एक हेडिंगछोड़ दिया (दोनों किसी कारण से हैं, और गाइड भी low को "सिर्फ़ ध्यान दिलाना" मानती है)

High confidence वाला अकेला सुझाव सच्चा भटकाव था। ऑडिट टूल जोड़ते समय हमने उनके नाम सूची में तो जोड़ दिए, पर बगल की व्याख्या दोबारा लिखना भूल गए। हर बार फ़ाइल लोड होने पर Claude "दोनों" का मतलब ग़लत समझ सकता था, और आँख से देखते हुए यह हमसे छूट गया था।

रिपोर्ट में यह भी दर्ज था कि उसने इंस्ट्रक्शन फ़ाइलों में आए हर पाथ, टूल के नाम और हवाले वाले नोट के सच में मौजूद होने की पुष्टि की। उसने PHP का वर्ज़न (Docker कॉन्फ़िग से मेल) और एक प्रक्रिया के क़दमों की संख्या (दूसरी फ़ाइल की एक सूची से मेल) तक मिलाकर देखी।

हमने Claude के सुझाए diff को जस का तस स्वीकार नहीं किया; हर एक को मूल फ़ाइलों से मिलाकर जाँचने के बाद ही लागू किया। सबसे ज़्यादा सोच-विचार पाँच medium सुझावों पर करना पड़ा। सुझाव घटनाओं के रिकॉर्ड हटाने का था, लेकिन वही रिकॉर्ड वह सबूत हैं जो वही ग़लतियाँ दोबारा होने से रोकते हैं, इसलिए हमने उन्हें हटाने के बजाय दूसरी जगह ले जाना तय किया। जहाँ तारीख़ और गिनती पहले से किसी दूसरी फ़ाइल में थीं, वहाँ हमने उन्हें सिर्फ़ इंस्ट्रक्शन फ़ाइलों से हटाया; जो दो कहीं और दर्ज नहीं थे, उन्हें रिकॉर्ड फ़ाइल में कॉपी किया। आख़िर में इंस्ट्रक्शन फ़ाइलें लगभग 10,700 अक्षरों से सिर्फ़ लगभग 40 अक्षर छोटी हुईं। आकार लगभग वही रहा; बस टकराव ग़ायब हो गए।

ध्यान रखें कि यह एक प्रोजेक्ट पर एक बार चलाने का नतीजा है। ऑडिट मॉडल लिखता है, इसलिए उन्हीं फ़ाइलों पर दोबारा चलाने से सुझावों की संख्या या शब्द अलग हो सकते हैं। जिस प्रोजेक्ट में .claude/ के अंदर बहुत सारी स्किल और कमांड हों, उसे शायद काफ़ी अलग सुझाव मिलेंगे।

8. कमियाँ और सावधानियाँ

इस्तेमाल करने और आधिकारिक दस्तावेज़ व गाइड पढ़ने के बाद, ये पाँच बातें ध्यान में रखें:

  • यह आपकी यूसेज सीमा ख़र्च करता है: Claude सेशन के अंदर आपकी इंस्ट्रक्शन फ़ाइलें पढ़ता और ऑडिट करता है, इसलिए यह किसी भी दूसरे काम की तरह आपकी यूसेज में गिना जाता है। आधिकारिक दस्तावेज़ में किसी अलग क़ीमत का ज़िक्र नहीं है।
  • सुझाव आँख मूँदकर लागू न करें: हो सकता है Claude को पता न हो कि कोई नियम क्यों लिखा गया था। हमारे मामले में "घटनाओं के रिकॉर्ड हटाओ" वाला सुझाव जस का तस मान लेते, तो ग़लतियाँ दोहराने से रोकने वाला सबूत खो जाता।
  • हर बार नतीजे अलग हो सकते हैं: ऑडिट मॉडल लिखता है, इसलिए गिनती और शब्द हर बार बदल सकते हैं। एक बार साफ़ नतीजा आने को इस बात का सबूत न मानें कि फ़ाइल में कोई समस्या नहीं है।
  • यह सेटिंग फ़ाइलें नहीं देखता: यह settings.json या .mcp.json नहीं पढ़ता, इसलिए परमिशन, hooks और MCP की समस्याएँ नहीं दिखेंगी। उनके लिए /doctor इस्तेमाल करें।
  • यह आपकी सामग्री के सही होने की गारंटी नहीं देता: यह ग़ायब पाथ और टकराव पकड़ता है, लेकिन यह नहीं परखता कि आपकी नीति ख़ुद सही है या नहीं। वह फ़ैसला आपका है।

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

9. प्रॉम्प्ट ऑडिट कब चलाएँ

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

  • जब आप मॉडलों की नई पीढ़ी पर जाएँ: पुराने मॉडलों से बची सख़्त भाषा और जुगाड़ जाँचने के लिए
  • इंस्ट्रक्शन फ़ाइलों को बड़े पैमाने पर दोबारा लिखने के बाद: जैसा हमारे परीक्षण में हुआ, नए नियम और पुरानी व्याख्याएँ अक्सर एक-दूसरे से भटक जाती हैं
  • जब आप Claude Code और Codex जैसे टूल के बीच इंस्ट्रक्शन फ़ाइलें साझा करते हों: AGENTS.md और CLAUDE.md के बीच के टकराव पकड़ना आसान हो जाता है

दूसरी ओर, अगर आपकी इंस्ट्रक्शन फ़ाइलें छोटी हैं और कम ही बदलती हैं, तो जल्दी की कोई ज़रूरत नहीं। गाइड भी कहती है कि कुछ न मिलना भी सही नतीजा है।

सारांश

/doctor prompt-audit एक ऐसा कमांड है जो आपकी इंस्ट्रक्शन फ़ाइलों (CLAUDE.md, AGENTS.md, स्किल और भी बहुत कुछ) में पुराने मॉडलों के लिए लिखी भाषा, मौजूद न रहे पाथ और कमांड, और टकराते नियम खोजता है, फिर रिपोर्ट और सुझाए गए diff लौटाता है। यह Claude Code v2.1.283 और उसके बाद उपलब्ध है, और आपके कहे बिना कुछ नहीं बदलता।

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

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

FAQ

Q. क्या /doctor prompt-audit अपने आप मेरी CLAUDE.md दोबारा लिख देगा?

A. नहीं। आधिकारिक दस्तावेज़ कहता है कि यह रिपोर्ट और सुधार के सुझाव लौटाता है, और जब तक आप Claude से उन्हें लागू करने को न कहें, आपकी फ़ाइलों में कुछ नहीं बदलता। तब भी आप एक-एक सुझाव चुन सकते हैं।

Q. /doctor prompt-audit और /checkup prompt-audit में क्या अंतर है?

A. कोई अंतर नहीं। /checkup असल में /doctor का उपनाम है, और CHANGELOG की v2.1.283 वाली एंट्री में /doctor prompt-audit के साथ /checkup prompt-audit भी लिखा है।

Q. क्या यह Codex वाली AGENTS.md का भी ऑडिट करता है?

A. हाँ। आधिकारिक दस्तावेज़ बिना आर्ग्युमेंट के ऑडिट होने वाली फ़ाइलों में CLAUDE.md और CLAUDE.local.md के साथ AGENTS.md भी गिनाता है। अगर आप दोनों फ़ाइलें साझा करते हैं, तो यह उनके बीच के टकराव पकड़ने में भी अच्छा है।

Q. मैंने टाइप किया, लेकिन ऑडिट शुरू नहीं होता।

A. पहले अपना वर्ज़न जाँचें: /doctor prompt-audit के लिए v2.1.283 या उसके बाद का वर्ज़न चाहिए। अगर वर्ज़न नया है और फिर भी नहीं चलता, तो देखें कि कहीं आपने सेटिंग (skillOverrides या disableBundledSkills) में बंडल की गई /claude-api स्किल बंद तो नहीं कर दी। यह भी ध्यान दें कि टर्मिनल में टाइप किया गया claude doctor सिर्फ़ इंस्टॉलेशन की जाँच करता है और यह ऑडिट नहीं चलाता।

Q. क्या यह API पर बनाए मेरे ऐप के सिस्टम प्रॉम्प्ट का ऑडिट कर सकता है?

A. हाँ, लेकिन उसके लिए /claude-api prompt-audit इस्तेमाल करें (v2.1.221 या उसके बाद)। यह आपके प्रॉम्प्ट, टूल विवरण और API कॉल करने वाले कोड में पुराने मॉडलों के लिए लिखे पैटर्न का ऑडिट करता है और diff सुझाता है।

स्रोत

  • Claude Code आधिकारिक दस्तावेज़: How Claude remembers your project ("Audit your instruction files" सेक्शन)
  • Claude Code आधिकारिक दस्तावेज़: Commands (/doctor और /claude-api वाली पंक्तियाँ)
  • Claude Code आधिकारिक दस्तावेज़: Skills (बंडल की गई /claude-api स्किल के सबकमांड और ज़रूरी वर्ज़न)
  • Claude Code: CHANGELOG (v2.1.283)
  • Claude Code v2.1.286 के साथ बंडल की गई /claude-api स्किल में prompt-audit गाइड (हमारी अपनी मशीन पर जाँची गई)

सभी स्रोत 3 अक्टूबर 2026 को मूल पाठ में जाँचे गए। बंडल की गई गाइड Claude Code की हर रिलीज़ के साथ अपडेट होती है, इसलिए ऑडिट क्या जाँचता है, यह वर्ज़न दर वर्ज़न बदल सकता है।