Pourquoi l'agent IA produit du slop : l'ex-CTO de Sitidrive explique comment préparer son dépôt
Si l'agent produit du slop, ce n'est pas parce que le modèle est mauvais : il se comporte comme un nouvel arrivant qui oublie chaque matin la revue de code de la veille, alors que les conventions de l'équipe ne sont écrites nulle part dans le code. L'ex-directeur technique de Sitidrive conseille de créer un AGENTS.md d'environ deux cents lignes et de contrôler les règles avec des linters, des hooks et la CI. Le plus simple pour amorcer le fichier : reprendre les commentaires des pull requests de l'année écoulée. L'agent refait ainsi moins souvent les mêmes erreurs à chaque nouvelle session.
Traité par IA depuis Habr AI ; édité par Hamidun News
Les sceptiques du développement assisté par IA racontent généralement la même histoire. Ils ont essayé un outil : le code compile, il passe même les tests, mais il n'est pas écrit comme on le fait dans l'équipe, il copie les pires endroits du projet et s'effondre à la première modification. C'est ce qu'on appelle l'AI slop, littéralement de la « bouillie ». L'auteur de cette analyse a quitté il y a près d'un an son poste de directeur technique du service d'autopartage Sitidrive pour se consacrer au développement avec des agents. Selon lui, le coupable est le plus souvent non pas le modèle, mais un dépôt qui n'a pas été préparé pour l'agent.
L'agent, un nouvel arrivant qui découvre tout chaque matin
L'auteur commence par une histoire de 2019. Il dirigeait alors le développement de « Taxi VKontakte » sur VK Mini Apps, et l'équipe de deux personnes avait recruté un troisième développeur, solide, mais aux habitudes différentes. Aucune règle n'était écrite : une seule pull request de mille cinq cents lignes a donc reçu un record de cent commentaires. Dix pull requests plus tard, on pouvait compter les commentaires sur les doigts d'une main. Mais une partie des connaissances restait introuvable pour le nouveau. Certaines n'existaient que dans les têtes, et certaines approches avaient été abandonnées par l'équipe après des déconvenues, sans laisser de trace dans le dépôt.
Imaginez maintenant que ce développeur soit remis à zéro chaque matin. L'agent se comporte exactement ainsi. Le modèle n'a pas de mémoire : à chaque requête, on lui renvoie tout l'historique de la conversation, et lorsque le contexte est saturé, la conversation est compressée et les consignes du début de session se perdent. L'agent ne garde pas le projet entier en tête et ne voit que ce qu'il a trouvé lui-même.
L'auteur cite trois pièges typiques :
- Le projet compte cent modules : dix récents, bien écrits, et quatre-vingt-dix anciens, du legacy. L'agent ignore lesquels servent de référence et peut prendre pour exemple le tout premier, et le pire.
- Dans un projet Java, les tests d'intégration se lancent avec
mvn test -P integration. L'agent exécutera un simplemvn test, obtiendra « No tests to run » et BUILD SUCCESS, et en conclura que tout est au vert. - Dans l'équipe, les données tout juste écrites se lisent depuis le master, car la réplique peut avoir du retard. Un nouvel arrivant sera corrigé une fois, alors que l'agent répétera l'erreur à chaque session.
Les erreurs des agents sont désormais plus souvent sémantiques que syntaxiques. Le code compile et paraît correct, mais repose sur une hypothèse fausse : l'agent a mal compris la logique métier, n'a pas posé de question ou a oublié un cas limite. En revue, c'est plus difficile à repérer qu'un build en échec.
Consigner les connaissances et laisser l'agent voir le résultat
Première étape : un fichier AGENTS.md à la racine du dépôt. Claude Code, Codex et d'autres agents le lisent. L'auteur le compare à la feuille A4 remise à un nouvel arrivant le premier jour : il doit tenir en quelques centaines de lignes, pas en cinquante pages de wiki. On y trouve cinq choses : ce qu'est ce dépôt, où se trouve quoi, les commandes de build et de test, les conventions non écrites et le glossaire des termes de l'équipe. Il ne faut pas y paraphraser le code, sous peine d'avoir deux sources de vérité, alors que la seule vraie est le code qui tourne en production.
Pour rassembler rapidement les règles, on peut demander à l'agent d'extraire tous les commentaires de pull requests de l'année écoulée, puis ne garder dans la liste, à la main, que ce qui reste d'actualité. Si l'agent se trompe encore sur une tâche en plusieurs étapes, par exemple la création d'un feature flag, il faut un skill : une instruction que l'agent charge à la demande. Inutile de l'écrire de zéro : réalisez la tâche avec l'agent, puis demandez-lui, dans la même session, de décrire les étapes parcourues.
L'agent a aussi besoin d'un environnement où il voit le résultat de son travail. Si le projet est petit, il se déploie en local. Il vaut mieux formaliser l'enchaînement de commandes dans un script : l'agent lit le texte d'une instruction à sa façon à chaque fois, alors qu'un script s'exécute toujours de la même manière. Pour les gros projets, il faut un environnement de prévisualisation par pull request, que savent déployer Vercel, Netlify, GitLab Review Apps et Argo CD. L'agent récupère l'adresse de cet environnement, appelle les endpoints, consulte les données en base ou fait parcourir des cas de test au navigateur.
Vérifier par programme et restreindre les droits
Toute règle de l'AGENTS.md reste une simple demande : l'agent peut ne pas l'appliquer ou l'oublier après la compression du contexte. Tout ce qui peut être vérifié par un programme doit donc l'être :
- D'abord le test, ensuite le code. Sinon l'agent est tenté d'ajuster le test lui-même au code.
- Des linters avec des messages clairs. La règle sur le master et la réplique peut devenir une vérification qui interdit la lecture depuis la réplique juste après une écriture, avec un message d'erreur qui explique comment corriger.
- Des hooks. Claude Code peut lancer lui-même le linter après chaque modification.
- Une CI sans laquelle on ne peut pas fusionner. Les configurations de CI et les tests ne changent qu'avec l'accord des propriétaires listés dans CODEOWNERS, et l'ensemble des vérifications doit prendre 20 à 30 minutes, sinon elles absorberont le gain de vitesse.
La revue change elle aussi. Un développeur qui bouclait auparavant trois ou quatre tâches par semaine peut désormais en boucler trois ou quatre par jour, et tout lire ligne à ligne devient physiquement impossible. L'auteur propose ce schéma : un agent écrit le code, un autre le relit dans une session neuve, car l'auteur du code le vérifie avec le même contexte. L'humain se concentre sur les décisions difficiles à annuler : schéma de base de données, droits d'accès, sécurité, architecture. Pour ne pas les chercher dans un diff de 20 000 lignes, l'agent fait lui-même remonter les décisions clés dans la description de la pull request.
Côté sécurité, l'auteur rappelle que l'agent agit en votre nom et que la principale menace est le code malveillant, par exemple celui d'une bibliothèque compromise. Le plus sûr est que la machine de l'agent n'ait aucun accès à la production. Vient ensuite le bac à sable ou le conteneur, où l'on peut tout autoriser. L'option la plus faible reste la validation humaine, qui repose sur des hooks vérifiant chaque commande avant son exécution.
Pour commencer, interrogez l'agent sur la partie du projet que vous connaissez le mieux : où se trouve tel code. Observez les commandes de recherche qu'il a lancées et le nombre de tours qu'il a faits. Tout ce qu'il a cherché longtemps ou mal trouvé constituera les premières lignes de votre AGENTS.md. L'auteur a publié la version complète de son approche dans un livre gratuit sur l'Agentic SDLC, disponible sur GitHub. Il s'agit de l'expérience personnelle d'un praticien, non d'une étude mesurée : le texte ne donne aucun chiffre sur l'effet obtenu. Mais ces conseils sont vérifiables et ne coûtent rien à essayer.
- 21 nov. 2026Sakana AI crée un laboratoire appliqué pour modéliser les marchés et l'économie
- 21 nov. 2026Meta prépare Muse Charm, un tamagotchi IA à 300 $ avec un an de 5G Verizon
- 21 nov. 2026Dreamteam lève 53 M$ pour un CRM qui se remplit tout seul à partir des e-mails et des appels
- 21 nov. 202622 agents Claude ont cherché pendant six semaines des réponses sur les trous noirs — et ont résolu deux problèmes
Questions clés sur cet article
Que sait-on sur L'agent, un nouvel arrivant qui découvre tout chaque matin ?
L'auteur commence par une histoire de 2019. Il dirigeait alors le développement de « Taxi VKontakte » sur VK Mini Apps, et l'équipe de deux personnes avait recruté un troisième développeur, solide, mais aux habitudes différentes. Aucune règle n'était écrite : une seule pull request de mille cinq cents lignes a donc reçu un record de cent commentaires. Dix pull requests plus tard, on pouvait compter les commentaires sur les doigts d'une main. Mais une partie des connaissances restait introuvable pour le nouveau.
Que sait-on sur Consigner les connaissances et laisser l'agent voir le résultat ?
Première étape : un fichier AGENTS.md à la racine du dépôt. Claude Code, Codex et d'autres agents le lisent. L'auteur le compare à la feuille A4 remise à un nouvel arrivant le premier jour : il doit tenir en quelques centaines de lignes, pas en cinquante pages de wiki. On y trouve cinq choses : ce qu'est ce dépôt, où se trouve quoi, les commandes de build et de test, les conventions non écrites et le glossaire des termes de l'équipe.
Que sait-on sur Vérifier par programme et restreindre les droits ?
Toute règle de l'AGENTS.md reste une simple demande : l'agent peut ne pas l'appliquer ou l'oublier après la compression du contexte. Tout ce qui peut être vérifié par un programme doit donc l'être : D'abord le test, ensuite le code. Sinon l'agent est tenté d'ajuster le test lui-même au code. Des linters avec des messages clairs.
Test Frontier LLMs & Autonomous Agents in One Workspace
Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.
L'essentiel de l'IA — une fois par semaine
Sept actus qui ont vraiment compté, choisies à la main. Sans bruit ni communiqués.
C'est fait ! Vérifiez votre boîte mail pour la confirmation.