MÓDULO 2.3

🤝 Dual-Mode (Claude + Codex)

Combinar Claude (reasoning) + Codex (code generation) com shared memory.

6
Tópicos
70
Minutos
Médio
Nível
Prática
Tipo
1

🤝 Por que dual-mode

Single-platform = uma perspectiva. Dual-mode usa Claude para reasoning e Codex para code generation em paralelo. Cada plataforma faz o que faz melhor, e o resultado é cruzado para minimizar erros e acelerar entregas.

✓ Dual-mode oferece

  • Cross-validation entre plataformas
  • Estilos de raciocínio complementares
  • Code review automatizado built-in
  • Workflows paralelos vs sequenciais

✗ Single-platform tem

  • Apenas a perspectiva de um modelo
  • Sem verificação externa
  • Erros sistêmicos passam batido
  • Workflows necessariamente seriais
2

🔵 Claude strengths

Claude se destaca em tarefas que exigem deliberação. Architecture, security review, testing strategy — tudo que pede análise cuidadosa, modelagem de ameaça, edge cases. É o "pensador" do duo.

🧠Use Claude para

  • Architecture & Design — Strong reasoning, system thinking
  • Security Review — Threat modeling, careful analysis
  • Testing Strategy — Coverage analysis, edge cases
  • Complex debugging — Root cause investigation

💡Dica prática

Quando a tarefa começa com "decida", "avalie", "modele" ou "analise" — vai de Claude. Quando começa com "implemente", "gere", "transforme" — Codex.

3

🟢 Codex strengths

Codex é geração rápida e bulk transformations. Implementação seguindo specs, refactor em massa, otimizações pontuais — terreno onde código já tem forma e só precisa ser produzido com precisão.

Use Codex para

  • Implementation — Geração rápida com specs claras
  • Performance Optimization — Code-level optimizations
  • Refactoring — Bulk code transformations
  • Boilerplate — DTOs, controllers, migrations

🎯Quando combinar

  • Claude faz design → Codex implementa
  • Claude analisa CVE → Codex aplica patches em massa
  • Claude define testes → Codex preenche stubs
4

🔄 Cross-platform memory

Os dois mundos se conectam via namespace 'collaboration' compartilhado. Tudo que Claude descobre fica disponível para Codex e vice-versa. Sem isso, dual-mode vira dois agentes correndo solo.

💾Comandos chave

# Store
npx claude-flow@v3alpha memory store \
  --namespace collaboration \
  --key "design-decisions" --value "..."

# Search semântica
npx claude-flow@v3alpha memory search \
  --namespace collaboration \
  --query "auth patterns"

🔁Fluxo típico

  1. Claude grava design em collaboration/design-decisions
  2. Codex lê e implementa, grava em collaboration/implementation
  3. Claude revisa lendo da memória, grava findings
  4. Codex aplica patches do review
5

📊 Worker dependency levels

Workers executam em níveis de dependência. Level 0 não depende de ninguém, levels seguintes esperam predecessores. Isso permite paralelismo dentro de cada nível.

0

Level 0 — Architect (🔵)

Sem dependências, roda primeiro

Estabelece contratos para todos os outros.

1

Level 1 — Coder (🟢) + Tester (🔵)

Esperam Architect, rodam em paralelo

Tester escreve testes pelo design enquanto Coder implementa.

2

Level 2 — Reviewer (🔵)

Espera Coder + Tester

Revisa código + tests integrados.

3

Level 3 — Optimizer (🟢)

Espera aprovação do Reviewer

Otimização final só rola se review passou.

6

⚙️ CLI dual run

O comando claude-flow-codex dual run aciona templates ou fluxos custom. Você passa task ou workers explícitos, e a orquestração cuida do resto.

📚Exemplos prontos

Feature template:

npx claude-flow-codex dual run feature --task "Add OAuth login"

Security audit:

npx claude-flow-codex dual run security --target "./src"

Custom multi-worker:

npx claude-flow-codex dual run \
  --worker "claude:architect:Design API" \
  --worker "codex:coder:Implement REST" \
  --namespace "api-feature"

📊Status & templates

npx claude-flow-codex dual status      # workers ativos
npx claude-flow-codex dual templates   # lista oficiais

📋Resumo do Módulo

Por que dual — Reasoning + code generation paralelos com cross-validation
Claude — Architecture, security, testing, debugging
Codex — Implementation, optimization, refactor
Memória — Namespace 'collaboration' conecta as plataformas
Levels — Workers em 4 níveis com paralelismo intra-nível
CLI — claude-flow-codex dual run para templates e custom

Próximo Módulo:

2.4 - Memory-Driven Development: search-first, store-after