Le Grand Nettoyage : Comment nous avons sauvé notre Agent IA du Chaos Cognitif

📖 Sommaire

L’asphyxie d’un Agent IA : Le Diagnostic
L’intervention du Conseil des Sages
Les Actions Commando
Interview Exclusive des Sages
Benchmark : Avant / Après

L’histoire est classique. Vous configurez un agent IA (Gemini CLI), vous lui donnez accès à de multiples outils, vous installez des extensions “au cas où”, et vous le laissez tourner.

Puis, vient le bug. Une Pull Request est rejetée pour non-respect des règles fondamentales. L’agent semble lent, confus, sujet aux “hallucinations”. Il ne trouve plus ses instructions. Que s’est-il passé ?

Il s’est noyé dans son propre contexte.

L’asphyxie d’un Agent IA : Le Diagnostic

En fouillant dans le cœur du système, le constat était alarmant :

3 Go d’archives mortes s’étaient accumulées dans l’historique de l’extension Antigravity (cerveau et conversations).
12 Serveurs MCP actifs tournaient en simultané, créant un labyrinthe d’outils et de permissions.
Plus de 50 000 lignes de “skills” étaient chargées en mémoire. Le problème ? Des centaines de règles dédiées à Kotlin, Java, ou Rust polluaient un projet strictement basé sur Astro et Node.js.
Conséquence dramatique : la “Bible” du projet (AGENT_INSTRUCTIONS.md), garante des principes architecturaux, avait été noyée dans le bruit et perdue.

L’intervention du Conseil des Sages

Pour éviter d’opérer à l’aveugle, nous avons invoqué le Protocole “Conseil des Sages”. Le concept est simple : face à une décision architecturale ambiguë, nous ne demandons pas à une seule IA, mais à trois (sous la forme d’agents spécialisés : L’Architecte, le Pragmatiste et le Critique) de débattre et de valider un plan d’action.

Leur verdict a été sans appel : “Scorched-earth purge” (Purge de la terre brûlée).

Les Actions Commando

Guidé par le consensus des Sages, j’ai appliqué un traitement de choc :

Suppression de 3 Go de passif : Vidage pur et simple des dossiers brain_archive et conversations d’Antigravity.
Tri sélectif de 50+ Skills : Déplacement de tous les skills hors-stack vers une .gemini/skills_library/ inactive. Seuls les outils strictement utiles à l’écosystème JS/TS/Astro ont été conservés.
Réduction drastique des outils : De 12 serveurs MCP, nous sommes passés à 6 (GitHub, Google Jules, Context7, Conductor, Sequential Thinking, Fetch).
La résurrection de la Bible : Restauration manuelle de AGENT_INSTRUCTIONS.md à la racine, avec nos invariants gravés dans le marbre : “Zéro N+1 Query”, “Isolation Totale” et “Zéro Flash Blanc”.

Interview Exclusive des Sages

Pour comprendre la logique derrière cette intervention, nous avons demandé aux trois Sages de justifier leur verdict a posteriori.

L’Architecte (Focus sur la structure) :

“En architecture logicielle, le bruit est l’ennemi de la précision. En purgeant les 3 Go d’archives et les 50+ skills hors-sujet, nous avons drastiquement réduit l’empoisonnement du contexte. L’agent n’a plus à filtrer des règles Java pour écrire un composant Astro. Restreindre la surface MCP limite la paralysie décisionnelle de l’agent. Restaurer la ‘Bible’ réétablit nos frontières d’exécution.”

Le Pragmatiste (Focus sur l’opérationnel) :

“C’est une question de ROI (Retour sur Investissement). Charger 51k lignes de règles inutiles coûte des tokens, ralentit l’indexation et augmente le taux d’erreur. Les actions menées sont rentables immédiatement. La règle ‘Zéro N+1’ n’est pas de la philosophie, c’est une contrainte mesurable. Le système est de nouveau opérationnel.”

Le Critique (Focus sur les risques) :

“Je maintiens un avertissement : la purge était vitale, mais nous frôlons la sur-optimisation. En supprimant l’historique complet, nous avons effacé le contexte de certains vieux bugs. L’agent est aujourd’hui hyper-spécialisé, ce qui est bien, mais il faudra peut-être réactiver manuellement certaines compétences s’il fait face à des cas limites hors de sa nouvelle zone de confort.”

Benchmark : Avant / Après

Voici les métriques de santé de l’Agent IA suite à l’intervention :

Métrique	Avant la Purge (Chaos)	Après l’Intervention (Souveraineté)
Poids du ‘Cerveau’ IA	> 3.0 Go	< 300 Mo
Serveurs MCP Actifs	12	6
Volume de Skills chargés	~51 000 lignes (Multi-langages)	Uniquement stack Astro/Node
Règles Architecturales	Perdues / Noyées	Enforcées (`AGENT_INSTRUCTIONS.md`)
État Cognitif de l’Agent	”Context Poisoned”, Hallucinations	Clair, Strict, Aligné sur la Bible

Leçon apprise : Une IA n’est intelligente que si le contexte qu’on lui donne l’est aussi. Trop d’outils tuent l’outil.