Módulo 3.2 — /claudex plan

📐 Sintaxe básica

/claudex plan [-N] [@arquivo1 @arquivo2 ...] <descrição do que construir>

• -N (opcional): número de rodadas. Padrão: 3.
• @arquivo (opcional): arquivos de escopo a ler antes do plano.
• descrição: o que você quer construir, em português ou inglês.

🎯 Exemplo simples

/claudex plan adicionar expiração para links curtos

Em uma linha: comando + descrição. Sem flags, usa padrão (3 rodadas, 3 personas). Bom pra 90% dos casos.

📝 Exemplo com tópico longo

/claudex plan criar sistema de notificações por email para
eventos críticos do sistema, com templates editáveis pelo
admin, retry automático em caso de falha de envio, e
respeito a opt-out de usuários por categoria de email

Pode ser parágrafo. Quanto mais específico, menos perguntas o ciclo precisa fazer. Vague-vai = vague-vem.

📺 Saída esperada

O que você vai ver no terminal:

$ /claudex plan adicionar expiração para links curtos

🚀 Iniciando ciclo Claudex
Tópico: "adicionar expiração para links curtos"
Rodadas: 3 (padrão)

[Rodada 1] Engenheiro Sênior
Claude: escrevendo PLAN.md inicial...
Claude: PLAN.md criado (22 linhas)
Hook:   BLOCK · executar runner.sh
Codex:  analisando design e premissas...
Codex:  findings-round-1.md (2 alto, 2 médio, 2 baixo)
Claude: revisando PLAN.md...
Claude: PLAN.md atualizado (38 linhas)

[Rodada 2] Segurança
[... análogo ...]

[Rodada 3] Ops/SRE
[... análogo ...]

═══════════════════════════════════════
   CLAUDEX — CICLO CONCLUÍDO
═══════════════════════════════════════
[sumarização final]
✅ PLANO TRAVADO — pronto para execução

📄 O que vai pra PLAN.md

Após o ciclo, abra o PLAN.md gerado. Estrutura típica:

# PLAN.md

## Objetivo
[O que vamos construir, com critério de sucesso mensurável]

## Decisões
[Escolhas técnicas + justificativa]

## Etapas
1. [...] (estimativa)
2. [...] (estimativa)

## Riscos e Mitigações
- [risco] → [mitigação]

## Rollback
[Como reverter se algo der errado]

## Observabilidade
[Métricas e logs essenciais]

## Critério de Aceite
[Como saber que terminou]

É esse arquivo que vai virar a base da execução. Mantenha versionado.

✅ Encerrando bem o turno

Após o "PLANO TRAVADO", você pode:

A) Executar imediatamente

Diga: "agora implementa o PLAN.md". Claude usa o plano como roteiro.

B) Revisar manualmente

Abra PLAN.md, ajuste o que quiser, depois implemente.

C) Pedir mais rodadas

Se algo ainda não convence, rode /claudex plan -2 em cima do plano atual.

D) Compartilhar

PLAN.md em PR pra time revisar antes de implementar.

📌 Resumo

✓

Sintaxe: /claudex plan [-N] [@arquivos] <descrição>.

✓

Padrão = 3 rodadas — cobre 90% dos casos.

✓

Descrição específica — vago entra, vago sai.

✓

Saída visual rica — você vê cada rodada acontecendo.

✓

PLAN.md tem 7 seções típicas — objetivo, decisões, etapas, riscos, rollback, observabilidade, critério de aceite.

✓

4 caminhos pós-ciclo — executar, revisar, mais rodadas, compartilhar.

Próximo Módulo:

3.3 — 🎚️ Calibrando rodadas

← Anterior Próximo →