artubss Agentes Paralelos Nativos
Orquestração através do Agent Tool nativo do Claude Code
Visão Geral
Esta habilidade permite coordenar múltiplos agentes especializados através do sistema de agentes nativo do Claude Code. Diferentemente de scripts externos, essa abordagem mantém toda a orquestração sob controle do Claude.
Quando Usar Orquestração
✅ Bom para:
- Tarefas complexas que requerem múltiplos domínios de expertise
- Análise de código sob perspectivas de segurança, performance e qualidade
- Reviews abrangentes (arquitetura + segurança + testes)
- Implementação de features que precisam de trabalho backend + frontend + banco de dados
❌ Não é para:
- Tarefas simples de um único domínio
- Correções rápidas ou pequenas mudanças
- Tarefas onde um agente é suficiente
Invocação de Agentes Nativos
Agente Único
Use o agente security-auditor para revisar autenticação
Cadeia Sequencial
Primeiro, use o explorer-agent para descobrir a estrutura do projeto.
Depois, use o backend-specialist para revisar endpoints da API.
Por fim, use o test-engineer para identificar gaps em testes.
Com Passagem de Contexto
Use o frontend-specialist para analisar componentes React.
Com base nesses achados, peça ao test-engineer para gerar testes de componentes.
Retomar Trabalho Anterior
Retome o agente [agentId] e continue com requisitos adicionais.
Padrões de Orquestração
Padrão 1: Análise Abrangente
Agentes: explorer-agent → [domain-agents] → synthesis
1. explorer-agent: Mapear estrutura da codebase
2. security-auditor: Postura de segurança
3. backend-specialist: Qualidade da API
4. frontend-specialist: Padrões de UI/UX
5. test-engineer: Cobertura de testes
6. Sintetizar todos os achados
Padrão 2: Review de Feature
Agentes: affected-domain-agents → test-engineer
1. Identificar domínios afetados (backend? frontend? ambos?)
2. Invocar agentes de domínio relevantes
3. test-engineer verifica mudanças
4. Sintetizar recomendações
Padrão 3: Auditoria de Segurança
Agentes: security-auditor → penetration-tester → synthesis
1. security-auditor: Review de configuração e código
2. penetration-tester: Testes de vulnerabilidades ativas
3. Sintetizar com remediação priorizada
Agentes Disponíveis
| Agente | Expertise | Frases de Gatilho |
|---|---|---|
orchestrator |
Coordenação | "abrangente", "múltiplas perspectivas" |
security-auditor |
Segurança | "segurança", "autenticação", "vulnerabilidades" |
penetration-tester |
Teste de Segurança | "pentest", "red team", "exploit" |
backend-specialist |
Backend | "API", "servidor", "Node.js", "Express" |
frontend-specialist |
Frontend | "React", "UI", "componentes", "Next.js" |
test-engineer |
Testes | "testes", "cobertura", "TDD" |
devops-engineer |
DevOps | "deploy", "CI/CD", "infraestrutura" |
database-architect |
Banco de Dados | "schema", "Prisma", "migrations" |
mobile-developer |
Mobile | "React Native", "Flutter", "mobile" |
api-designer |
Design de API | "REST", "GraphQL", "OpenAPI" |
debugger |
Debugging | "bug", "erro", "não funciona" |
explorer-agent |
Discovery | "explorar", "mapear", "estrutura" |
documentation-writer |
Documentação | "escrever docs", "criar README", "gerar API docs" |
performance-optimizer |
Performance | "lento", "otimizar", "profiling" |
project-planner |
Planejamento | "planejar", "roadmap", "milestones" |
seo-specialist |
SEO | "SEO", "meta tags", "ranking de busca" |
game-developer |
Game Development | "game", "Unity", "Godot", "Phaser" |
Agentes Nativos do Claude Code
Estes funcionam lado a lado com agentes customizados:
| Agente | Modelo | Propósito |
|---|---|---|
| Explore | Haiku | Busca rápida e somente leitura na codebase |
| Plan | Sonnet | Pesquisa durante o modo plan |
| General-purpose | Sonnet | Modificações complexas em múltiplas etapas |
Use Explore para buscas rápidas, agentes customizados para expertise de domínio.
Protocolo de Síntese
Após todos os agentes completarem, sintetize:
## Síntese de Orquestração
### Resumo da Tarefa
[O que foi realizado]
### Contribuições dos Agentes
| Agente | Achado |
|--------|--------|
| security-auditor | Encontrou X |
| backend-specialist | Identificou Y |
### Recomendações Consolidadas
1. **Crítico**: [Problema do Agente A]
2. **Importante**: [Problema do Agente B]
3. **Nice-to-have**: [Melhoria do Agente C]
### Itens de Ação
- [ ] Corrigir problema crítico de segurança
- [ ] Refatorar endpoint da API
- [ ] Adicionar testes faltantes
Melhores Práticas
- Agentes disponíveis - 17 agentes especializados podem ser orquestrados
- Ordem lógica - Discovery → Analysis → Implementation → Testing
- Compartilhar contexto - Passar achados relevantes para agentes subsequentes
- Síntese única - Um relatório unificado, não outputs separados
- Verificar mudanças - Sempre incluir test-engineer para modificações de código
Principais Benefícios
- ✅ Sessão única - Todos os agentes compartilham contexto
- ✅ Controlado por IA - Claude orquestra autonomamente
- ✅ Integração nativa - Funciona com agentes Explore e Plan nativos
- ✅ Suporte a retomada - Pode continuar trabalho anterior de agentes
- ✅ Passagem de contexto - Achados fluem entre agentes