4.1 Spec-Driven Development (SDD)
4.1 Spec-Driven Development (SDD)
🎯 Objective (इस लेसन का मक़सद)
इस लेसन को पूरा करने के बाद आप:
- समझ पाएंगे कि Spec-Driven Development (SDD) क्या होता है और यह अंदाज़े से कोडिंग करने से बेहतर क्यों है।
- किसी भी फीचर के लिए एक साफ Specification / PRD markdown फाइल लिखना सीखेंगे।
- Claude Code को स्पेक फाइल देकर बिना किसी गलती के पूरा फीचर बनवाना सीखेंगे।
💡 Real-Life Analogy (आसान मिसाल)
मिसाल (मकान बनाना vs आर्किटेक्ट का नक्शा):
अगर आप मजदूरों से कहें “एक 3 कमरे का मकान बना दो जैसा अच्छा लगे”, तो वे ऐसा घर बनाएंगे जिसमें न किचन सही होगा न बाथरूम।
लेकिन अगर आप पहले आर्किटेक्ट से पूरा नक्शा (ब्लूप्रिंट) बनवाते हैं जिसमें एक-एक इंच का नाप लिखा हो, तो हर दीवार और पिलर बिल्कुल सही बनता है।
SDD कोडिंग में वही नक्शा (ब्लूप्रिंट) तैयार करने का तरीका है।
📖 Key Terms & Glossary (ज़रूरी शब्द)
| Term (शब्द) | Simple Meaning (आसान मतलब) | Example (मिसाल) |
|---|---|---|
| Spec (Specification) | फीचर की रिक्वायरमेंट्स और नियमों वाली डॉक्यूमेंट फाइल | specs/auth-feature.md |
| SDD | पहले स्पेक लिखना और फिर AI से बिल्कुल सटीक कोड बनवाना | Spec ➔ Test ➔ Code ➔ Check |
| PRD | प्रोडक्ट का मकसद, जरूरी फीचर्स और नियमों की लिस्ट | Product Requirement Doc |
| Deterministic Code | बिना अंदाज़े के बिल्कुल सही नियमों पर बना कोड | बग-फ्री कोड |
🔄 SDD का 4-स्टेप वर्कफ़्लो
┌───────────────────────────────────────────────────────────┐
│ 1. स्पेक फाइल लिखें (specs/feature-name.md) │
│ - इनपुट / आउटपुट │
│ - डेटाबेस स्कीमा और नियम │
└─────────────────────────────┬─────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────┐
│ 2. Claude Code को फाइल दें │
│ > "specs/auth.md फाइल पढ़ो और स्टेप्स लागू करो" │
└─────────────────────────────┬─────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────┐
│ 3. कोड और टेस्ट्स बनाना │
│ - Claude स्पेक्स के हिसाब से यूनिट टेस्ट्स बनाता है │
│ - API रूट्स और लॉजिक लिखता है │
└─────────────────────────────┬─────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────┐
│ 4. चेकिंग और वेरिफिकेशन │
│ - टेस्ट्स रन करता है: All tests PASS ✅ │
└───────────────────────────────────────────────────────────┘📝 सैंपल स्पेक फाइल (specs/auth.md)
प्रोजेक्ट में specs/ फोल्डर बनाकर फाइल लिखें:
# Feature: User Login & Register
## 1. Goal
यूज़र्स को ईमेल और पासवर्ड से लॉगिन और रजिस्टर करने की सुविधा देना।
## 2. API Endpoints
- `POST /api/auth/register` (body: email, password, name)
- अगर ईमेल पहले से मौजूद है तो `409 Conflict` एरर दे।
- `POST /api/auth/login` (body: email, password)
- सही पासवर्ड पर JWT टोकन रिटर्न करे।
## 3. Security Rules
- पासवर्ड्स को `bcrypt` से हैश करना है।
- ईमेल का सही फॉर्मेट चेक होना चाहिए।
## 4. Test Cases
- सही डेटा पर यूज़र रजिस्टर होना चाहिए।
- गलत पासवर्ड पर `401 Unauthorized` मिलना चाहिए।💻 टर्मिनल में इसे कैसे चलाएं?
अब Claude Code में यह प्रॉम्प्ट दें:
> "specs/auth.md फाइल को पढ़ो। इसके हिसाब से auth routes, controllers, और unit tests बनाओ। जब सारे टेस्ट्स पास हो जाएं तब मुझे बताओ।"Claude Code बिना किसी अंदाज़े के बिल्कुल सही कोड और टेस्ट्स बनाकर तैयार कर देगा!
⚠️ Common Mistakes & Pro Tips (बचने वाली गलतियाँ)
- ❌ गलती: जल्दबाजी में बिना स्पेक लिखे सीधा कोडिंग शुरू करवाना और फिर घंटों बग्स ढूंढना।
- ✅ Pro Tip: 10 मिनट स्पेक लिखने में लगाएं, इससे AI का कोडिंग समय 80% तेज़ और बिल्कुल सही हो जाता है।
📝 Practice Challenge (खुद करके देखें)
- अपने किसी नए फीचर के लिए
specs/todo-api.mdफाइल लिखें। - उसमें 3 API रूट्स और 2 टेस्ट केसेस तय करें।
- Claude Code को स्पेक फाइल पास करें और देखें कितना साफ कोड बनता है!
📌 Quick Revision Summary (मुख्य बातें)
- SDD में कोड लिखने से पहले रिक्वायरमेंट्स की साफ फाइल बनती है।
- यह AI को “बिना भटके” सीधा सही कोड लिखने में मदद करता है।
- स्पेक्स से AI खुद-ब-खुद ऑटोमैटिक टेस्ट केसेस भी बना लेता है।
🧭 Next Steps & Navigation
- ⬅️ पिछला Module: Module 3: Memory & CLAUDE.md
- ➡️ अगला Lesson: 4.2 Plan Mode & Ultraplan
Last updated on