🎬 Visão geral
Templates são pipelines pré-fabricados para tarefas comuns: feature nova, security audit, refactor, bugfix. Você descreve o objetivo, o template já sabe quais agentes spawnar e em que ordem. 90% dos casos diários são cobertos pelos quatro principais.
📦Templates oficiais
- feature — Architect → Coder → Tester → Reviewer
- security — Analyst → Scanner → Reporter
- refactor — Architect → Refactorer → Tester
- bugfix — Researcher → Coder → Tester
⚡Comando único
npx claude-flow-codex dual run feature --task "Add OAuth"Spawn paralelo, memória compartilhada, retorno consolidado.
🎯 Feature template
O fluxo completo de feature development. Architect projeta, Coder implementa, Tester valida, Reviewer audita. Pipeline limpo, ideal para qualquer feature de tamanho médio (3-15 arquivos).
🔵 Architect
Define interfaces, schemas, fluxos
Decide os contratos antes do código existir.
🟢 Coder
Implementa seguindo o design
Codex acelera geração, segue contratos do architect.
🔵 Tester
Cobertura unit + integration
Valida edge cases pelo design, não pela implementação.
🟢 Reviewer
Code quality + security check
Última camada — pega tudo que escapou.
💡Dica prática
Use feature sempre que a tarefa tiver descrição como "implementar X" ou "adicionar Y". É o pipeline default do dia a dia.
🔒 Security template
Workflow especializado para audits. Analyst mapeia ameaças, Scanner roda ferramentas (CVE, dep audit, lint security), Reporter consolida em relatório acionável.
🛡️Pipeline security
- Analyst (🔵) — STRIDE/threat modeling, identifica vetores
- Scanner (🟢) — Roda npm audit, semgrep, trufflehog, snyk
- Reporter (🔵) — Prioriza CVSS, gera plano de remediação
🚀Comando
npx claude-flow-codex dual run security --target "./src"⚠️Atenção
Audit não substitui pentest profissional. Use security template para varredura periódica e antes de deploy — não como única defesa.
♻️ Refactor template
Modernizar código legado sem quebrar comportamento. Architect mapeia targets, Refactorer aplica transformações, Tester confirma que nada quebrou. Codex brilha aqui — transformações em massa são sua especialidade.
✓ Bom para
- ✓Migrar callbacks → async/await
- ✓Extrair módulos compartilhados
- ✓Renomear/reorganizar diretórios
- ✓Adicionar tipos a JS legacy
✗ Evite quando
- ✗Sem cobertura de testes prévia
- ✗Refactor é mudança comportamental disfarçada
- ✗Toca códigos com side-effects ocultos
- ✗Você não tem CI rodando
🚀Comando
npx claude-flow-codex dual run refactor --target "./src/legacy"🐛 Bugfix template
Otimizado para investigação. Researcher reproduz e isola, Coder corrige minimamente, Tester garante que o bug não volta (regressão). Foco em cirurgia, não reescrita.
🔍Por que isso importa
- •Researcher força reprodução antes do fix
- •Mudança escopo limitado evita regressões
- •Tester adiciona test que falhava antes do fix
- •Trajetória vira pattern para bugs similares
💡Dica prática
Sempre exija repro steps antes do bugfix template. Sem repro confiável, o "fix" pode esconder o bug em vez de resolver.
🛠️ Custom templates
Os 4 oficiais não cobrem tudo. Para fluxos repetidos no seu time (ex: data-pipeline, ml-experiment, incident-response), defina template próprio. Fica reutilizável e versionado.
🧩Estrutura mínima
npx claude-flow-codex dual run \
--worker "claude:architect:Design API" \
--worker "codex:coder:Implement REST" \
--worker "claude:tester:Integration tests" \
--namespace "api-feature"📐Boas práticas para custom
- •3-6 workers — mais que isso vira caos
- •Defina dependency levels explícitos
- •Versione no repo (templates/data-pipeline.json)
- •Documente quando NÃO usar o template
📋Resumo do Módulo
Próximo Módulo:
2.3 - Dual-Mode (Claude + Codex): combinando reasoning + code generation