🤝 Multi-Agent & Subagents

O VoltAgent/awesome-claude-code-subagents cataloga 100+ subagents prontos para uso com Claude Code. Subagents sao agentes especializados que o agente principal pode invocar para tarefas especificas, como um "team" virtual de especialistas que podem ser chamados sob demanda.

A arquitetura de subagents segue o padrao de delegacao: o agente principal recebe a tarefa, identifica quais especialistas sao necessarios, delega sub-tarefas e agrega os resultados. Isso permite lidar com tarefas muito mais complexas do que um unico agente conseguiria.

A colecao wshobson/agents com 112 agentes especializados e uma das maiores do tipo. Cada agente tem um role bem definido, capacidades especificas e instrucoes de quando deve ser utilizado. A diversidade da colecao mostra como o conceito de "agent" pode ser aplicado em praticamente qualquer dominio.

O padrao de definicao inclui: nome do agente, role description, capabilities, limitations e interaction patterns. Essa estrutura padronizada permite combinar agentes de forma previsivel e construir sistemas complexos a partir de pecas simples.

# Security Auditor Agent

Role: Especialista em seguranca de aplicacoes
Capabilities:
  - Analise de vulnerabilidades OWASP Top 10
  - Review de configuracoes de autenticacao
  - Auditoria de dependencias (CVEs)
  - Verificacao de secrets expostos

Limitations:
  - Nao executa penetration testing real
  - Analise estatica apenas (sem runtime)

Trigger: Invocar antes de merge para main
Output: Relatorio com severity levels (critical/high/medium/low)

O ccswarm e um framework para coordenar multiplos agentes Claude Code trabalhando em paralelo no mesmo projeto. Inspirado em algoritmos de enxame (swarm intelligence), permite distribuir tarefas entre agentes que operam simultaneamente com minima interferencia.

O desafio principal em multi-agent paralelo e evitar conflitos: dois agentes editando o mesmo arquivo, decisoes arquiteturais inconsistentes ou duplicacao de trabalho. ccswarm resolve isso com mecanismos de lock de arquivos, contexto compartilhado e protocolos de sincronizacao.

O maestro-gemini implementa o padrao "conductor" (maestro) para orquestrar multiplos agentes Gemini. Um agente central (o maestro) recebe a tarefa, a decompoe em sub-tarefas, distribui para agentes especialistas e agrega os resultados em uma solucao coerente.

Embora focado em Gemini, os padroes de orquestracao sao universais e transferiveis. O conceito de task routing (decidir qual agente recebe cada sub-tarefa), result aggregation (combinar outputs) e quality gating (validar antes de agregar) se aplicam a qualquer plataforma multi-agent.

A comunicacao entre agentes e o aspecto mais critico de sistemas multi-agent. Existem varios padroes, cada um com trade-offs: message passing (simples mas assincrono), shared state (rapido mas com conflitos), event-driven (desacoplado mas complexo) e direct handoff (claro mas rigido).

Na pratica com Claude Code, o padrao mais comum e o "file-based communication": agentes escrevem resultados em arquivos que outros agentes leem. Isso e simples, persistente e auditavel. Para coordenacao mais sofisticada, usa-se um "coordination file" que funciona como quadro de tarefas compartilhado.

Construir um sistema multi-agent customizado e o nivel mais avancado de dominio de skills. O processo envolve: definir os agentes necessarios, seus roles e capacidades, estabelecer protocolos de comunicacao, implementar coordenacao e criar mecanismos de monitoramento.

Comece pequeno: dois agentes (um implementador e um reviewer) ja produzem resultados significativamente melhores que um unico agente. Escale gradualmente adicionando especialistas conforme a complexidade dos projetos aumenta. Monitore tempo de execucao e custo para manter o sistema viavel.

# Sistema Multi-Agent Basico

## Agentes:
1. Implementor - Escreve codigo seguindo skills
2. Reviewer - Revisa codigo com checklist de qualidade

## Fluxo:
1. Implementor recebe tarefa e implementa
2. Reviewer revisa as mudancas
3. Se aprovado: merge
4. Se reprovado: Implementor corrige e repete

## Coordenacao:
- Arquivo tasks.md com status de cada tarefa
- Arquivo review-notes.md com feedback do reviewer
- Ambos leem/escrevem nos arquivos de coordenacao