📡 Sinais de alta incerteza
O Claudex brilha quando há incerteza real no escopo. Sinais visíveis: você não sabe responder com confiança "como isso funciona em produção sob carga, com 5 usuários simultâneos, depois de 3 meses?". Se hesitou, é Claudex.
🚨 Os 5 sinais que disparam o Claudex
- 1. Escopo vago no pedido: "fazer melhor", "otimizar", "ajustar". Verbos sem objeto.
- 2. Múltiplas dependências externas: a feature toca em 3+ sistemas (auth, billing, notificações...)
- 3. Risco de dados: escreve, atualiza, deleta, ou migra dados de produção
- 4. Compliance / segurança: autenticação, autorização, dados pessoais (LGPD/GDPR)
- 5. Cliente sensível: a feature afeta cliente que não tolera erro (B2B enterprise, financeiro, saúde)
Se 2 ou mais aparecem, rode Claudex. Se nenhum aparece, talvez seja overkill.
✅ Tarefas que pedem Claudex
Lista mental concreta dos casos onde sempre vale rodar Claudex, sem precisar pensar muito. Se sua tarefa cai em uma dessas categorias, invocou o comando ainda nesta conversa.
🔐 Categoria: identidade & dados
- • Migração de auth (de X para Clerk/Auth0)
- • Adicionar SSO / OAuth provider
- • Mudar esquema de tabela em produção
- • Política de retenção / purge de dados
- • Importação massiva de dados externos
🏗️ Categoria: arquitetura
- • Quebrar monólito em serviços
- • Trocar fila / banco / cache
- • Adicionar webhook entre sistemas
- • Feature multi-time (envolve 3+ squads)
- • Refactor de módulo crítico
💰 Categoria: receita
- • Mudar fluxo de checkout
- • Integrar gateway de pagamento
- • Ajustar cálculo de cobrança
- • Plano novo / mudança de pricing
- • Feature de retenção de clientes
📊 Categoria: dados estratégicos
- • Analytics novo / pipeline de eventos
- • Dashboard executivo
- • ETL / ML em produção
- • Tracking que envolve consentimento
- • Reprocessamento de dados históricos
❌ Tarefas que dispensam Claudex
Saber quando NÃO usar é tão importante quanto saber quando usar. Claudex em tarefa trivial é overhead — gasta tokens sem retorno e cria fricção desnecessária no fluxo. Aqui ficam os casos onde executar direto é o certo.
🚫 Pula o Claudex se a tarefa é...
- ✗Mudança de texto / cópia: ajustar uma string, traduzir um botão, corrigir um typo
- ✗Mudança de estilo isolada: trocar cor, padding, alinhamento; ajuste visual sem lógica
- ✗Renomeação: renomear variável, função, arquivo — IDE faz, IA também
- ✗Bug pontual com causa óbvia: "esqueceu de tratar null", "ordem errada de parâmetro"
- ✗Configuração simples: adicionar variável de ambiente, ajustar timeout, mudar log level
- ✗Documentação: escrever README, comentário, docstring
💡 Dica prática
Pergunta-teste: "se eu errar essa mudança, qual o pior cenário?" Se a resposta é "reverto em 1 minuto" → execute direto. Se é "rollback complicado" ou "cliente afetado" → Claudex.
🎚️ Calibrando rodadas — 1, 3, 5 ou 10?
O Claudex aceita configuração de rodadas. Padrão é 3 (uma persona por rodada — Engenheiro, Segurança, Ops/SRE), mas você ajusta. Aqui está como calibrar pelo perfil do projeto.
1 rodada — Revisão rápida
~25-30k tokens · ~2-3 min
Use quando: você já está confiante no plano e quer só uma "segunda opinião" rápida. Tarefas pequenas com risco baixo a médio.
/claudex plan -1 ajustar timeout do worker
3 rodadas — Padrão (recomendado)
~80-100k tokens · ~8-10 min
Use quando: tarefa de tamanho médio com risco real. Cobre as 3 personas (Engenheiro, Segurança, Ops/SRE) — espectro completo.
/claudex plan adicionar expiração para links curtos
5 rodadas — Sistemas complexos
~140-160k tokens · ~15-20 min
Use quando: feature crítica, multi-sistema, com compliance ou risco de receita. As 2 rodadas extras pegam edge cases que 3 não pegam.
/claudex plan -5 migrar autenticação para Clerk
10 rodadas — Geralmente exagero
~280-320k tokens · ~30-40 min
A partir da 5ª-6ª rodada, o retorno cai bruscamente — mesmas críticas começam a se repetir. Só use se você tem motivo específico (regulatório, sistema crítico de saúde/financeiro).
/claudex plan -10 [...] # raramente justificado
📄 Aplicações além de código
O ciclo Claudex é uma filosofia generalista — funciona em qualquer trabalho que exige plano sólido antes da execução. Não precisa ser software. A mecânica de "rascunhar → criticar → revisar → repetir" se aplica em praticamente qualquer artefato de conhecimento.
📊 Apresentação executiva
Rascunho de slides → crítica adversarial ("e se um diretor cético perguntar X?") → revisão
Resultado: apresentação que aguenta perguntas difíceis em vez de desmoronar na primeira objeção.
📝 Documento estratégico
Plano de Q3 → "advogado do diabo" lê → ajustes
Resultado: estratégia que considerou contra-argumentos antes de ser apresentada.
💼 Proposta comercial
Proposta inicial → review por persona "cliente que vai negociar" → ajuste
Resultado: proposta com objeções já antecipadas e respondidas.
🎓 Especificação de produto
PRD → review por persona "engenheiro que vai implementar" → ajuste
Resultado: spec sem ambiguidades que geram retrabalho na engenharia.
🔄 O padrão universal
Em qualquer artefato: (1) rascunho honesto, (2) revisor adversarial com persona específica, (3) integração de achados, (4) repetição com personas diferentes, (5) versão final travada. Esse é o Claudex — o software é só uma instância dele.
📏 Regra prática — a heurística de bolso
Você não precisa lembrar de tudo isso na hora. Carregue uma heurística simples que decide em 3 segundos. Aqui está a versão que cabe na cabeça.
🧠 A heurística
"Quanto maior a incerteza, maior o valor do Claudex."
Decore. Use sempre que tiver dúvida.
⚡ Decisão em 30 segundos
# Algoritmo mental SE a tarefa toca dados em produção → CLAUDEX (3 rodadas) SE a tarefa envolve auth/segurança/billing → CLAUDEX (5 rodadas) SE a tarefa atravessa 3+ sistemas → CLAUDEX (3 rodadas) SE o escopo do pedido é vago → CLAUDEX (3 rodadas) SE o cliente é sensível (B2B/saúde/financ) → CLAUDEX (5 rodadas) SENÃO → execução direta
Cabe num post-it. Cole na sua mesa, no Notion da equipe, no canal do Slack.
💡 Quando duvidar — rode
Se você está em dúvida entre rodar Claudex ou não, rode. O custo de rodar é baixo (~$1, ~10 min). O custo de não rodar quando deveria é altíssimo (semanas de retrabalho, incidentes em produção, perda de confiança do cliente).
🎉 Você terminou a Trilha 1!
Recapitulando o que dominou nos 5 módulos:
🚀 E agora? Próximas trilhas:
- • Trilha 2 — Arquitetura: Stop Hook, YAML, Runner, personas e segurança (com diagramas)
- • Trilha 3 — Uso: instalação, comandos com flags, exemplos reais ponta-a-ponta
- • Trilha 4 — Avançado: customização, debugging, métricas e quando o Claudex não basta