Monorepo : refactorisation multi-agents à coûts plafonnés
Mis à jour le
Refactorisez un package d'un monorepo avec Plan, Build, Review & Test, sous un budget d'espace de travail et un plafond par workflow, avec des tests limités au package modifié.
Dans un monorepo, les refactorisations dérapent de deux façons : le changement s'étale sur plusieurs packages, et la facture s'étale avec lui. Ce template oriente le workflow par défaut vers un seul package et plafonne les deux.
Quels agents interviennent
Plan, Build, Review & Test est le workflow par défaut :
- Plan, par l'Architect : les fichiers à modifier, l'ordre et les risques, comme les appelants qui dépendent du rythme actuel des nouvelles tentatives.
- Build, par le Builder : les modifications exactes, fichier par fichier.
- Review, par le Reviewer : les cas limites et les changements de comportement dans le diff écrit.
- Test, par le Tester : les cas qui prouvent que le comportement n'a pas bougé, vérifiés au regard de l'exécution de tests enregistrée.
Après Build, la passe de code écrit le diff et vos tests s'exécutent dessus. Review et Test viennent ensuite : ils lisent donc le changement et son résultat de test, pas un plan. La revue des constats par IA lit ensuite le diff. Les constats high ou critical ouverts et les tests en échec bloquent la pull request, et une personne autre que celle qui a lancé la session l'approuve, lorsque l'espace de travail compte un autre approbateur.
Limiter le périmètre à un package
Les agents lisent un instantané sélectionné du dépôt, pas l'arborescence entière, et un changement peut toucher au plus 25 fichiers. Nommez le package et sa frontière dans la tâche. Sur le projet, définissez la commande de test pour que l'étape verify (vérification) exécute la suite qui compte :
| Champ du projet | Exemple de valeur |
|---|---|
| Test command | pnpm --filter @acme/billing test |
| Default branch | main |
La commande s'exécute dans un bac à sable isolé, coupé du réseau une fois les dépendances installées, avec une limite de deux minutes par commande. Si elle ne peut pas s'exécuter, l'étape enregistre une étape ignorée avec son motif, jamais une réussite.
Plafonner la dépense
Sous Configure → Billing, choisissez Configure budget, enregistrez-le, puis choisissez Edit limits :
| Champ | Exemple de valeur |
|---|---|
| Period | Monthly |
| Soft limit (USD) | 150 |
| Hard limit (USD) | 200 |
| Per-workflow caps (USD) | Plan, Build, Review & Test: 40 |
La limite souple n'arrête pas les sessions : au-delà, le lancement d'une session affiche un avertissement avec les dépenses de la période, et le franchissement est enregistré. La limite stricte et le plafond par workflow arrêtent les sessions. Le plafond compte toutes les sessions de ce workflow sur la période, pas une seule session : dimensionnez-le donc pour les refactorisations que vous prévoyez ce mois-ci.
Découper les grosses refactorisations
Si le plan cite plus de 25 fichiers, fusionnez la première tranche, puis lancez une session de suivi pour le package suivant. Une session de suivi reçoit la tâche et le résumé de la session parente comme contexte. Le template de fonctionnalité full-stack couvre le cas inverse : une fonctionnalité qui traverse les couches.
Questions fréquentes
Que se passe-t-il quand le plafond est atteint en cours de session ?
Le budget est vérifié avant chaque appel au modèle. La session s'arrête avec « Stopped over budget » et affiche Blocked by budget.
Puis-je plafonner chaque agent séparément ?
Non. Les budgets s'appliquent par espace de travail et par workflow. La page de la session affiche le coût de chaque étape, ce qui vous permet de voir où est passé l'argent.
Voir aussi
- Maîtrise des coûts du codage par IA avec limites de dépenses strictes
- Maîtrise des coûts
- Projets
- Fonctionnalité full-stack : des exigences à la doc en une session
- Changement d'infra : revue des risques, production hors d'atteinte
- Version candidate : contrôle E2E, audit des dépendances et go/no-go
- Tous les templates