La revue de code IA consiste à faire relire par un second modèle le code qu’un agent a écrit, et à lui faire signaler les problèmes. Le piège avec les agents, c’est la vitesse : un agent modifie des dizaines de fichiers en un tour, et tout relire ligne par ligne vous fait perdre le temps que l’agent vous a fait gagner. Une étape de revue comble cet écart : la sortie de l’agent passe sous un second regard avant que vous ne la regardiez.
Cet article explique comment faire relire la sortie des agents, comment pondérer les constats et comment garder la boucle de revue sous contrôle.
Pourquoi relire séparément la sortie de l’agent ?
L’agent qui a écrit le code est aveugle à ses propres hypothèses. Quand un agent déclare une modification « terminée », il rate souvent :
- Un rollback ou un nettoyage manquant sur les chemins d’erreur
- Des cas limites : entrée vide, requêtes concurrentes, délais dépassés
- La sécurité : jetons réutilisables, entrées non validées
- Des imports inutilisés, du code mort, un nommage incohérent
Un second modèle qui lit le même code avec un contexte neuf, en ne regardant que le diff, les remarque plus facilement.
Ce que regarde une bonne revue de code IA
Les constats ne servent que si vous pouvez agir dessus. Un bon constat comporte :
| Élément | Exemple |
|---|---|
| Gravité | Haute, moyenne, basse |
| Emplacement | src/auth/session.ts:88 |
| Problème | « Un nouveau jeton est émis avant que l’ancien ne soit révoqué. » |
| Pourquoi c’est important | « La réutilisation de jeton n’est pas détectée. » |
La gravité fixe la priorité. L’emplacement vous mène droit à la ligne. Les commentaires vagues du type « améliore le code » ne servent à rien.
Quand relire
Trois approches :
- Automatiquement après chaque tour. La revue démarre dès que l’agent termine son tour, donc les problèmes sont attrapés tant que l’agent a encore le contexte.
- Avant la fusion. Relisez tout le diff avant que la branche n’entre dans la branche principale.
- À la demande. Relisez un commit ou l’arbre de travail dont vous n’êtes pas sûr.
Avec des agents, la première approche fait gagner le plus de temps, car les problèmes apparaissent avant de se propager au tour suivant.
La revue de code automatique dans AgentVera
La revue de code d’AgentVera s’active dans les réglages du projet et apparaît dans l’onglet Reviews du panneau de droite :
- Activez la revue automatique dans les réglages du projet et choisissez un modèle Claude.
- Choisissez ce qui est relu : les commits du tour, ou toutes les modifications.
- Choisissez si les constats retournent à l’agent.
- Quand l’agent termine son tour, la revue s’exécute ; les constats sont listés avec leur gravité et des liens fichier:ligne.
Vous pouvez aussi relire à la main l’arbre de travail, les changements indexés ou un seul commit.
Borner la boucle de retour
Renvoyer automatiquement les constats à l’agent est tentant, mais une boucle sans fin est risquée : l’agent corrige un problème et en introduit un autre, la revue le trouve, et ainsi de suite. C’est pourquoi AgentVera limite le retour à deux tours de suite au maximum. Ensuite, la décision vous revient.
Comment pondérer les constats
Vous n’avez pas à accepter tous les constats. Un ordre pratique :
- Haute : risques de sécurité et de perte de données. À corriger avant de fusionner.
- Moyenne : chemins d’erreur, tests manquants. Souvent peu coûteux à corriger dans le même tour.
- Basse : style, imports inutilisés. À nettoyer en lot ou avec des outils automatiques.
N’hésitez pas à rejeter les faux positifs. Le modèle relecteur peut aussi se tromper ; c’est vous qui connaissez le mieux le contexte.
Combiner la revue avec d’autres filets de sécurité
La revue seule ne suffit pas. Elle est plus solide avec :
- Des tests : la revue attrape les erreurs de logique, les tests attrapent les erreurs de comportement.
- Les tours : si une revue montre qu’un tour est parti dans la mauvaise direction, annulez-le avec les tours.
- Des notifications : soyez prévenu sur Telegram quand un constat important apparaît.
- Des flows : ajoutez un agent de revue ou de test après l’agent builder.
Un exemple de rapport de revue
En un tour, l’agent a ajouté un flux de refresh token et fait trois commits. À la fin du tour, la revue produit :
| Gravité | Constat | Emplacement |
|---|---|---|
| Haute | La réutilisation du refresh token n’est pas détectée ; un nouveau jeton est émis avant que l’ancien ne soit révoqué. | src/auth/session.ts:88 |
| Moyenne | La transaction de base de données n’est pas annulée sur le chemin d’erreur. | src/auth/store.ts:41 |
| Basse | Import inutilisé. | src/auth/index.ts:3 |
Que faire de cela ?
- Envoyez le constat de gravité haute à l’agent. C’est un problème de sécurité et l’agent a encore le contexte : la correction est peu coûteuse.
- Ajoutez le constat moyen au même tour. Le comportement du chemin d’erreur demande un test ; demandez à l’agent d’en écrire un.
- Groupez le constat bas. Un linter ou le prochain passage de nettoyage s’en chargera.
Une fois les corrections faites par l’agent, la revue s’exécute à nouveau. S’il reste des constats ouverts après le deuxième tour, la boucle automatique s’arrête et la décision vous revient.
Choisir un modèle et un périmètre pour la revue
La revue a aussi un coût. Relire chaque tour avec le modèle le plus puissant peut revenir cher. Une approche pratique :
- Pour les tours ordinaires, choisissez un modèle Claude plus rapide et moins cher.
- Avant la fusion, envisagez de relire tout le diff à la main avec un modèle plus puissant.
- Limiter le périmètre aux commits du tour garde le diff relu petit ; relire toutes les modifications attrape aussi le travail non commité.
Réinjecter la revue dans le rôle de l’agent
Si vous voyez toujours les mêmes schémas dans les constats, déplacez-les dans le rôle de l’agent. Si la revue signale sans cesse des tests de chemin d’erreur manquants, ajoutez une ligne comme celle-ci :
For every new function, write at least one error-path test next to the happy-path test.Le même problème cesse alors de réapparaître à chaque tour ; l’agent le prévient en amont. Avec le temps, les rapports raccourcissent et les constats qui comptent ressortent.
Lire les revues en parallèle de l’historique aide aussi. La recherche de conversations d’AgentVera lance une recherche plein texte dans toutes les conversations Claude et Codex : vous retrouvez la session où un problème a déjà été discuté et la reprenez dans un nouvel agent.
Checklist
- La revue automatique est-elle activée dans les réglages du projet ?
- Le périmètre de revue (commits du tour ou toutes les modifications) convient-il à votre travail ?
- Les constats de gravité haute ont-ils été clos avant la fusion ?
- La boucle de retour est-elle bornée ?
- Les tests ont-ils été lancés indépendamment de la revue ?
Pour conclure
La revue de code IA vous permet de profiter de la vitesse des agents sans sacrifier la qualité. Un second modèle qui relit le code après chaque tour attrape les problèmes tant que l’agent a encore le contexte, et des constats avec gravité et emplacement vous disent où regarder en premier.
Dans AgentVera, vous activez la revue projet par projet et renvoyez les constats à l’agent en un clic. Utilisez-la avec les étapes de fusion de git worktrees pour agents en parallèle, ou démarrez avec l’offre gratuite.