--- title: "L'hygiène des systèmes agentiques — ce qu'on apprend à ses dépens" description: "Parallélisme incontrôlé, mémoire qui résiste au pivot, manque de visibilité : les trois pièges des systèmes agentiques et comment les anticiper avant qu'ils coûtent cher." created: 2026-05-26T10:00:00+02:00 updated: 2026-05-17T21:00:00+02:00 tags: ["IA", "KittyClaw", "Tooling", "Coulisses"] image: /images/blog/hygiene-systemes-agentiques-cover.webp card: /images/blog/hygiene-systemes-agentiques-card.webp --- Les systèmes agentiques ont une propriété qu'on ne voit pas venir : ils s'emballent facilement, et les dégâts sont souvent invisibles jusqu'au moment où ils ne le sont plus. Après plusieurs mois à piloter des projets avec des agents autonomes en parallèle, j'ai identifié trois patterns récurrents. Aucun n'est évident a priori. Tous le deviennent a posteriori. ## Piège 1 — Le parallélisme incontrôlé La tentation est forte. Pendant qu'un agent traite une tâche, pourquoi ne pas en lancer une autre ? Et puis une autre. Les agents ne se fatiguent pas, ils n'attendent pas de réunion, ils travaillent sans friction apparente. Le problème se pose au moment de fusionner. Chaque agent modifie des fichiers, parfois les mêmes. Chaque worktree diverge du trunk à sa propre vitesse. Quand vient le moment d'intégrer tout ça sur master, les conflits s'accumulent. Certains changements se contredisent : un agent a restructuré quelque chose que l'autre supposait intact. J'ai testé deux approches avec KittyClaw : tous les développements directement sur main, ou un worktree par ticket. Aucune n'est parfaite. La première crée des interférences en temps réel. La seconde déplace le problème au moment du merge. La leçon : sur un même projet, il ne faut pas aller trop vite. Laisser le temps à chaque développement d'être évalué par l'usage avant d'en lancer d'autres. Quand le projet a trop divergé, le reprendre en main coûte plus cher que de repartir d'une base saine. ![Architecture des systèmes agentiques sains](/images/blog/hygiene-systemes-agentiques-diagram.webp) ## Piège 2 — La mémoire qui résiste au pivot Les systèmes multi-agents avec mémoire persistante ont un avantage notable : les agents apprennent et s'améliorent au fil des runs. Ils ont aussi un inconvénient symétrique : ils résistent au changement. Quand un processus est bien ancré dans les fichiers de skill et de mémoire, le modifier ne suffit pas. L'ancien comportement continue à affleurer. L'agent lit les nouvelles instructions mais aussi les anciennes mémoires, et se retrouve avec deux modèles contradictoires. Parfois il choisit le mauvais. Parfois il tente de les concilier et produit quelque chose d'incohérent. La conséquence concrète : des conventions mixtes dans le code, des scripts dont on ne sait plus s'ils sont encore actifs, des comportements régressifs après chaque mise à jour de process. L'entropie s'accumule discrètement. La solution est de traiter les fichiers de mémoire et de skill avec la même rigueur que le code source. Supprimer activement ce qui est obsolète. Ne pas accumuler. Versionner les changements de process clairement, avec une date et une explication, pour que les agents comprennent que l'ancien chemin est fermé. ## Piège 3 — Piloter à l'aveugle Le coût cognitif du multi-projet est réel — mais il est aggravé par un problème d'instrumentation. Une IA produit plus vite qu'un humain ne peut suivre. Quand plusieurs agents travaillent en parallèle sur plusieurs projets, l'état réel du système devient opaque très vite : qu'est-ce qui est en cours exactement ? Qu'est-ce qui est bloqué en attente d'une décision ? Quelles sont les branches ouvertes qui n'ont pas encore été reviewées ? Sans réponse claire à ces questions, la supervision devient réactive plutôt que proactive — on détecte les problèmes quand ils deviennent trop coûteux à ignorer. La solution n'est pas de ralentir les agents. Elle est de se doter d'instruments de navigation. Des **tableaux de bord** qui donnent l'état agrégé de chaque projet : tickets en cours, tickets bloqués, tickets en review, taux d'avancement sur la semaine. Une **roadmap** qui fixe les priorités et empêche les agents de diverger vers des sujets non planifiés. Des **métriques** qui signalent les anomalies : un ticket qui reste trop longtemps en cours, un projet qui n'avance plus, une accumulation de blocages sur un même type de tâche. [KittyClaw](https://kittyclaw.dev) fournit cette visibilité nativement : board par projet, vue d'ensemble multi-projet, traçabilité complète de chaque action d'agent. La différence entre piloter avec ces instruments et piloter sans est la même que celle entre un tableau de bord de vol et une navigation à vue. ## Ce que ça change dans la pratique Ces trois pièges ont une structure commune : ils apparaissent quand le système agentique évolue plus vite que l'infrastructure qui le gouverne. Le parallélisme sans coordination, la mémoire sans nettoyage, la production sans visibilité — c'est le même problème sous trois formes différentes. L'hygiène dans les systèmes agentiques, c'est définir tôt les règles et les instruments qui maintiennent le système sous contrôle. Pas après que les dégâts sont visibles — avant que la vitesse des agents dépasse la capacité humaine de supervision.