Outils Cycle de vie des specs (Flux B)
Le flux B contient 11 outils qui gèrent l'intégralité du cycle de vie des specs — de la première question de clarification à la transmission d'une spec prête pour la production à un agent IA.
clarify_requirements
Générer des questions de clarification ciblées avant de créer une spec.
Quand l'utiliser : Avant create_spec lorsque les exigences sont ambiguës, proviennent d'une conversation verbale rapide, ou touchent plusieurs systèmes.
Ce qu'il produit : Une liste priorisée de questions couvrant le périmètre, les cas limites, les exigences non-fonctionnelles, la gestion des erreurs et les dépendances externes.
Prompt : "Utilise specforge pour clarifier les exigences pour l'ajout de paiements Stripe au projet proj_abc123"TIP
Exécuter clarify_requirements en premier conduit à des critères d'acceptation nettement plus complets et à moins de révisions de specs. C'est un investissement de 30 secondes qui fait gagner des heures.
create_spec
Créer une spec SDD complète avec des sections auto-générées.
Ce qu'il génère :
| Section | Description |
|---|---|
| User Story | Qui, quoi, pourquoi en format standard |
| Critères d'acceptation | Critères testables et sans ambiguïté numérotés pour la traçabilité |
| Checklist DoR | Portes de Définition de Prêt |
| Indications schéma BDD | Tables, colonnes, relations, index |
| Contrats UI | Contrats de composants, flux de données, gestion d'état |
| Indications ADR | Architecture Decision Records |
| PLAN.md | Plan d'exécution RED/GREEN/VERIFY étape par étape |
Extras IA natives (lorsqu'une architecture IA est détectée) :
- Budgets de latence et chaînes de repli
- Critères de versionnage des prompts
- Exigences d'observabilité LLM
Extras frontend (lorsqu'une configuration de performance est détectée) :
- Critères Core Web Vitals
- Exigences d'hydratation SSR
- Définitions de limites MFE
Prompt : "Crée une spec pour l'ajout de l'authentification Google OAuth à mon projet proj_abc123"list_specs
Lister toutes les specs d'un projet, avec filtrage optionnel par statut.
Quand l'utiliser : Pour voir ce qui est dans le backlog, ce qui est en cours ou ce qui nécessite une revue.
Prompt : "Liste toutes les specs du projet proj_abc123"
Prompt : "Montre-moi les specs en cours pour le projet proj_abc123"
Prompt : "Quelles specs sont bloquées dans le projet proj_abc123 ?"update_status
Faire progresser une spec dans son cycle de vie avec validation DoR/DoD à chaque étape.
Flux de statut : draft → ready → in_progress → review → done
Chaque transition valide la checklist appropriée. Vous ne pouvez pas marquer une spec done sans satisfaire ses critères DoD.
Prompt : "Mets à jour le statut de la spec SPEC-003 à in_progress dans le projet proj_abc123"
Prompt : "Marque la spec SPEC-007 comme done dans le projet proj_abc123"summarize_spec
Générer un résumé concis d'une spec — utile pour les mises à jour d'équipe, les descriptions de PR ou les notes de standup.
Prompt : "Résume la spec SPEC-005 pour le projet proj_abc123"generate_checklist
Générer une checklist de qualité pour une spec — couvre la préparation à l'implémentation, la couverture de tests, la documentation, la sécurité et les performances.
Prompt : "Génère une checklist de qualité pour la spec SPEC-002 dans le projet proj_abc123"reconcile_spec
Réconcilier une spec avec les changements d'implémentation, avec approbation par changement et vérification de conformité à la Constitution.
Quand l'utiliser : Lorsque l'implémentation a délibérément divergé de la spec et que vous devez mettre à jour la spec pour refléter la réalité.
L'outil présente chaque changement pour approbation — vous décidez ce qui devient la nouvelle vérité de la spec.
Prompt : "Réconcilie la spec SPEC-004 avec les changements d'implémentation dans le projet proj_abc123"manage_scope
Gérer la définition du périmètre du projet et le backlog — ajouter des éléments, supprimer, reprioriser ou exporter sous forme de backlog structuré.
Prompt : "Ajoute 'support du mode sombre' au backlog du projet proj_abc123 avec priorité haute"
Prompt : "Montre le backlog actuel du projet proj_abc123"detect_contradictions
Analyser toutes les specs d'un projet pour des contradictions sémantiques.
Quand l'utiliser : Avant de démarrer un sprint, après un pivot produit majeur, ou lorsque des specs ont été mises à jour indépendamment par différents membres de l'équipe.
Prompt : "Détecte les contradictions dans les specs du projet proj_abc123"Exemple de sortie : "SPEC-002 dit que les utilisateurs peuvent supprimer des comptes. SPEC-008 dit que les données de compte sont immuables à des fins d'audit."
check_readiness
Évaluer si une spec est prête pour l'implémentation — complétude, qualité des critères et statut des dépendances.
Vérifications effectuées :
- Tous les critères d'acceptation sont-ils testables et sans ambiguïté ?
- Toutes les dépendances bloquantes sont-elles résolues ?
- La checklist DoR est-elle complète ?
- La spec passe-t-elle la vérification de conformité à la Constitution ?
Prompt : "Vérifie si la spec SPEC-006 est prête pour l'implémentation dans le projet proj_abc123"package_handoff
Générer un paquet de transfert structuré pour qu'un agent IA implémente une spec.
Ce qu'il produit :
- Objectif d'implémentation
- Critères d'acceptation numérotés
- Liste de fichiers avec propriété
- Contraintes et garde-fous
- Prompt prêt à coller pour Claude ou tout agent IA
Quand l'utiliser : Lors de la délégation d'implémentation à une session d'agent IA autonome ou à un membre de l'équipe qui n'était pas impliqué dans la création de la spec.
Prompt : "Empaquète la spec SPEC-009 pour transfert dans le projet proj_abc123"