عن المشروع

قالب الانطلاق SDD + ADD هو إطار حوكمة لمساعدي البرمجة بالذكاء الاصطناعي، ولا سيما Claude Code. هدفه الأساسي تحويل المساعد الذكي إلى شريك تطوير منضبط يعمل وفق سير عمل التطوير المدفوع بالمواصفات (SDD) مقترنًا بالتطوير المدفوع بالوكيل (ADD). ## سير العمل الأساسي يطبق القالب سير عمل تطويريًا تسلسليًا: CONTEXT → SPEC → PLAN → TASKS → تنفيذ → تحقق → مزامنة. لكل خطوة نقطة تفتيش وتتطلب موافقة بشرية قبل أن يُسمح للوكيل بالتنفيذ. ## القواعد التأسيسية الثلاث 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.*`: سحب التحديثات من القالب؛ تُرحل ملفات الحوكمة للمراجعة البشرية.