Arquitetura de Malha para Agentes de IA: Isolamento de Cliente e Coordenação entre Projetos

Arquitetura em Malha vs. Hub-and-Spoke

O autor contrasta sua abordagem em malha com o modelo hub-and-spoke popularizado por configurações como a PAI de Daniel Miessler. No hub-and-spoke, um assistente central com memória compartilhada gerencia todos os fluxos de trabalho, o que troca profundidade por amplitude. A arquitetura em malha cria agentes especialistas em domínio para cada projeto do cliente, com cada agente carregando contexto profundo do projeto sem competir por espaço de memória.

Detalhes de Implementação do Sistema

O sistema usa arquivos markdown simples e convenções de nomenclatura para coordenação:

• STATE.md para memória de trabalho
• CLAUDE.md e AGENTS.md para instruções dos agentes
• Memorandos estruturados para comunicação entre projetos
• Git para controle de versão por baixo de tudo

Não há banco de dados, plataforma ou dependências além de ferramentas CLI. Cada projeto é seu próprio nó com seus próprios arquivos de estado e instruções, garantindo que o contexto do Cliente A fique isolado da sessão do Cliente B.

Comunicação entre Agentes

Os agentes se coordenam deixando memorandos estruturados (arquivos markdown simples) nos diretórios de entrada uns dos outros, semelhante a e-mails passando entre membros da equipe. Exemplos incluem:

• Um agente de conteúdo finalizando um rascunho que o agente desenvolvedor pega na próxima sessão
• Um agente de sysadmin encontrando um bug e enviando para o agente de desenvolvimento web
• Mudanças de infraestrutura afetando sites
• Decisões de conteúdo dependendo de entrada de gerenciamento de projetos
• Especificações de requisitos desencadeando trabalho de desenvolvimento

Para projetos que precisam de verdadeiro isolamento, onde o acesso SSH derrotaria o propósito, o sistema de memorandos se estende ao e-mail para que não haja acesso direto entre ambientes.

Abordagem Agnóstica de Ferramentas

O autor usa Claude Code, Codex, Gemini CLI e DeepAgent em diferentes projetos. Como as convenções são apenas arquivos, não há um limite perceptível entre fornecedores — um agente Claude pode enviar um memorando que um agente Codex pega. Trocar fornecedores para atender às necessidades do projeto é uma parte padrão do fluxo de trabalho.

Resultados Práticos

Este sistema tem sido executado em trabalho real de clientes por cerca de um ano, lidando com 44 projetos em 14 organizações. O autor anteriormente carregava toda a coordenação entre agentes, mas agora apenas revisa o trabalho em vez de passá-lo adiante.