sddadd

Le modèle de démarrage SDD + ADD est un cadre de gouvernance pour les assistants de programmation IA, en particulier Claude Code. Son objectif principal est de transformer l'assistant IA en un partenaire de développement discipliné qui travaille selon un flux de travail de développement piloté par les spécifications (SDD) combiné au développement piloté par les agents (ADD). ## Flux de travail principal Le modèle applique un flux de travail de développement séquentiel : CONTEXT → SPEC → PLAN → TASKS → exécuter → vérifier → synchroniser. Chaque étape comporte un point de contrôle et nécessite l'approbation humaine avant que l'agent ne soit autorisé à exécuter. ## Trois règles fondamentales 1. **Modifiez la spec, pas le code** : Lorsqu'une exigence est manquante ou ambiguë, utilisez la commande `/sdd-update` pour mettre à jour la spec d'abord, puis examinez-la avant de modifier le comportement. 2. **Aucune spéculation technique** : Le plan, les tâches et l'exécution n'utilisent que les liaisons et les commandes de vérification exactes approuvées dans `.sdd/architecture-profile.md`. 3. **Les humains décident** : L'agent ne s'auto-approuve pas, ne fait pas de `git push`, ne déploie pas et n'effectue pas de manière autonome des changements d'état physique. ## Propriété et exécution Le modèle sépare deux axes indépendants dans `.sdd/shared_context.md` : - **Propriété du projet** (`solo` ou `team`) : Détermine la validité de la revue humaine et la politique de livraison Git. Par défaut, `team`. - **Exécution de l'agent** (`direct` ou `orchestrated`) : `/add-execute` s'exécute directement dans l'agent courant ou orchestre des travailleurs après observation des capacités d'exécution. ## Documentation Le modèle fournit un système de documentation complet : - **Démarrage rapide** (`docs/sdd-add-quickstart.md`) : Feuille de route étape par étape pour les nouveaux arrivants. - **Guide d'utilisation** (`docs/sdd-add-guide.md`) : Comprendre les artefacts, les jalons et la propriété. - **Référence rapide** (`docs/sdd-add-field-guide.md`) : Choisir les commandes selon le scénario. - **Playbook de scénarios** (`docs/sdd-add-scenario-playbook.md`) : Gérer les projets greenfield, brownfield, les erreurs et les transferts. - **Guide de profil d'architecture** (`docs/architecture-profile-guide.md`) : Sélectionner les liaisons et les commandes techniques. - **Guide d'exécution** (`docs/multi-agent-orchestration-guide.md`) : Exécuter les tâches/fonctionnalités et l'orchestration des travailleurs. ## Sources canoniques - `.claude/skills/` : Contrats pour les commandes. - `.claude/skills/_shared/ai-review-protocol.md` : Protocole de revue, méthodologie et enregistrement des actions. - `.sdd/architecture-profile.md` : Liaisons techniques et commandes de vérification exactes. - `CONSTITUTION.md` : Règles strictes en matière de sécurité, d'architecture et de qualité. - `AGENTS.md` : Portée et permissions de l'agent. ## Scripts utilitaires - `scripts/self-heal.sh` : Exécute une commande approuvée pour collecter des preuves ; ne modifie pas la source et ne réessaie pas. - `scripts/template-smoke.sh` / `.ps1` : Vérifications statiques des fichiers, liens et contrats de politique. - `scripts/adopt.*` : Adopter le modèle dans un dépôt existant. - `scripts/update.*` : Récupérer les mises à jour du modèle ; les fichiers de gouvernance sont préparés pour la revue humaine.