منصوبے کے بارے میں

SDD + ADD اسٹارٹر ٹیمپلیٹ AI پروگرامنگ اسسٹنٹس، خاص طور پر Claude Code کے لیے ایک گورننس فریم ورک ہے۔ اس کا بنیادی مقصد AI اسسٹنٹ کو ایک نظم و ضبط والے ترقیاتی پارٹنر میں تبدیل کرنا ہے جو اسپیک پر مبنی ترقی (SDD) کے ورک فلو کے ساتھ ایجنٹ پر مبنی ترقی (ADD) کو ملا کر کام کرتا ہے۔ ## بنیادی ورک فلو یہ ٹیمپلیٹ ایک ترتیب وار ترقیاتی ورک فلو لاگو کرتا ہے: CONTEXT → SPEC → PLAN → TASKS → execute → verify → sync۔ ہر مرحلے پر ایک چیک پوائنٹ ہوتا ہے اور ایجنٹ کو عمل کرنے کی اجازت دینے سے پہلے انسانی منظوری درکار ہوتی ہے۔ ## تین بنیادی اصول 1. **کوڈ نہیں، اسپیک میں ترمیم کریں**: جب کوئی ضرورت غائب یا مبہم ہو، تو پہلے `/sdd-update` کمانڈ سے اسپیک کو اپ ڈیٹ کریں، پھر رویہ تبدیل کرنے سے پہلے اس کا جائزہ لیں۔ 2. **کوئی تکنیکی قیاس آرائی نہیں**: منصوبہ، کام، اور عمل صرف ان بائنڈنگز اور درست تصدیقی کمانڈز کا استعمال کرتے ہیں جو `.sdd/architecture-profile.md` میں منظور شدہ ہیں۔ 3. **فیصلہ انسان کرتا ہے**: ایجنٹ خود منظوری نہیں دیتا، `git push` نہیں کرتا، تعیناتی نہیں کرتا، اور خود مختارانہ طور پر جسمانی حالت میں تبدیلیاں نہیں کرتا۔ ## ملکیت اور عمل یہ ٹیمپلیٹ `.sdd/shared_context.md` میں دو آزاد محوروں کو الگ کرتا ہے: - **پروجیکٹ کی ملکیت** (`solo` یا `team`): انسانی جائزے کی درستگی اور Git ڈیلیوری پالیسی کا تعین کرتا ہے۔ ڈیفالٹ `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.*`: ٹیمپلیٹ سے اپ ڈیٹس کھینچیں؛ گورننس فائلیں انسانی جائزے کے لیے تیار کی جاتی ہیں۔