Outils Conception & Planification (Flux D)

Les outils du flux D transforment les specs approuvées en artefacts d'implémentation concrets — schémas, contrats UI, décisions d'architecture, plans d'exécution, contrats d'événements et bien plus.

Référence rapide

Outil	Description	Disponibilité
`generate_adr`	Générer un Architecture Decision Record pour une décision technique significative	Inclus
`log_decision`	Enregistrer, lister, rechercher ou remplacer des décisions architecturales et de processus	Inclus
`design_schema`	Concevoir et valider des schémas de données pour votre application	Inclus
`define_ui_contract`	Définir et gérer les contrats de composants UI pour les flux de travail design-vers-code	Inclus
`event_contracts`	Définir et gérer les contrats d'architecture événementielle	Inclus
`generate_execution_plan`	Créer un plan d'exécution étape par étape pour implémenter une spec	Inclus
`generate_orchestration_script`	Générer un script pour orchestrer l'exécution multi-agents	Inclus
`recommend_model`	Recommander le meilleur niveau de modèle IA pour une tâche donnée	Inclus
`plan_team_distribution`	Planifier la distribution des specs approuvées dans une équipe d'agents Claude Code	Inclus
`generate_spec_from_design`	Générer une spec Planu depuis une description de design UI/UX	Inclus
`contribute_context`	Contribuer du contexte supplémentaire à une spec depuis des sources externes	Inclus
`request_context`	Demander du contexte ou de l'expertise supplémentaire depuis la base de connaissances	Inclus
`generate_proposal`	Générer une proposition de projet HTML autonome avec grille KPI et diagramme de Gantt	Inclus
`generate_docs_site`	Générer un site de documentation HTML statique depuis les specs du projet	Inclus
`data_governance`	Configurer des politiques de gouvernance des données et des règles de classification	Inclus
`legal_compliance_report`	Générer un rapport de conformité pour les exigences légales et réglementaires	Inclus
`federate_specs`	Lier une spec du projet actuel à une spec dans un autre dépôt local	Inclus
`federation_status`	Afficher tous les liens de fédération de specs inter-dépôts et leur santé	Inclus
`discover_registry`	Lire et valider un manifeste `.well-known/planu.json` depuis un chemin de fichier local	Inclus
`publish_registry`	Générer un manifeste `.well-known/planu.json` depuis les specs de votre projet	Inclus
`registry_publish`	Publier une spec dans le registre Planu	Inclus
`registry_login`	S'authentifier auprès du registre de specs Planu avec un token API	Inclus
`registry_logout`	Supprimer les credentials du registre stockés	Inclus
`registry_whoami`	Afficher l'utilisateur du registre actuellement authentifié	Inclus
`a2a_register`	Enregistrer Planu comme agent A2A (Agent-to-Agent)	Inclus
`a2a_delegate`	Déléguer une tâche liée à une spec à un autre endpoint d'agent A2A	Inclus

Décisions d'architecture

`generate_adr`

Générer un Architecture Decision Record (ADR) pour une décision technique significative.

Ce qu'il produit : Des documents ADR structurés couvrant le contexte de la décision, les options envisagées, la décision prise et les conséquences. Le format suit MADR (Markdown Architectural Decision Records).

Quand l'utiliser : Lorsqu'une spec implique un choix technologique significatif, un pattern architectural ou un compromis que les futurs développeurs doivent comprendre.

Prompt: "Generate ADRs for spec SPEC-004 in project proj_abc123"

Exemple de sortie :

markdown

# ADR-001: Use Redis for session storage

## Status: Accepted

## Context
The authentication spec requires session persistence across multiple server instances...

## Decision
Use Redis as the session store...

## Consequences
- Positive: Horizontal scaling without sticky sessions
- Negative: Adds Redis as a required infrastructure dependency

`log_decision`

Enregistrer, lister, rechercher ou remplacer des décisions architecturales et de processus dans le journal de décisions du projet.

Actions disponibles : log, list, search, supersede

Quand l'utiliser : Pour maintenir un enregistrement consultable des décisions prises pendant le projet — qui a décidé quoi, pourquoi et quand. Remplacer une décision précédente lorsque l'équipe change de direction.

Prompt: "Log a decision: we will use PostgreSQL instead of MongoDB for project proj_abc123"
Prompt: "List all decisions for project proj_abc123"
Prompt: "Supersede decision DEC-003 with the new approach in project proj_abc123"

`design_schema`

Concevoir et valider des schémas de données pour votre application.

Ce qu'il produit :

Définitions de tables avec colonnes, types et contraintes
Relations de clés primaires et étrangères
Suggestions d'index pour les performances de requêtes
Indications de migration
Schéma dans plusieurs dialectes (SQL, Prisma, SQLAlchemy, GORM, etc.)

Quand l'utiliser : Lorsqu'une spec implique de la persistance de données et que vous avez besoin d'un point de départ concret pour la couche base de données.

Prompt: "Design the database schema for spec SPEC-002 in project proj_abc123"

`define_ui_contract`

Définir et gérer les contrats de composants UI pour les flux de travail design-vers-code.

Ce qu'il produit :

Définitions d'interface de composants (props, événements, slots)
Diagramme de flux de données (quels composants possèdent quel état)
Approche de gestion d'état (locale, contexte, store)
Contrat API entre frontend et backend
Exigences d'accessibilité

Quand l'utiliser : Pour toute spec incluant un composant frontend, un formulaire ou une interaction utilisateur.

Prompt: "Define the UI contract for the login flow in spec SPEC-001 for project proj_abc123"

`event_contracts`

Définir et gérer les contrats d'architecture événementielle — générer des contrats d'événements JSON Schema pour la validation producteur/consommateur.

Ce qu'il produit :

Définitions JSON Schema pour chaque type d'événement
Contrat producteur (ce que l'émetteur garantit)
Contrat consommateur (ce que l'abonné attend)
Stratégie de versionnage
Notes de compatibilité ascendante

Quand l'utiliser : Pour toute spec impliquant des files de messages, des bus d'événements (Kafka, RabbitMQ, AWS SQS/SNS, NATS) ou des intégrations webhook.

Prompt: "Define event contracts for the order processing flow in spec SPEC-008 for project proj_abc123"

Exemple de sortie :

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "OrderPlaced",
  "version": "1.0.0",
  "type": "object",
  "required": ["orderId", "customerId", "items", "total", "placedAt"],
  "properties": {
    "orderId": { "type": "string", "format": "uuid" },
    "customerId": { "type": "string", "format": "uuid" },
    "items": { "type": "array", "items": { "$ref": "#/definitions/OrderItem" } },
    "total": { "type": "number", "minimum": 0 },
    "placedAt": { "type": "string", "format": "date-time" }
  }
}

Planification d'exécution

`generate_execution_plan`

Créer un plan d'exécution détaillé, étape par étape pour implémenter une spec — cycle RED/GREEN/VERIFY avec étapes parallélisables.

Ce qu'il produit :

markdown

## Phase 1: Foundation (parallel)
- [ ] Step 1a: Create database migration
- [ ] Step 1b: Define TypeScript interfaces
- [ ] Step 1c: Write failing tests (RED)

## Phase 2: Implementation (sequential)
- [ ] Step 2a: Implement repository layer (GREEN)
- [ ] Step 2b: Implement service layer

## Phase 3: Verification
- [ ] Step 3a: Run full test suite (VERIFY)
- [ ] Step 3b: Update spec status to review

Quand l'utiliser : Avant que l'implémentation commence. Le PLAN.md devient le contrat d'implémentation pour l'agent IA ou le développeur.

Prompt: "Generate an execution plan for spec SPEC-005 in project proj_abc123"

`generate_orchestration_script`

Générer un script pour orchestrer l'exécution multi-agents — crée un script d'automatisation parallèle à 3 couches en utilisant des worktrees et claude -p.

Ce qu'il produit : Un script shell qui :

Crée des worktrees git isolés par spec
Lance des workers claude -p en parallèle
Gère l'allocation des ressources en fonction du CPU et de la RAM disponibles
Surveille la santé des workers et gère les défaillances

Quand l'utiliser : Lorsque vous devez implémenter plusieurs specs indépendantes simultanément et souhaitez un maximum de parallélisme.

Prompt: "Generate an orchestration script for specs SPEC-010, SPEC-011, SPEC-012 in project proj_abc123"

`recommend_model`

Recommander le meilleur niveau de modèle IA (haiku, sonnet ou opus) pour une tâche donnée selon la complexité, le coût et les capacités requises.

Ce qu'il évalue :

Complexité de la tâche (génération de code simple vs. décisions d'architecture)
Contraintes de coût
Exigences de vitesse
Profondeur de raisonnement nécessaire

Quand l'utiliser : Lors du choix entre des modèles IA pour l'implémentation, la revue de code ou la génération de specs.

Prompt: "Recommend a model for implementing spec SPEC-005 in project proj_abc123"

`plan_team_distribution`

Planifier la distribution des specs approuvées dans une équipe d'agents Claude Code — assigne les specs aux agents selon les dépendances, la propriété des fichiers et les contraintes de parallélisme.

Ce qu'il produit :

Tableau d'assignation des agents (quel agent traite quelles specs)
Graphe de dépendances pour déterminer le séquençage
Carte de propriété des fichiers pour prévenir les conflits
Prompts de lancement d'agents prêts à l'emploi

Quand l'utiliser : Lors de l'implémentation de plusieurs specs en parallèle avec une équipe d'agents. Prévient les conflits de fichiers et le travail gâché.

TIP

Exécutez plan_team_distribution avant de lancer toute équipe d'agents. Il détecte les conflits de propriété de fichiers qui causeraient sinon des cauchemars de merge.

Prompt: "Plan team distribution for approved specs in project proj_abc123"

Conception depuis une entrée

`generate_spec_from_design`

Générer une spec Planu depuis une description de design UI/UX — convertit les wireframes, descriptions de maquettes ou notes de design en critères d'acceptation structurés.

Quand l'utiliser : Lorsqu'un designer transmet une description ou une image d'une UI et que vous devez la transformer en spec constructible avant l'implémentation.

Prompt: "Generate a spec from this design: a dashboard with a sidebar nav, main content area, and a collapsing filters panel, for project proj_abc123"

`contribute_context`

Contribuer du contexte supplémentaire à une spec depuis des sources externes ou une expertise de domaine — ajoute des connaissances structurées à une spec existante.

Quand l'utiliser : Lorsqu'un expert métier (juridique, sécurité, conformité) doit ajouter des contraintes à une spec que l'auteur original n'avait pas.

Prompt: "Contribute context to spec SPEC-003: GDPR requires data deletion within 30 days for project proj_abc123"

`request_context`

Demander du contexte ou de l'expertise supplémentaire depuis la base de connaissances — interroge les patterns appris, les décisions passées et les connaissances de domaine pertinentes pour une spec.

Quand l'utiliser : Avant d'écrire une spec dans un domaine inconnu pour extraire les contraintes et patterns pertinents des projets passés.

Prompt: "Request context for a payments integration spec in project proj_abc123"

Export & Documentation

`generate_proposal`

Générer une proposition de projet HTML autonome avec grille KPI, diagramme de Gantt, tableau de décomposition des specs, analyse des risques, résumé budgétaire et vue d'ensemble de l'architecture.

Ce qu'il produit : Un fichier HTML portable et autonome prêt à partager avec des clients ou parties prenantes — aucun serveur requis.

Quand l'utiliser : Lors de la présentation d'un plan de projet à des parties prenantes non techniques ou des clients potentiels.

Prompt: "Generate a project proposal for project proj_abc123"

`generate_docs_site`

Générer un site de documentation HTML statique depuis les specs du projet, le catalogue d'outils, les diagrammes d'architecture et les métriques.

Ce qu'il produit :

Un site HTML navigable couvrant toutes les specs, leurs statuts et critères d'acceptation
Diagrammes d'architecture dérivés du graphe de specs
Catalogue d'outils consultable
Exportable pour hébergement sur tout serveur statique

Quand l'utiliser : Lorsqu'un projet a besoin d'une documentation vivante qui reste synchronisée avec les specs.

Prompt: "Generate a documentation site for project proj_abc123"

Gouvernance & Conformité

`data_governance`

Configurer des politiques de gouvernance des données et des règles de classification des données pour le projet.

Ce qu'il produit :

Taxonomie de classification des données (publique, interne, confidentielle, restreinte)
Politiques de gouvernance par classe de données
Étiquetage au niveau des specs pour les exigences de traitement des données
Détection des violations dans les specs et le code futurs

Quand l'utiliser : Pour les projets traitant des données sensibles — santé, finance, juridique ou tout secteur réglementé.

Prompt: "Set up data governance for project proj_abc123 under HIPAA"

`legal_compliance_report`

Générer un rapport de conformité pour les exigences légales et réglementaires — mappe les specs et l'implémentation à des clauses spécifiques de réglementation.

Ce qu'il produit :

Rapport de couverture par réglementation (RGPD, HIPAA, SOC 2, PCI DSS, etc.)
Lacunes ouvertes nécessitant une remédiation
Liens de preuve vers les specs et événements du journal d'audit
Exportable pour revue juridique

Quand l'utiliser : Avant un audit de conformité ou lors de la préparation de packages de preuves pour une certification.

Prompt: "Generate a GDPR compliance report for project proj_abc123"

Fédération & Registre

La fédération vous permet de lier des specs entre dépôts. Le registre permet de publier et découvrir des specs pour les réutiliser entre équipes et organisations.

`federate_specs`

Lier une spec du projet actuel à une spec dans un autre dépôt local — crée un lien de dépendance inter-dépôts.

Quand l'utiliser : Dans les configurations monorepo ou multi-dépôts où la spec d'un projet dépend de la spec d'un autre projet.

Prompt: "Federate spec SPEC-005 in project proj_abc123 to spec SPEC-012 in project proj_xyz789"

`federation_status`

Afficher tous les liens de fédération de specs inter-dépôts et leur santé — vérifie que les specs liées existent toujours et sont synchronisées.

Prompt: "Show federation status for project proj_abc123"

`discover_registry`

Lire et valider un manifeste .well-known/planu.json depuis un chemin de fichier local — affiche quelles specs un projet expose pour la réutilisation.

Prompt: "Discover registry manifest at /workspace/shared-lib"

`publish_registry`

Générer un manifeste .well-known/planu.json depuis les specs de votre projet — rend vos specs découvrables par d'autres projets.

Prompt: "Publish registry manifest for project proj_abc123"

`registry_publish`

Publier une spec dans le registre Planu pour que d'autres équipes puissent la découvrir et la réutiliser.

Prompt: "Publish spec SPEC-007 to the Planu registry from project proj_abc123"

`registry_login`

S'authentifier auprès du registre de specs Planu avec un token API.

Prompt: "Log in to the Planu registry with my API token"

`registry_logout`

Supprimer les credentials du registre stockés sur la machine locale.

Prompt: "Log out of the Planu registry"

`registry_whoami`

Afficher l'utilisateur du registre actuellement authentifié.

Prompt: "Who am I logged in as in the Planu registry?"

Agent-to-Agent (A2A)

L'A2A permet à Planu de participer dans des écosystèmes multi-agents — en s'enregistrant comme agent capable et en déléguant des tâches à d'autres agents spécialisés.

`a2a_register`

Enregistrer Planu comme agent A2A (Agent-to-Agent) — publie les capacités de Planu vers un endpoint A2A pour que d'autres agents puissent le découvrir et lui déléguer des tâches.

Quand l'utiliser : Lors de l'intégration de Planu dans un pipeline multi-agents où d'autres orchestrateurs doivent connaître les capacités de Planu.

Prompt: "Register Planu as an A2A agent for project proj_abc123"

`a2a_delegate`

Déléguer une tâche liée à une spec à un autre endpoint d'agent A2A — envoie une requête de tâche structurée à un agent externe et reçoit le résultat.

Quand l'utiliser : Lorsqu'un autre agent spécialisé (ex. un agent de revue de code, un agent de déploiement) doit gérer une étape dans le flux de travail Planu.

Prompt: "Delegate the code review for spec SPEC-009 to the review agent at http://localhost:8080 in project proj_abc123"

Voir aussi

Outils Cycle de vie des specs (Flux B) — créer, mettre à jour et gérer les specs
Outils Analyse & Estimation (Flux C) — valider, auditer et apprendre depuis votre base de code
Outils Plateforme & Opérations (Flux E–I) — stack, agents, git, gouvernance

Outils Conception & Planification (Flux D) ​

Référence rapide ​

Décisions d'architecture ​

generate_adr ​

log_decision ​

design_schema ​

define_ui_contract ​

event_contracts ​

Planification d'exécution ​

generate_execution_plan ​

generate_orchestration_script ​

recommend_model ​

plan_team_distribution ​

Conception depuis une entrée ​

generate_spec_from_design ​

contribute_context ​

request_context ​

Export & Documentation ​

generate_proposal ​

generate_docs_site ​

Gouvernance & Conformité ​

data_governance ​

legal_compliance_report ​

Fédération & Registre ​

federate_specs ​

federation_status ​

discover_registry ​

publish_registry ​

registry_publish ​

registry_login ​

registry_logout ​

registry_whoami ​

Agent-to-Agent (A2A) ​

a2a_register ​

a2a_delegate ​

Voir aussi ​

Outils Conception & Planification (Flux D)

Référence rapide

Décisions d'architecture

`generate_adr`

`log_decision`

`design_schema`

`define_ui_contract`

`event_contracts`

Planification d'exécution

`generate_execution_plan`

`generate_orchestration_script`

`recommend_model`

`plan_team_distribution`

Conception depuis une entrée

`generate_spec_from_design`

`contribute_context`

`request_context`

Export & Documentation

`generate_proposal`

`generate_docs_site`

Gouvernance & Conformité

`data_governance`

`legal_compliance_report`

Fédération & Registre

`federate_specs`

`federation_status`

`discover_registry`

`publish_registry`

`registry_publish`

`registry_login`

`registry_logout`

`registry_whoami`

Agent-to-Agent (A2A)

`a2a_register`

`a2a_delegate`

Voir aussi