Revue de code IA : six bugs réels d'agent et la checklist qui les attrape
Une revue de code IA ne cherche pas les mêmes erreurs qu'une revue classique. Le code produit par un agent compile, passe le lint et fait ce qu'on lui a demandé sur la page qu'on regarde ; ses défauts se logent dans ce qu'il n'a pas regardé : l'héritage du framework, la donnée qui arrive d'ailleurs, l'entrée qui vient du visiteur.
Ce site est construit avec un agent de code depuis juin 2026. Les bugs décrits ci-dessous sont dans son historique git, avec le commit qui les corrige, sauf un, encore ouvert, que je signale. J'en ai tiré la checklist que j'applique désormais avant chaque mise en production.
Ce qu'une revue de code IA vérifie en plus
Une revue de code IA vérifie trois choses qu'une revue humaine suppose acquises : que le code s'insère correctement dans les règles implicites du framework (héritage, fusion, valeurs par défaut), que les données externes sont lues comme elles arrivent vraiment (paginées, lentes, datées), et que chaque entrée fournie par un visiteur est traitée comme hostile jusqu'à preuve du contraire. Un agent écrit un code juste pour le fichier qu'il édite. Il voit rarement le fichier parent, la réponse réelle de l'API ou l'usage détourné d'un formulaire.
Les métadonnées héritées du layout Next.js
Premier symptôme, corrigé le 16 octobre : sur une partie des pages, la balise twitter:title affichait le titre de l'accueil. La cause est documentée par Next.js : les métadonnées des segments sont fusionnées de façon superficielle, et un objet imbriqué comme openGraph défini par une page remplace entièrement celui du layout, sans fusion champ par champ. Le layout racine fixait un titre Twitter ; les pages qui ne le redéfinissaient pas en héritaient. Le correctif retire ces champs du layout et fait partir chaque page d'un socle commun (openGraphBase()), ce qui a aussi rendu l'image Open Graph présente partout. Le fait que Next.js reprenne ensuite les valeurs Open Graph de la page pour Twitter, je l'ai constaté en local, pas lu dans la documentation.
Même mécanique, même jour, pour la balise canonical. Le layout déclarait des alternates : toute page sans canonique propre héritait de celle de l'accueil, y compris la page 404. Un agent produit ce bug parce qu'il écrit la page qu'on lui demande, correcte prise isolément, sans relire ce que le parent injecte.
La vérification qui l'attrape : après build, lire le <head> réel de plusieurs types de pages (accueil, article, outil, version anglaise, 404) et comparer og:title, twitter:title et canonical avec l'URL servie. Pas le code : le HTML rendu.
Notion comme source de données : pagination, cache, dates
Le 9 octobre, j'ai diagnostiqué un site dont l'accueil mettait entre 20 et 48 secondes à répondre quand Notion ralentissait, avec un 500 observé une nuit sur un article. Le diagnostic, consigné dans le plan de correction, tient en trois lignes : chaque module Notion appelait unstable_noStore(), ce qui rendait inopérant le revalidate = 3600 pourtant déclaré sur le sitemap et sur d'autres routes ; aucun délai maximum, le client pouvant attendre 60 secondes par appel ; aucune pagination, alors que l'API Notion renvoie au plus 100 lignes par requête. Le sitemap s'arrêtait donc à 100 articles alors que 134 étaient en ligne : 34 manquaient. Après correction (cache de cinq minutes, délai de cinq secondes par appel, pagination complète), il en listait bien 134.
Le second défaut lié à Notion est resté ouvert trois mois. Depuis juillet, le dateModified du JSON-LD des articles prenait la date de dernière édition de la page Notion. Un article rédigé puis programmé à une date future, et jamais retouché après sa publication, annonçait donc une modification antérieure à sa publication. Google définit dateModified comme la date de modification la plus récente : une date antérieure à la publication n'a pas de sens. Les articles vérifiés le 19 octobre n'étaient corrects que parce qu'ils avaient tous été retouchés depuis leur publication. Le correctif, appliqué le 20 octobre, prend la plus récente des deux dates, et un script de contrôle vérifie précisément le cas de l'article programmé jamais retouché. Pour le reste des données structurées, j'ai détaillé les enjeux dans mon article sur schema.org et les moteurs génératifs.
Pourquoi un agent produit ces bugs : il code contre l'exemple de la documentation, avec quelques lignes de test, jamais contre 134 lignes ou une API qui met 40 secondes. La vérification : compter les URL du sitemap face au nombre d'articles publiés, mesurer le temps de réponse à froid, et comparer les deux dates du JSON-LD sur chaque page publiée.
Entrées du visiteur : échappement HTML et SSRF
Les routes qui envoient un résultat d'outil par email partent de l'adresse du site vers une adresse saisie par le visiteur. Le 17 octobre, j'ai constaté que plusieurs d'entre elles inséraient tels quels dans le HTML des champs envoyés par le navigateur. Quelqu'un pouvait donc faire partir un message d'hameçonnage signé par mon domaine. Le correctif échappe toute la charge à l'entrée ; pour le vérificateur AI Act, le serveur recalcule même le résultat à partir des seules réponses. Surtout, un script appelle les vraies routes avec des charges <script>, <img onerror> et <a href>, et il échoue sur l'ancienne version du code.
Même famille côté serveur : quatre outils, dont le scan santé du site, allaient chercher une URL fournie par le visiteur sans filtrer les adresses privées ni l'adresse de métadonnées du cloud (169.254.169.254). La garde ajoutée le 11 septembre a été complétée le même jour pour revalider chaque redirection, puis étendue en octobre à l'outil RGAA, oublié la première fois. Le DNS rebinding pur reste hors périmètre, c'est écrit en commentaire dans le code ; l'OWASP rappelle qu'une validation suivie d'une seconde résolution DNS non contrôlée peut être contournée.
Un agent produit ces failles parce qu'il optimise le chemin nominal : le formulaire est rempli honnêtement, l'URL pointe vers un vrai site. Le harness qui encadre l'agent limite ce qu'il a le droit d'exécuter pendant qu'il code, pas ce que son code laissera passer une fois en production.
Ma checklist de revue de code IA avant mise en production
Voici les six contrôles, dans l'ordre où je les passe, avant de valider la preview :
- Lire le
<head>rendu de cinq types de pages et vérifier titre,twitter:title,og:imageet canonical. - Chercher ce que le layout injecte et que la page n'écrase pas.
- Comparer le volume réel de la source (articles publiés) au volume affiché (sitemap, listes).
- Mesurer le temps de réponse à froid et vérifier qu'un cache déclaré est réellement actif (en-têtes
cache-control). - Pour chaque champ envoyé par le navigateur, se demander où il finit (HTML, email, requête serveur) et exiger un test avec une charge hostile.
- Comparer les dates publiées et modifiées sur les pages en ligne.
Aucun de ces contrôles ne demande de relire chaque ligne. Ils déplacent la revue du code vers ce que le code produit, ce qui est précisément la différence que je décrivais entre vibe coding et ingénierie agentique : mesurer plutôt que croire. C'est aussi le sens de mon approche de l'intégration de l'IA dans les projets.
Sources : Next.js, generateMetadata : fusion des métadonnées ; Google Search Central, données structurées Article ; OWASP, prévention des SSRF
Pour aller plus loin : Harness IA : pourquoi il compte plus que le modèle, Schema.org et données structurées pour les moteurs génératifs
Questions fréquentes
Faut-il relire chaque ligne de code écrite par un agent IA ?
Non, pas pour un site de cette taille. Il faut relire ce que le code produit (HTML rendu, en-têtes, réponses des routes) et exiger un test qui échoue sur l'ancienne version pour chaque correctif de sécurité.
Un agent peut-il faire lui-même la revue de son code ?
Il peut l'assister, à condition de lui donner les contrôles précis à passer et le HTML réel à inspecter. Laissé à lui-même, il relit le fichier qu'il vient d'écrire, rarement le parent ni la donnée réelle.
Quel bug d'agent est le plus coûteux à découvrir tard ?
Ceux qui ne se voient pas à l'écran : une canonique héritée ou un sitemap tronqué dégradent l'indexation pendant des semaines sans aucune erreur visible. Une faille d'échappement, elle, engage la réputation du domaine dès le premier abus.
Découvre mes outils

À propos de l'auteur
Delivery Manager à Rennes. Je pilote des projets de transformation digitale, SEO/GEO et accessibilité RGAA pour des clients grands comptes. Ce blog est le reflet de ce que je rencontre sur le terrain.