Outils Cycle de vie des specs (Flux B)
Le flux B contient tous les outils qui gèrent le cycle de vie complet des specs — de la première question de clarification à la transmission d'une spec prête pour la production à un agent IA.
Référence rapide
| Outil | Description | Disponibilité |
|---|---|---|
facilitate | Point d'entrée sans connaissance préalable — décrivez ce que vous voulez construire | Inclus |
clarify_requirements | Clarifier interactivement les exigences avant de créer une spec | Inclus |
elicit_requirements | Élicitation avancée et interactive des exigences | Inclus |
create_spec | Créer une spec SDD complète depuis une description | Inclus |
list_specs | Lister toutes les specs d'un projet, filtrer par statut | Inclus |
update_status | Faire progresser une spec dans ses étapes de cycle de vie | Inclus |
summarize_spec | Générer un résumé court et lisible d'une spec | Inclus |
spec_history | Consulter l'historique des modifications d'une spec | Inclus |
reconcile_spec | Mettre à jour une spec pour correspondre à ce qui a réellement été construit | Inclus |
branch_spec | Créer une branche de spec pour l'expérimentation | Inclus |
merge_spec_branch | Fusionner une branche de spec expérimentale dans la spec principale | Inclus |
version_spec | Créer un snapshot de version tagué d'une spec | Inclus |
spec_diff | Comparer deux versions de spec et afficher les différences | Inclus |
export_spec | Exporter une spec vers un format externe (spec-kit) | Inclus |
check_readiness | Vérifier si une spec a suffisamment de détails pour commencer à construire | Inclus |
challenge_spec | Tester une spec sous pression en simulant des défaillances et des cas limites | Inclus |
red_team | Revue adversariale — argumente contre la spec depuis les principes fondamentaux | Inclus |
detect_contradictions | Détecter les contradictions et incohérences dans ou entre les specs | Inclus |
manage_scope | Gérer et contrôler le périmètre pour prévenir le scope creep | Inclus |
package_handoff | Emballer une spec et ses dépendances pour la transmission à un agent ou une équipe | Inclus |
decompose_spec | Décomposer automatiquement une spec en tâches d'agents indépendantes | Inclus |
analyze_spec_dependencies | Analyser le graphe de dépendances : chemin critique, dépendances circulaires, vagues | Inclus |
generate_checklist | Générer une checklist d'implémentation depuis une spec | Inclus |
check_spec_accuracy | Valider une spec par rapport à l'implémentation réelle de la base de code | Inclus |
spec_coverage | Générer un rapport de couverture montrant les specs par rapport à l'implémentation | Inclus |
spec_usage_report | Rapport montrant quelles specs les agents utilisent activement | Inclus |
semantic_search | Rechercher des specs et la connaissance du projet par signification | Inclus |
list_templates | Parcourir le catalogue de templates de specs intégrés et personnalisés | Inclus |
apply_template | Créer des fichiers de spec depuis un template de spec | Inclus |
capture_idea | Capturer une idée légère sans créer une spec complète | Inclus |
list_backlog | Lister toutes les idées capturées dans le backlog du projet | Inclus |
promote_idea | Promouvoir une idée du backlog en spec complète | Inclus |
discard_idea | Marquer une idée du backlog comme rejetée | Inclus |
session_checkpoint | Sauvegarder un point de contrôle de session avec le contexte actuel | Inclus |
planu_status | Obtenir un snapshot compact de l'état actuel du projet | Inclus |
log_lesson | Enregistrer une leçon apprise depuis une spec ou une expérience de projet | Inclus |
list_lessons | Lister les leçons apprises pour un projet | Inclus |
delete_spec | Supprimer une ou plusieurs specs d'un projet | Inclus |
delete_project | Supprimer toutes les données d'un projet | Inclus |
delete_pattern | Supprimer un ou plusieurs patterns appris | Inclus |
delete_decision | Supprimer une ou plusieurs décisions/ADR | Inclus |
manage_trash | Gérer la corbeille : lister, restaurer ou purger | Inclus |
generate_spec_dashboard | Régénérer le dashboard planu/index.html | Inclus |
Flux de travail principal
facilitate
Point d'entrée sans connaissance préalable — décrivez ce que vous voulez construire et Planu détermine les prochaines étapes.
Quand l'utiliser : Quand vous ne savez pas par où commencer. Décrivez simplement votre idée ou votre objectif en langage naturel et facilitate déterminera s'il faut clarifier les exigences, créer une spec ou suggérer la prochaine action.
Prompt: "I want to add Stripe payments to my app"
Prompt: "Help me plan a multi-tenant permission system"TIP
facilitate est le meilleur point de départ pour les nouveaux utilisateurs. Il supprime la nécessité de connaître les noms des outils — décrivez simplement ce que vous voulez construire.
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 les limites du périmètre, les cas limites, les exigences non-fonctionnelles, la gestion des erreurs et les dépendances externes.
Prompt: "Use planu to clarify requirements for adding Stripe payments to project 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.
elicit_requirements Pro
Élicitation avancée et interactive des exigences — un mode entretien structuré qui va plus loin que clarify_requirements.
Quand l'utiliser : Pour les fonctionnalités complexes, les migrations de plateforme ou les intégrations impliquant plusieurs parties prenantes. L'outil guide la conversation avec des questions de suivi basées sur vos réponses plutôt que de présenter une liste plate.
Prompt: "Elicit requirements for the new reporting module in project proj_abc123"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 natifs (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: "Create a spec for adding Google OAuth authentication to my project 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: "List all specs for project proj_abc123"
Prompt: "Show me specs in progress for project proj_abc123"
Prompt: "What specs are blocked in project 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: "Update status of spec SPEC-003 to in_progress in project proj_abc123"
Prompt: "Mark spec SPEC-007 as done in project 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: "Summarize spec SPEC-005 for project proj_abc123"Gestion du cycle de vie des specs
spec_history Pro
Consulter l'historique des modifications d'une spec — qui a changé quoi, quand et pourquoi.
Quand l'utiliser : Lors de l'investigation de pourquoi une spec a changé, pendant des audits, ou lors de la résolution de litiges sur les specs.
Prompt: "Show history for spec SPEC-003 in project proj_abc123"reconcile_spec Pro
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: "Reconcile spec SPEC-004 with the implementation changes in project proj_abc123"branch_spec Pro
Créer une branche de spec pour l'expérimentation — vous permet d'explorer un changement majeur de spec sans toucher la spec principale.
Quand l'utiliser : Lorsque vous souhaitez prototyper une approche alternative à une spec (architecture différente, périmètre différent) avant de vous y engager.
Prompt: "Create a branch of spec SPEC-012 called 'microservices-approach' in project proj_abc123"merge_spec_branch Pro
Fusionner une branche de spec expérimentale dans la spec principale après validation.
Prompt: "Merge the 'microservices-approach' branch of spec SPEC-012 into main in project proj_abc123"version_spec Pro
Créer un snapshot de version tagué d'une spec — utile pour le suivi des jalons et les transmissions externes.
Quand l'utiliser : Avant une release majeure, avant de transmettre à une équipe externe, ou pour figer une baseline avant un grand refactor.
Prompt: "Create version v1.0 snapshot of spec SPEC-008 in project proj_abc123"spec_diff Pro
Comparer deux versions de spec et afficher un diff structuré de ce qui a changé.
Prompt: "Show the diff between v1.0 and v2.0 of spec SPEC-008 in project proj_abc123"export_spec Pro
Exporter une spec vers un format externe (spec-kit) pour la partager en dehors de Planu.
Prompt: "Export spec SPEC-010 to spec-kit format for project proj_abc123"Portes qualité
check_readiness Pro
É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: "Check if spec SPEC-006 is ready for implementation in project proj_abc123"challenge_spec Pro
Tester une spec sous pression en simulant des défaillances, un trafic élevé, des cas limites et des conditions adversariales.
Quand l'utiliser : Avant d'approuver une spec pour un système critique, ou après une révision majeure de spec.
Prompt: "Challenge spec SPEC-009 in project proj_abc123"red_team Pro
Revue adversariale — argumente contre la spec depuis les principes fondamentaux avant approbation.
Quand l'utiliser : Pour les specs à enjeux élevés (facturation, authentification, migration de données) où vous souhaitez une revue en avocat du diable avant de figer la conception.
Prompt: "Red team spec SPEC-011 in project proj_abc123"detect_contradictions Pro
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: "Detect contradictions in the specs for project 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."
Périmètre & Transmission
manage_scope Pro
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: "Add 'dark mode support' to the backlog for project proj_abc123 with priority high"
Prompt: "Show the current backlog for project proj_abc123"package_handoff Pro
Générer un paquet de transmission 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: "Package spec SPEC-009 for handoff in project proj_abc123"decompose_spec Pro
Décomposer automatiquement une spec en tâches d'agents indépendantes avec propriété de fichiers non chevauchante — prêtes à être exécutées en parallèle.
Quand l'utiliser : Pour les grandes specs qui peuvent être réparties entre plusieurs agents ou membres de l'équipe. L'outil impose une propriété exclusive des fichiers par tâche pour éviter les conflits.
Prompt: "Decompose spec SPEC-015 into parallel agent tasks in project proj_abc123"analyze_spec_dependencies Pro
Analyser le graphe de dépendances des specs : trouver le chemin critique, détecter les dépendances circulaires et calculer les vagues d'exécution.
Prompt: "Analyze spec dependencies for project proj_abc123"
Prompt: "What is the critical path to ship SPEC-020 in project proj_abc123?"Qualité & Couverture
generate_checklist Pro
Générer une checklist qualité pour une spec — couvre la préparation à l'implémentation, la couverture de tests, la documentation, la sécurité et les performances.
Prompt: "Generate a quality checklist for spec SPEC-002 in project proj_abc123"check_spec_accuracy Pro
Vérifier la précision d'une spec par rapport à la réalité de l'implémentation — vérifie que les critères d'acceptation, les références de fichiers et les détails techniques sont toujours corrects.
Quand l'utiliser : Après des changements significatifs du code, avant une release, ou lorsqu'une spec n'a pas été révisée depuis un moment.
Prompt: "Check accuracy of spec SPEC-005 for project proj_abc123"spec_coverage Pro
Analyser la couverture de specs dans le projet — identifie les zones de la base de code sans specs et les specs sans implémentation correspondante.
Quand l'utiliser : Lors de la planification de sprint, des revues trimestrielles, ou lors de l'intégration pour comprendre les lacunes de documentation.
Prompt: "Show spec coverage for project proj_abc123"spec_usage_report Pro
Générer un rapport d'observabilité des specs montrant quelles specs les agents utilisent activement, lesquelles sont obsolètes et lesquelles sont le plus souvent référencées.
Prompt: "Show spec usage report for project proj_abc123"semantic_search Pro
Rechercher dans la connaissance de votre projet (specs, patterns, décisions, connaissances apprises) par signification — pas seulement par correspondance de mots-clés.
Quand l'utiliser : Quand vous vous souvenez qu'une décision a été prise mais ne la trouvez pas par mot-clé, ou lors de la recherche de specs liées à un sujet dans un grand projet.
Prompt: "Search for anything related to rate limiting in project proj_abc123"
Prompt: "Find specs about user permissions in project proj_abc123"Templates
list_templates
Lister tous les templates de specs disponibles avec leurs descriptions et cas d'utilisation.
Prompt: "List available spec templates"apply_template Pro
Appliquer un template de spec pour créer rapidement des specs pour des patterns courants (CRUD, auth, intégration, etc.).
Quand l'utiliser : Lors de la création d'une spec qui suit un pattern bien connu et que vous souhaitez un point de départ avec des sections pré-remplies.
Prompt: "Apply the CRUD template for a users resource in project proj_abc123"Gestion du backlog
capture_idea
Capturer une idée légère ou une possibilité future sans créer une spec complète. Les idées vivent dans le backlog jusqu'à être promues ou rejetées.
Prompt: "Capture idea: add offline mode support to project proj_abc123"list_backlog
Lister toutes les idées capturées dans le backlog du projet.
Prompt: "Show backlog for project proj_abc123"promote_idea
Promouvoir une idée du backlog en spec complète, déclenchant le flux de création de spec normal.
Prompt: "Promote idea IDEA-003 to a spec in project proj_abc123"discard_idea
Marquer une idée du backlog comme rejetée avec une raison optionnelle.
Prompt: "Discard idea IDEA-005 in project proj_abc123 — not aligned with roadmap"Sessions & Leçons
session_checkpoint
Sauvegarder un point de contrôle de session avec le contexte actuel, la progression et les questions ouvertes — utile pour reprendre de longues sessions.
Prompt: "Save a session checkpoint for project proj_abc123"planu_status
Obtenir un snapshot compact de l'état actuel du projet Planu — spec active, état git, file d'attente et activité récente. Conçu pour tenir en ~150 tokens.
Prompt: "What's the current status of project proj_abc123?"log_lesson
Enregistrer une leçon apprise depuis une spec ou une expérience de projet — stockée comme connaissance de projet consultable.
Prompt: "Log lesson: always run detect_contradictions before sprint planning in project proj_abc123"list_lessons
Lister toutes les leçons apprises pour un projet.
Prompt: "Show lessons learned for project proj_abc123"Nettoyage
delete_spec
Supprimer une ou plusieurs specs d'un projet. Les specs supprimées sont déplacées vers la corbeille et peuvent être restaurées.
Prompt: "Delete spec SPEC-017 from project proj_abc123"delete_project
Supprimer toutes les données d'un projet. Cette action déplace toutes les données vers la corbeille avant la suppression permanente.
Prompt: "Delete project proj_abc123"delete_pattern
Supprimer un ou plusieurs patterns appris d'un projet.
Prompt: "Delete pattern PAT-002 from project proj_abc123"delete_decision
Supprimer une ou plusieurs décisions/ADR d'un projet.
Prompt: "Delete decision DEC-005 from project proj_abc123"manage_trash
Gérer la corbeille : lister les éléments supprimés, restaurer un élément spécifique ou purger définitivement la corbeille.
Prompt: "List trash for project proj_abc123"
Prompt: "Restore spec SPEC-017 from trash in project proj_abc123"
Prompt: "Purge trash for project proj_abc123"generate_spec_dashboard
Régénérer le dashboard planu/index.html — un aperçu HTML de toutes les specs, leurs statuts et les métriques clés du projet.
Prompt: "Regenerate the spec dashboard for project proj_abc123"Voir aussi
- Outils Analyse & Estimation (Flux C) — estimation, détection de patterns, validate, recommend_model
- Outils Conception & Planification (Flux D) — schémas, contrats UI, ADR, plans d'exécution
- Outils Plateforme & Opérations (Flux E–I) — stack, agents, git, gouvernance