📚 Conteúdo detalhado
🚫 O problema dos planos fracos
Por que IA constrói rápido demais e por que isso custa caro.
A IA gera código tão rápido que o plano por trás não recebe escrutínio.
Saber que velocidade não é sinal de qualidade evita decisões precipitadas.
Velocidade × profundidade · ilusão de progresso · o custo de pular planejamento.
Toda decisão fraca no plano vira correção dispendiosa na implementação.
Você passa a investir tempo cedo, onde corrigir custa pouco.
Curva de custo de defeito · prevenção × correção · multiplicador de erro.
Quando o plano assume coisas que não são verdade, todo o resto desaba.
Identificar premissas frágeis cedo é a maior alavanca de qualidade.
Premissa implícita · validação prévia · efeito cascata.
Riscos de segurança, dados e operação que nem entram no plano inicial.
Riscos não nomeados no plano viram incidentes em produção.
Risco oculto × risco mapeado · superfície de ataque · perda silenciosa.
A tendência humana e organizacional de pular para a execução.
Reconhecer o padrão é o primeiro passo para quebrá-lo.
Viés de ação · pressão de prazo · falsa sensação de progresso.
Sinais visíveis que mostram quando um plano não vai aguentar.
Você consegue rejeitar planos ruins antes de virarem código.
Vagueza · ausência de rollback · falta de critério de sucesso.
🤖 O que é o Claudex
A definição em uma frase, a dupla Claude+Codex e a filosofia central.
Claudex é um comando que coloca Claude e Codex em ciclo de revisão antes de executar.
A frase central guia toda a expectativa sobre o que o Claudex entrega.
Comando slash · ciclo de revisão · plano antes de execução.
Claude planeja, Codex critica. Cada um joga o papel onde brilha mais.
Entender a divisão de papéis é a chave para confiar no resultado.
Planejador × revisor · especialização · complementaridade.
Um modelo só revisa o próprio trabalho com viés. Dois criam pressão real.
Você entende por que o ciclo gera planos melhores do que prompts duplos.
Revisão adversarial · viés do autor · perspectiva externa.
Codex lê o plano, encontra problemas e aponta. Não escreve código.
Saber o limite do Codex evita expectativas erradas e custo desnecessário.
Findings · severidade · revisão sem implementação.
Claude cria o PLAN.md, lê os achados do Codex e revisa o plano.
Você entende quem mantém a "verdade" do plano em cada momento.
Autoria do plano · integração de findings · execução final.
"Não construa em cima de plano fraco. Prove que ele aguenta antes."
A filosofia se aplica em IA, equipes e trabalho manual — não só código.
Pressão antes da execução · prova × esperança · hábito × ferramenta.
🔄 O ciclo em 5 passos
Rascunho → Avaliação → Revisão → Repetição → Plano travado.
A primeira versão do plano, gerada pelo Claude com base no seu pedido.
É a versão que será refinada — quanto melhor o pedido, melhor o ponto de partida.
PLAN.md · escopo · etapas · riscos iniciais.
Codex lê o plano e gera uma lista de achados classificados por severidade.
É onde a pressão real acontece — entender essa fase é entender o ciclo.
Achados · severidade alta/média/baixa · revisão por persona.
Claude lê os achados e atualiza o PLAN.md com correções e novas etapas.
É a fase onde a qualidade aumenta — o plano vira mais forte aqui.
Integração de achados · refinamento · adição de rollback/métricas.
O ciclo se repete N vezes (padrão 3), cada uma com persona diferente.
Cada rodada cobre tipos de problemas diferentes — não dá pra pular.
Personas rotativas · 3 rodadas padrão · custo × benefício de mais rodadas.
Atingidas as rodadas, o plano é considerado pronto e a execução libera.
Saber o critério de "pronto" evita encerrar cedo demais ou tarde demais.
Plano travado · execução · sumarização final.
A imagem mental dos 5 passos numa única figura — Rascunho/Avaliar/Revisar/Pronto.
Ter a imagem na cabeça torna o ciclo intuitivo na prática.
Diagrama do ciclo · setas de iteração · ponto de saída.
⚖️ Por que Claude + Codex juntos
Forças complementares, dinâmica adversarial e por que insights bastam.
Claude é forte em organizar tarefas, escrever planos legíveis e propor implementação.
Saber onde o Claude brilha ajuda a confiar no rascunho inicial.
Estruturação · narrativa técnica · proposta de etapas.
Codex é direto e cético — encontra falhas que o Claude tenderia a ignorar.
Você entende por que o Codex serve melhor como crítico do que como autor.
Ceticismo · busca de falhas · classificação por severidade.
Um modelo defende, outro ataca. A pressão gera melhorias que nenhum dos dois faz sozinho.
Entender a tensão te ajuda a interpretar achados como oportunidade, não como crítica.
Defesa × ataque · pressão produtiva · plano endurecido.
Codex só aponta — quem corrige é o Claude. Isso é proposital.
Manter a autoria com um único modelo evita conflitos e mantém o plano coerente.
Insight × implementação · custo menor · coerência de autoria.
Cada rodada custa tokens. O ganho é menos retrabalho na execução.
Você decide quando o custo vale a pena pelo tipo de projeto.
Tokens × hora-engenheiro · ROI do planejamento · calibragem.
Antes de chamar pedreiros, engenheiros revisam a planta. Claudex é isso aplicado a software.
A analogia funciona pra explicar o Claudex pra qualquer público em 30 segundos.
Planta × código · engenheiro × Codex · pedreiro × execução.
🎯 Quando usar e quando não usar
Calibrando o Claudex ao tamanho do problema.
Escopo vago, múltiplas dependências, risco de dados ou segurança.
Reconhecer esses sinais te diz quando o investimento se paga.
Incerteza técnica · risco em cascata · custo de falha alto.
Migração de auth, mudanças em dados em produção, features multi-time.
Lista mental clara evita debater "será que vale?" toda hora.
Auth · migrações · features de risco · dependências cruzadas.
Typos, mudanças de cor, renomeações, texto. Claudex aqui é overhead.
Saber quando NÃO usar evita gastos de tokens e fricção.
Mudança trivial · custo desproporcional · velocidade legítima.
1 rodada (rápido), 3 (padrão), 5 (complexo), 10 (geralmente exagero).
Calibrar bem é a diferença entre Claudex útil e Claudex caro.
Rodada × persona · retorno decrescente · escolha por risco.
Apresentações, documentos estratégicos, propostas, especificações de produto.
Você expande o uso do Claudex para qualquer trabalho que pede plano sólido.
Filosofia generalista · plano × artefato · trabalho de conhecimento.
"Quanto maior a incerteza, maior o valor do Claudex." Use isso pra decidir.
Uma regra simples evita debate longo a cada decisão.
Heurística · incerteza × esforço · decisão rápida.