Architecture en maillage pour agents IA : isolation des clients et coordination inter-projets

Architecture en maillage vs. en étoile

L'auteur oppose son approche en maillage au modèle en étoile popularisé par des configurations comme celle de Daniel Miessler, le PAI. Dans le modèle en étoile, un assistant central avec une mémoire partagée gère tous les flux de travail, ce qui sacrifie la profondeur pour la largeur. L'architecture en maillage crée des agents spécialisés par domaine pour chaque projet client, chaque agent portant un contexte projet approfondi sans concurrence pour l'espace mémoire.

Détails de mise en œuvre du système

Le système utilise des fichiers markdown simples et des conventions de nommage pour la coordination :

• STATE.md pour la mémoire de travail
• CLAUDE.md et AGENTS.md pour les instructions des agents
• Des mémos structurés pour la communication inter-projets
• Git pour le contrôle de version sous-jacent

Il n'y a pas de base de données, pas de plateforme et aucune dépendance au-delà des outils en ligne de commande. Chaque projet est son propre nœud avec ses propres fichiers d'état et d'instructions, garantissant que le contexte du Client A est isolé de la session du Client B.

Communication inter-agents

Les agents se coordonnent en déposant des mémos structurés (fichiers markdown simples) dans les répertoires entrants des autres, similaires à des e-mails échangés entre membres d'équipe. Exemples :

• Un agent contenu terminant un brouillon que l'agent développeur reprend la session suivante
• Un agent administrateur système trouvant un bug et l'envoyant à l'agent développeur web
• Des changements d'infrastructure affectant des sites web
• Des décisions de contenu dépendant d'informations de gestion de projet
• Des spécifications de besoins déclenchant un travail de développement

Pour les projets nécessitant une véritable isolation où un accès SSH irait à l'encontre de l'objectif, le système de mémos s'étend à l'e-mail pour qu'il n'y ait pas d'accès direct entre les environnements.

Approche agnostique des outils

L'auteur utilise Claude Code, Codex, Gemini CLI et DeepAgent sur différents projets. Comme les conventions ne sont que des fichiers, il n'y a pas de frontière notable entre fournisseurs – un agent Claude peut envoyer un mémo qu'un agent Codex récupère. Changer de fournisseur pour répondre aux besoins du projet fait partie intégrante du flux de travail.

Résultats pratiques

Ce système fonctionne sur du travail client réel depuis environ un an, gérant 44 projets pour 14 organisations. L'auteur gérait auparavant toute la coordination entre agents mais ne fait maintenant que revoir le travail au lieu de le transmettre.