CLAUDE.md आपके प्रोजेक्ट की जड़ में एक सादी मार्कडाउन फ़ाइल है। Claude इसे हर सत्र में स्वचालित रूप से पढ़ता है। प्रोजेक्ट-स्तर: ./CLAUDE.md। वैश्विक (सभी प्रोजेक्ट): ~/.claude/CLAUDE.md। प्रोजेक्ट वैश्विक को ओवरराइड करता है: वैश्विक फ़ाइल आपके डिफ़ॉल्ट रखती है, प्रोजेक्ट फ़ाइल इस रेपो की विशिष्टताओं को रखती है।
इसे एक ऑनबोर्डिंग दस्तावेज़ के रूप में सोचें जो आप एक अत्यधिक कुशल ठेकेदार को देते हैं जो आपके प्रोजेक्ट के बारे में कुछ नहीं जानता। इसके बिना, हर सत्र Claude के आपके स्टैक, आपकी नामकरण परंपराओं और आपके पिछले निर्णयों का अनुमान लगाने के साथ शुरू होता है। अनुमान कोड बन जाते हैं, कोड बग बन जाते हैं। CLAUDE.md उस श्रृंखला को शॉर्ट-सर्किट करता है। एक फ़ाइल एक चतुर प्रॉम्प्ट को हरा देती है क्योंकि यह काम करती है चाहे आपको याद हो या नहीं।
पांच खंड जो अपना महत्व साबित करते हैं। प्रत्येक में तीन से छह बुलेट लाइनें:
1. स्टैक: फ़्रेमवर्क, डीबी, प्रमाणीकरण, ईमेल, संस्करणों के साथ। "Next.js 16, Neon पर Postgres, ईमेल के लिए Resend, भुगतानों के लिए Stripe, प्रमाणीकरण के लिए Supabase।"
2. रूट्स: चीजें कहाँ रहती हैं। "/app में ऐप, /actions में सर्वर क्रियाएं, /app/api/v2 के तहत API, /components/ui में साझा घटक।"
3. परंपराएं: नियम जो आपको स्पष्ट हैं, Claude के लिए अदृश्य हैं। "पैसे सेंट में (int), तिथियां UTC, फ़ाइलनाम केबाब-केस, IDs UUID v4 के रूप में।"
4. सुरक्षा नियम: ऐसी चीजें जो कभी नहीं होनी चाहिए। "कभी भी API कुंजियों को लॉग न करें। सभी SQL को पैरामीटर करें। सभी सार्वजनिक एंडपॉइंट्स को दर-सीमित करें।"
5. यह न करें: जाल जिनमें आप पहले ही फंस चुके हैं। "बिना पूछे deps न जोड़ें। स्थानीय से उत्पादन के खिलाफ माइग्रेशन न चलाएं।"
एक काम किया हुआ टेम्पलेट। अपने वास्तविक प्रोजेक्ट विवरणों को स्वैप करें:
# Plinko Grant Tracker
## Stack
- Next.js 16, Postgres (Neon), Resend, Stripe
- Auth: Supabase Auth with Google OAuth
## Routes
- App in /app, actions in /actions, API under /app/api/v2
## Conventions
- Money in cents (int), dates UTC, filenames kebab-case
- IDs: UUID v4. Boolean columns: is_ or has_ prefix
## Security Rules
- Never log secrets, parameterize SQL
- Rate-limit all POST/PUT/DELETE endpoints (10/min per IP)
- New Supabase tables ship with RLS policies in same commit
## Don't Do This
- Don't add deps without asking
- Don't run migrations from local against prod
- Don't use select(*)विशिष्टता पर ध्यान दें। "10/min प्रति IP" कार्रवाई योग्य है। "दर-सीमित का उपयोग करें" नहीं है।
सबसे महंगी गलती: अस्पष्ट नियम जो विशिष्ट लगते हैं।
कमजोर: "पैसे को सावधानी से संभालें।" Claude पैसे को उस तरह से संभालेगा जैसा वह सबसे अच्छा समझता है, जो आपके सिस्टम से मेल नहीं खा सकता है।
मजबूत: "सभी मौद्रिक राशियाँ पूर्णांक सेंट हैं। कभी भी फ़्लोट नहीं। कभी भी कच्चे सेंट प्रदर्शित न करें; 100 से विभाजित करें और मुद्रा प्रतीक के साथ प्रारूपित करें।" भंडारण प्रकार, प्रसंस्करण नियम, प्रदर्शन नियम। कोई अस्पष्टता नहीं।
दूसरी गलती: बाधाओं के बजाय आकांक्षाएं लिखना। "हम स्वच्छ, पठनीय कोड को महत्व देते हैं" एक आकांक्षा है। "200 लाइनों से अधिक की फ़ाइलें मॉड्यूल में विभाजित हैं" एक बाधा है। आकांक्षाओं को निर्णय की आवश्यकता होती है; बाधाएं सुसंगत व्यवहार उत्पन्न करती हैं। अपनी CLAUDE.md को बाधाओं से भरें।
CLAUDE.md एक जीवित दस्तावेज़ है। तीन संकेत जिन्हें अद्यतन करने की आवश्यकता है:
आप दूसरी बार एक ही संदर्भ को एक प्रॉम्प्ट में पेस्ट करते हैं। यदि आप इसे फिर से कह रहे हैं, तो यह CLAUDE.md में आता है।
Claude एक गलती करता है जिसे एक नियम ने रोका होता। गलती ही नियम है। इसे अगले सत्र से पहले लिखें।
आप एक सहकर्मी को एक परंपरा समझाते हैं। यदि इसे जोर से कहने लायक था, तो इसे स्वचालित रूप से लोड करने लायक है।
लंबाई अनुशासन: प्रति अनुभाग तीन से छह बुलेट; आठ से अधिक होने पर, अनुभाग को विभाजित करें। एक CLAUDE.md जो स्किम करने के लिए बहुत लंबा है, काम करना बंद कर देता है क्योंकि महत्वपूर्ण नियम दब जाते हैं। छह लाइनें जो सही छह हैं, साठ लाइनों की पैडिंग को हरा देती हैं।
लगभग 300 लाइनों से आगे स्केलिंग: @filename शामिल के साथ विषय फ़ाइलों में विभाजित करें:
# CLAUDE.md (root)
@rules/stack.md
@rules/security.md
@rules/db-migrations.mdप्रत्येक विषय फ़ाइल केंद्रित रहती है; रूट छोटा रहता है।
CLAUDE.md को संस्करण नियंत्रण में कमिट करें। नियम PRs में समीक्षणीय हो जाते हैं, और एक नया टीममेट Claude पहले से कॉन्फ़िगर किए गए रेपो को क्लोन करता है। प्रत्येक 'यह न करें' नियम को उसी कमिट में जोड़ें जिसमें बग फिक्स है जिसने इसे सिखाया था। एक सावधानी: कमिट करने से पहले मशीन-विशिष्ट पथों को सामान्य करें।
CLAUDE.md बनाम एक प्रॉम्प्ट में क्या आता है? ब्लास्ट रेडियस। यदि एक नियम एक प्रकार की गलती को रोकता है जिसे ठीक करने में एक घंटे या उससे अधिक का समय लगता है, तो वह CLAUDE.md में जाता है। सत्र-विशिष्ट निर्देश प्रॉम्प्ट में रहते हैं।
दस मिनट में अपनी पहली CLAUDE.md बनाएं। Claude को यह प्रॉम्प्ट दें:
"मैं इस स्टैक के साथ एक प्रोजेक्ट के लिए Claude Code स्थापित कर रहा हूँ: [स्टैक]। मुख्य परंपराएं जो कोई नया व्यक्ति नहीं जानता होगा: [परंपराएं]। सुरक्षा नियम जिनका कभी उल्लंघन नहीं किया जाना चाहिए: [नियम]। ऐसी चीजें जिन्होंने पहले बग पैदा किए: [जाल]। पांच खंडों के साथ एक CLAUDE.md का मसौदा तैयार करें: स्टैक, रूट्स, परंपराएं, सुरक्षा नियम, यह न करें।"
पहला मसौदा आपको 80 प्रतिशत देता है। Claude ने जो छोड़ा उसे परिष्कृत करें; शेष 20 प्रतिशत वह है जो प्रोजेक्ट के साथ आपके वास्तविक अनुभव के लिए विशिष्ट है।
प्रोजेक्ट रूट पर CLAUDE.md आपके स्टैक, रूट्स, परंपराओं, सुरक्षा नियमों और जालों को हर सत्र में लोड करता है। क्रॉस-प्रोजेक्ट डिफ़ॉल्ट के लिए वैश्विक फ़ाइल, ओवरराइड के लिए प्रोजेक्ट फ़ाइल। आकांक्षाएं नहीं, बाधाएं। छह सही लाइनें साठ को हरा देती हैं। जब भी Claude एक गलती करता है जिसे एक लिखित नियम ने रोका होता, तो इसे अपडेट करें।