इस प्रोजेक्ट के बारे में

एसडीडी + एडीडी स्टार्टर टेम्पलेट एआई प्रोग्रामिंग असिस्टेंट्स, विशेष रूप से क्लॉड कोड के लिए एक गवर्नेंस फ्रेमवर्क है। इसका प्राथमिक लक्ष्य एआई असिस्टेंट को एक अनुशासित विकास भागीदार में बदलना है जो स्पेक-संचालित विकास (एसडीडी) वर्कफ़्लो और एजेंट-संचालित विकास (एडीडी) के संयोजन के अनुसार काम करता है। ## मुख्य वर्कफ़्लो टेम्पलेट एक अनुक्रमिक विकास वर्कफ़्लो लागू करता है: CONTEXT → SPEC → PLAN → TASKS → execute → verify → sync। प्रत्येक चरण में एक चेकपॉइंट होता है और एजेंट को निष्पादन की अनुमति देने से पहले मानव अनुमोदन की आवश्यकता होती है। ## तीन मूलभूत नियम 1. **कोड नहीं, स्पेक संपादित करें**: जब कोई आवश्यकता अनुपस्थित या अस्पष्ट हो, तो पहले स्पेक को अपडेट करने के लिए `/sdd-update` कमांड का उपयोग करें, फिर व्यवहार बदलने से पहले उसकी समीक्षा करें। 2. **कोई तकनीकी अटकल नहीं**: योजना, कार्य और निष्पादन केवल `.sdd/architecture-profile.md` में अनुमोदित बाइंडिंग और सटीक सत्यापन कमांड का उपयोग करते हैं। 3. **मानव निर्णय लेते हैं**: एजेंट स्वयं अनुमोदन नहीं करता, `git push` नहीं करता, तैनात नहीं करता, और स्वायत्त रूप से भौतिक स्थिति परिवर्तन नहीं करता। ## स्वामित्व और निष्पादन टेम्पलेट `.sdd/shared_context.md` में दो स्वतंत्र अक्षों को अलग करता है: - **प्रोजेक्ट स्वामित्व** (`solo` या `team`): मानव समीक्षा की वैधता और गिट डिलीवरी नीति निर्धारित करता है। डिफ़ॉल्ट `team` है। - **एजेंट निष्पादन** (`direct` या `orchestrated`): `/add-execute` सीधे वर्तमान एजेंट में चलता है या रनटाइम क्षमताओं को देखने के बाद वर्कर्स को ऑर्केस्ट्रेट करता है। ## दस्तावेज़ीकरण टेम्पलेट एक व्यापक दस्तावेज़ीकरण प्रणाली प्रदान करता है: - **त्वरित प्रारंभ** (`docs/sdd-add-quickstart.md`): नए लोगों के लिए चरण-दर-चरण रोडमैप। - **संचालन गाइड** (`docs/sdd-add-guide.md`): आर्टिफैक्ट्स, गेट्स और स्वामित्व को समझें। - **त्वरित संदर्भ** (`docs/sdd-add-field-guide.md`): परिदृश्य के अनुसार कमांड चुनें। - **परिदृश्य प्लेबुक** (`docs/sdd-add-scenario-playbook.md`): ग्रीनफील्ड, ब्राउनफील्ड, त्रुटियों और हैंडऑफ़ को संभालें। - **आर्किटेक्चर प्रोफ़ाइल गाइड** (`docs/architecture-profile-guide.md`): बाइंडिंग और तकनीकी कमांड चुनें। - **निष्पादन गाइड** (`docs/multi-agent-orchestration-guide.md`): कार्य/सुविधाएँ निष्पादित करें और वर्कर ऑर्केस्ट्रेशन। ## विहित स्रोत - `.claude/skills/`: कमांड के लिए अनुबंध। - `.claude/skills/_shared/ai-review-protocol.md`: समीक्षा प्रोटोकॉल, कार्यप्रणाली और कार्रवाई रिकॉर्ड। - `.sdd/architecture-profile.md`: तकनीकी बाइंडिंग और सटीक सत्यापन कमांड। - `CONSTITUTION.md`: सुरक्षा, आर्किटेक्चर और गुणवत्ता पर कठोर नियम। - `AGENTS.md`: एजेंट का दायरा और अनुमतियाँ। ## उपयोगिता स्क्रिप्ट - `scripts/self-heal.sh`: साक्ष्य एकत्र करने के लिए अनुमोदित कमांड चलाता है; स्रोत को संशोधित या पुनः प्रयास नहीं करता। - `scripts/template-smoke.sh` / `.ps1`: फ़ाइलों, लिंक और नीति अनुबंधों के लिए स्थैतिक जाँच। - `scripts/adopt.*`: मौजूदा रिपॉजिटरी में टेम्पलेट अपनाएँ। - `scripts/update.*`: टेम्पलेट से अपडेट खींचें; गवर्नेंस फ़ाइलें मानव समीक्षा के लिए चरणबद्ध हैं।