Nous avons rencontré un problème où les documents d’analyse et les rapports produits par des agents IA étaient si verbeux et truffés de jargon que l’équipe ne les lisait pas (« AI verbosity/slop »). Ce n’était visiblement pas un cas isolé.
Nous avons rencontré un problème où les documents d’analyse et les rapports produits par des agents IA étaient si verbeux et truffés de jargon que l’équipe ne les lisait pas (« AI verbosity/slop »). Ce n’était visiblement pas un cas isolé.
Le goulot d’étranglement n’était pas la profondeur du contenu, mais sa lisibilité ; j’ai donc formalisé en compétence d’agent les 10 règles que j’appliquais systématiquement :
- Mettre la conclusion (l’essentiel) dès la première phrase
- Commencer les concepts clés par une analogie
- Expliciter ou supprimer le jargon, et exprimer les formules en mots
- Déplacer les preuves du type file:line hors du corps du texte, en notes de bas de page
- Divulgation progressive : replié = résumé, déplié = détails
- …10 règles au total + checklist + garde-fous « ne pas utiliser dans ces cas »
C’est conçu pour Claude Code, mais les règles elles-mêmes s’appliquent indépendamment du framework ou du langage.
Comment gérez-vous ce problème ? Vous le demandez à chaque fois dans le prompt, ou vous l’inscrivez plutôt dans un fichier de compétences/règles ?
Aucun commentaire pour le moment.