3.2 CLAUDE.md — The Project Brain

🎯 Objective (इस लेसन का मक़सद)

इस लेसन को पूरा करने के बाद आप:

• समझ पाएंगे कि CLAUDE.md फाइल क्या है और यह Claude Code के लिए सबसे जरूरी फाइल क्यों है।
• एक सही CLAUDE.md फाइल लिखना सीखेंगे जिसमें बिल्ड कमांड्स, कोडिंग के नियम और टेस्टिंग के तरीके शामिल हों।
• Global ~/.claude/CLAUDE.md और लोकल प्रोजेक्ट CLAUDE.md का फर्क समझेंगे।

💡 Real-Life Analogy (आसान मिसाल)

मिसाल (कंपनी की रूलबुक / हैंडबुक):
जब कोई नया कर्मचारी ऑफिस जॉइन करता है, तो उसे एक नियम-पुस्तिका (रूलबुक) दी जाती है जिसमें लिखा होता है: ऑफिस का समय क्या है, कोड कैसे लिखना है और कौन सी गलती नहीं करनी है।
CLAUDE.md आपके AI एजेंट के लिए वही रूलबुक है। जब भी Claude Code चालू होता है, वह सबसे पहले इस फाइल को पढ़ता है और इसके नियम कभी नहीं भूलता!

📖 Key Terms & Glossary (ज़रूरी शब्द)

🏗️ CLAUDE.md का सही फॉर्मेट

एक अच्छी CLAUDE.md फाइल में ये 4 मुख्य हिस्से होने चाहिए:

# CLAUDE.md - Project Guidelines & Rules

## 1. Build & Test Commands (चलाने के कमांड्स)
- Build: `npm run build`
- Test: `npm test`
- Lint: `npm run lint`
- **नियम:** कभी भी `npm run dev` बैकग्राउंड में मत चलाना।

## 2. Tech Stack (प्रोजेक्ट क्या इस्तेमाल करता है)
- Frontend: React (Next.js 14 App Router), Tailwind CSS
- Backend: Node.js, Express, PostgreSQL (Prisma ORM)

## 3. Code Style & Rules (लिखने का तरीका)
- हमेशा TypeScript इस्तेमाल करें (Strict mode).
- हर फंक्शन में try-catch और सही एरर हैंडलिंग लिखें।

## 4. Tone & Language (बात करने का तरीका)
- यूज़र से आसान बोलचाल वाली हिंदी/हिंग्लिश में बात करें।
- मुश्किल और शुद्ध हिंदी के शब्दों से बचें।

⚙️ Claude Code इसे कैसे पढ़ता है?

जब भी आप कोई काम देते हैं:

[ यूज़र प्रॉम्प्ट: "Fix cart bug" ]
              │
              ▼
[ 1. CLAUDE.md खुद लोड होती है ] ───> कमांड्स और प्रोजेक्ट नियम चेक करता है
              │
              ▼
[ 2. नियमों के हिसाब से काम ]    ───> Next.js 14 का सही तरीका यूज़ करता है
              │
              ▼
[ 3. बिल्कुल सही कोड तैयार! ]     ───> 100% सही और टेस्टेड कोड मिलता है

🌐 Global vs Local CLAUDE.md

⚠️ Common Mistakes & Pro Tips (बचने वाली गलतियाँ)

• ❌ गलती: CLAUDE.md में 2000 लाइनों का लंबा निबंध लिख देना जिससे टोकन बर्बाद हों।
• ✅ Pro Tip: CLAUDE.md को छोटा और पॉइंट-वाइज रखें (100-150 लाइनों के अंदर)। सिर्फ काम की बातें ही लिखें।

📝 Practice Challenge (खुद करके देखें)

1. अपने प्रोजेक्ट में > /init चलाकर CLAUDE.md बनाएं।
2. उसमें एक नया नियम जोड़ें: “हर बदलाव के बाद 1 लाइन की समरी दो”।
3. टेस्ट करें कि AI यह नियम फॉलो कर रहा है या नहीं।

📌 Quick Revision Summary (मुख्य बातें)

• CLAUDE.md आपके प्रोजेक्ट का मास्टर दिमाग है जिसे AI हर बार पढ़ता है।
• इसमें बिल्ड कमांड्स, टेक्नोलॉजी और कोडिंग के तौर-तरीके लिखे जाते हैं।
• /init कमांड से यह फाइल खुद-ब-खुद बन सकती है।

🧭 Next Steps & Navigation

• ⬅️ पिछला Lesson: 3.1 Context Window Management
• ➡️ अगला Module: Module 4: Development Workflows & Planning