AI CodeOps

Spécifier une fonctionnalité : exigences et livraison par phases

Mis à jour le

Transformez une demande d'une ligne en critères d'acceptation et en plan par phases avec Discovery & Spec : un Researcher, un Product Analyst et un Project Planner.

Utiliser ce template

Commencez ici lorsqu'une fonctionnalité n'est encore qu'une phrase dans un ticket. Discovery & Spec la transforme en exigences que l'on peut vérifier et en un plan que l'on peut inscrire au calendrier, avant qu'aucun code applicatif ne soit écrit.

Quels agents interviennent

  1. Prior art. Le Researcher passe en revue le code, les bibliothèques et les références qui concernent la fonctionnalité. Pour un export de factures, cela signifie l'endroit où les factures sont interrogées aujourd'hui et les sérialiseurs que le service utilise déjà.
  2. Requirements. Le Product Analyst rédige les exigences avec des critères d'acceptation et des limites de périmètre.
  3. Delivery plan. Le Project Planner découpe le travail en phases, avec les dépendances, les jalons et les estimations d'effort.

Chaque étape lit ce que les précédentes ont écrit.

Ce que vous obtenez

  • Un ADR proposé. Les exigences retenues sont enregistrées sous Plan → ADRs à l'état proposed, pour qu'une personne les accepte ou les rejette.
  • Des éléments sur le tableau Plan. Les éléments de liste de l'étape Delivery plan deviennent des entrées du tableau, chacune liée à la session qui l'a proposée.
  • Aucun changement de code. Discovery & Spec écrit uniquement des documents : la session se termine donc sans diff ni approbation pour en appliquer un. Pour conserver la spécification dans le dépôt, lancez une session Plan, Build, Review & Test qui la demande sous forme de fichier dans docs/specs/. Ce changement passe par votre commande de test, la revue des constats par IA et une approbation humaine comme tout autre, si bien que la spécification est discutée dans une pull request, là où l'équipe commente déjà.

Donnez aux agents les faits qu'ils ne peuvent pas déduire du code : qui sont les utilisateurs, les volumes attendus et ce qui est explicitement hors périmètre.

Laisser les agents lire les tickets, pas les écrire

Si votre gestionnaire de tickets est connecté comme serveur MCP distant nommé « Tracker » (ID tracker), ces règles de politique tiennent ses outils d'écriture à l'écart de toutes les sessions, tandis que ses outils de lecture restent disponibles :

[
  { "id": "tracker-no-create", "action": "mcp.invoke", "resource": "tracker/create_*", "decision": "deny" },
  { "id": "tracker-no-update", "action": "mcp.invoke", "resource": "tracker/update_*", "decision": "deny" }
]

Les règles mcp.invoke acceptent allow ou deny, jamais ask, et un outil refusé n'est jamais proposé aux agents. Les noms d'outils dépendent du serveur que vous connectez : adaptez donc les motifs à ses vrais noms d'outils. Essayez d'abord les règles en mode log-only pour voir ce qu'elles bloqueraient.

Et ensuite

Acceptez ou rejetez l'ADR, triez les éléments du tableau, puis développez la première phase avec le template de fonctionnalité full-stack ou avec une session Plan, Build, Review & Test plus restreinte par phase.

Questions fréquentes

Le plan arrive-t-il sur le tableau Plan ?

Oui. Lorsque la session se termine, les éléments de liste de l'étape Delivery plan deviennent des entrées du tableau Plan, jusqu'à 50 à la fois, en ignorant les titres déjà présents sur le tableau.

Le Researcher peut-il lire notre gestionnaire de tickets ?

Uniquement par l'intermédiaire d'un serveur MCP distant que vous connectez, et uniquement avec les outils que la politique de votre espace de travail laisse passer.