📐 Sintaxe -N
/claudex plan -3 [...] # 3 rodadas (padrão, mas explícito) /claudex plan -1 [...] # 1 rodada /claudex plan -5 [...] # 5 rodadas /claudex plan -10 [...] # 10 rodadas (raramente útil)
A flag -N vai logo após plan, antes de qualquer arquivo de escopo ou descrição.
⚡ 1 rodada — revisão rápida
~25-30k tokens · ~2-3 min · ~$0.20
Usa só Engenheiro Sênior. Revisão rápida pra plano onde você já está confiante.
/claudex plan -1 ajustar timeout do worker para 30s
Quando: tarefas pequenas, plano que você já sabe que está bom mas quer "segunda opinião" rápida.
⚖️ 3 rodadas — padrão recomendado
~80-100k tokens · ~8-10 min · ~$0.80
Engenheiro + Segurança + Ops/SRE. Cobre o espectro padrão de risco.
/claudex plan adicionar expiração para links curtos
Quando: tarefa de tamanho médio com risco real. É o padrão. Quando em dúvida, use 3.
🛡️ 5 rodadas — sistemas complexos
~140-160k tokens · ~15-20 min · ~$1.50
3 personas padrão + 2 rodadas extras (geralmente Engenheiro e Segurança em segunda passada, mais profundas).
/claudex plan -5 migrar autenticação para Clerk
Quando: compliance (LGPD, GDPR), financeiro, saúde, sistemas multi-time, mudança de auth. Onde 3 rodadas pegariam o óbvio mas as edge cases ainda escapariam.
⚠️ 10 rodadas — geralmente exagero
~280-320k tokens · ~30-40 min · ~$3.00
A partir da 5ª-6ª rodada, retorno cai bruscamente. Mesmas críticas começam a se repetir.
/claudex plan -10 [...] # raramente justificado
Só use se: sistema de altíssima criticidade (médico, aeroespacial, financeiro de altos valores) e você precisa documentar que múltiplas revisões aconteceram.
💰 Custo em tokens — referência
| Rodadas | Tokens | Tempo | Custo aprox. |
|---|---|---|---|
| 1 | ~25-30k | ~2-3 min | $0.20 |
| 3 (padrão) | ~80-100k | ~8-10 min | $0.80 |
| 5 | ~140-160k | ~15-20 min | $1.50 |
| 10 | ~280-320k | ~30-40 min | $3.00 |
Valores aproximados, variam pelo provider e tamanho do PLAN.md.
📌 Resumo
plan.Próximo Módulo:
3.4 — ⌨️ Os outros comandos