Découper un epic en tâches de taille agent · Ingénierie agentique : la formation pratique

Transformez une grosse fonctionnalité en fines tranches verticales, chacune avec son brief et sa vérification, dans un ordre qui permet d’apprendre et de livrer en continu.

La leçon 3.1 disait de découper les tâches trop grosses. Celle-ci explique comment. Mal découper, c’est facile : on se retrouve avec des morceaux impossibles à tester seuls, ou qui ne fonctionnent qu’une fois tous terminés.

Le savoir-faire, c’est de trancher un epic en morceaux qui livrent chacun quelque chose de fonctionnel, et de consigner le découpage là où chaque session peut le retrouver.

Trancher à la verticale, pas par couche

Les couches horizontales ne se testent qu’une fois toutes en place. Les tranches verticales traversent chaque couche et se vérifient seules.

La première tranche est un squelette fonctionnel : le chemin le plus mince qui marche de bout en bout, même s’il est laid. Il fait sortir les surprises tôt, et chaque tranche suivante s’appuie sur quelque chose qui roule déjà.

Le découpage, étape par étape

1
Écrire le résultat de l’epic
Un paragraphe : qui obtient quoi, et comment vous saurez que c’est terminé. C’est à vous de l’écrire, pas à l’agent.
2
Laisser l’agent proposer le découpage
En lecture seule. Demandez-lui d’explorer le code et de proposer des tranches. Il est bon pour repérer les fichiers et dépendances en jeu.
3
Tailler et remodeler
Fusionnez les tranches impossibles à tester seules, découpez celles qui échouent aux questions de dimensionnement de la leçon 3.1.
4
Ordonner par dépendance et par risque
Le squelette d’abord, puis les inconnues les plus risquées, puis le reste. Indiquez quelles tranches ne dépendent pas l’une de l’autre.
5
Le sauvegarder dans le repo
Un fichier avec les tranches, chacune avec ses critères d’acceptation et un statut. Chaque session le lit et le met à jour.

Voici le prompt que j’utilise pour la proposition. Le résultat va dans un fichier, pas seulement dans le chat, pour survivre aux redémarrages (module 2).

Epic : [un paragraphe décrivant le résultat]

Explore le code. Ne modifie rien sauf le fichier de plan.
Écris docs/plans/csv-export.md avec :

- Tranches : chacune un changement vertical mince qui fonctionne et
  peut être testé seul. Commence par la version bout en bout la plus mince.
- Pour chaque tranche : objectif en une phrase, fichiers probablement
  touchés, 2 à 4 critères d'acceptation, dépend de (numéros ou aucune)
- Risques et inconnues : ce qui pourrait changer le plan
- Statut : une case à cocher par tranche

Vise des tranches qu'un réviseur peut vérifier d'un seul trait.

À vous de jouer : bonne tranche ou pas?

🎮 Jugez la tranche

1 / 7 · Pointage: 0

Chaque carte est une tranche proposée dans le découpage d’un epic. On la garde, ou on la renvoie pour retravailler?

Avant de continuer

✅ À retenir

0 / 4 complété

Je découpe les epics en tranches verticales qui fonctionnent et se testent seules.
Ma première tranche est un squelette fonctionnel : le chemin bout en bout le plus mince.
Je laisse l’agent proposer le découpage, mais j’écris le résultat visé et je remodèle les tranches.
Le découpage vit dans un fichier de plan dans le repo, avec critères et statut pour chaque tranche.