Foreman em Detalhes: Entenda o Mapa de Runtime e a Arquitetura Essencial

O Foreman se apresenta como um 'eve agent', uma entidade central que coordena cinco subagentes, três canais de entrada e dois armazenamentos duráveis. A arquitetura de suas capacidades é única: tudo que o Foreman pode fazer é declarado como um arquivo na pasta agent/. Por exemplo, agent/tools/read_factory_brain.ts vira a ferramenta read_factory_brain. O sistema descobre as funcionalidades direto do sistema de arquivos durante a construção, onde a identidade de um componente vem do seu caminho no disco, não de um campo de nome.

Três decisões estruturais moldam o comportamento do Foreman. Primeiro, cada subagente declarado roda em uma sessão filho isolada, sem acesso direto às instruções ou contexto do agente raiz. Isso significa que o orquestrador precisa empacotar todas as informações necessárias na mensagem de delegação. Segundo, a confiança é estabelecida na expedição. Um webhook assinado define quem é o chamador antes mesmo de o modelo ler o conteúdo, com a validação concentrada em agent/lib/trust.ts. Terceiro, cada subagente trabalha em seu próprio sandbox. Subagentes como Analyst, Implementer e Reviewer têm seu próprio Vercel Sandbox com um clone do FACTORY_REPO, enquanto Classifier e Researcher operam em ambientes mais simples, com um /workspace vazio e sem repositório.

A cobertura anterior do CEVIU News sobre 'A Anatomia de um Agent Harness', em 11 de março, 11 de maio e 7 de abril de 2026, introduziu o conceito de agentes de IA e a importância do 'harness' para transformar modelos em ferramentas funcionais. Agora, com os detalhes da arquitetura do Foreman, aprofundamos a compreensão do que antes era uma visão mais conceitual. Vemos em prática como a orquestração e a separação de responsabilidades entre subagentes são aplicadas, com isolamento rigoroso via sandboxes e um sistema de confiança no despacho, concretizando o que antes era um pilar teórico no desenvolvimento de agentes inteligentes.

Compreender o mapa de runtime e as fronteiras arquitetônicas do Foreman é essencial para quem desenvolve ou otimiza sistemas com IA. Essa visão detalhada revela como a plataforma garante segurança, previsibilidade e escalabilidade, ao isolar subagentes e estabelecer confiança de forma robusta. É um guia para maximizar o potencial da plataforma, mostrando como a granularidade da arquitetura afeta a delegação de tarefas e a persistência de dados. A clareza nesse design permite que desenvolvedores criem soluções mais eficientes e seguras.