Escala
A arquitetura hub-and-spoke e o padrao central para sistemas multi-agente no exame. O coordenador (hub) gerencia toda a comunicacao entre subagentes (spokes).
Principios fundamentais:
- Coordenador gerencia comunicacao — Subagentes nunca se comunicam diretamente entre si. Tudo passa pelo coordenador.
- Subagentes isolados — Cada subagente tem contexto isolado. Nao herdam o historico do coordenador automaticamente.
- Contexto explicito — Ao invocar um subagente, inclua todas as informacoes necessarias na mensagem. Nada e implicito.
- Tool Agent — Use a ferramenta
Agent(antes chamadaTask) para spawnar subagentes.allowedToolsdeve incluir "Agent" para o coordenador.
Para o Exame
Questoes sobre subagentes herdando contexto: a resposta e sempre NAO — contexto deve ser explicito. Questoes sobre comunicacao entre subagentes: tudo passa pelo coordenador.
MCP (Model Context Protocol) servers estendem as capacidades do Claude Code com ferramentas externas.
Dois niveis de configuracao:
.mcp.json— Nivel de projeto, versionado no repositorio. Servidores compartilhados com o time.~/.claude.json— Nivel pessoal. Servidores de uso individual, nao versionados.
Credenciais usam expansao de variaveis de ambiente: ${GITHUB_TOKEN}, ${DATABASE_URL}. Nunca hardcode tokens em arquivos de configuracao.
MCP Resources fornecem catalogos de conteudo — resumos de issues, schemas de banco de dados — que o modelo pode consultar sem executar queries.
Para o Exame
MCP compartilhado com o time: .mcp.json. MCP pessoal: ~/.claude.json. Community servers para integracoes padrao (GitHub, Jira, etc).
Claude Code pode ser integrado em pipelines de CI/CD para automacao de code reviews, geracao de testes e feedback em PRs.
-pflag — Modo nao-interativo, essencial para CI. Sem este flag, Claude Code espera input do terminal.--output-format json— Saida estruturada para processamento automatizado. Combine com--json-schemapara validacao.- CLAUDE.md em CI — Fornece contexto para a instancia CI do Claude Code (padroes de codigo, convencoes do projeto).
- Session isolation — A instancia que gera codigo deve ser diferente da que revisa. Self-review e ineficaz.
Padrao de Integracao
Use -p "Review this PR for security issues" no CI, com --output-format json para postar comentarios automaticamente. Inclua findings anteriores para evitar duplicatas.
Uma limitacao fundamental do self-review: o modelo rethem o contexto de raciocinio e tem menos chance de questionar suas proprias decisoes.
Regra de Ouro
Segunda instancia independente > self-review > extended thinking para revisao. A segunda instancia nao tem acesso ao raciocinio original, entao avalia o resultado com olhos frescos.
Para code review em larga escala, use o padrao multi-pass:
- Per-file pass — Analise local de cada arquivo individualmente
- Cross-file pass — Integracao dos findings, verificando consistencia entre arquivos
- Verification pass — Scores de confianca para priorizar revisao humana
Evolua o agente de suporte da Camada 3 para um sistema de pesquisa multi-agente:
- Coordenador — Recebe a query de pesquisa, decompoe em subtarefas, delega para subagentes, agrega resultados
- Subagente de busca — Executa web search e coleta fontes
- Subagente de analise — Analisa documentos e extrai dados estruturados
- Subagente de sintese — Combina resultados com atribuicao de fontes
Integre MCP servers para acesso a APIs externas via .mcp.json. Configure CI/CD para revisao automatica dos relatorios gerados.
Evolucao do Projeto
O agente de suporte agora e um sistema completo: coordenacao multi-agente, integracao MCP, pipeline CI/CD e revisao independente. Na Camada 5, voce consolidara tudo em um simulado.