Módulo 4.1 — /claudex review

⚖️ Diferença vs /plan

/plan

• Cria PLAN.md do zero
• N rodadas iterativas
• Modifica o PLAN.md a cada rodada
• Custo: ~80-100k tokens

/review

• Lê PLAN.md existente
• 1 rodada de auditoria
• NÃO modifica o PLAN.md
• Custo: ~20-30k tokens

📌 Quando usar /review

• PR review com plano: alguém abriu PR com PLAN.md, você quer auditar antes de aprovar
• PRD recebido do PM: documento de produto que precisa virar plano técnico
• Plano legado: ticket antigo com plano que ainda não foi executado
• Plano feito por outro time: equipe parceira mandou plano pra implementar
• Comparação: 2 alternativas de plano, qual é melhor?

📐 Sintaxe com @PLAN.md

/claudex review @PLAN.md
/claudex review @docs/proposed-plan.md
/claudex review --persona security @plan-de-auth.md

Você passa o caminho do arquivo. Opcionalmente, restrinja a persona — útil quando você só quer revisão de segurança, por exemplo.

📝 Auditando sem alterar

O /review gera um arquivo review-findings.md separado. Não toca no PLAN.md original. Você decide depois o que integrar — ou descarta tudo, se preferir.

# review-findings.md (gerado pelo /review)

## Achados

ALTO:
- Plano não trata caso X
- Premissa Y não está validada

MÉDIO:
- [...]

## Recomendação geral
Plano sólido nas etapas 1-3. Riscos não cobertos
nos itens X e Y. Sugestão: 1 rodada extra de
revisão antes de executar.

💰 Custo menor

Como é só uma rodada (sem iteração), custa ~30% do /plan. Use livremente — é o equivalente de "código review automatizado" para planos.

Comando	Tokens	Tempo	Custo
/plan -3	~80-100k	~10 min	~$0.80
/review	~20-30k	~3 min	~$0.25

📋 Casos de uso reais

CI: review automático em PR

GitHub Action roda /review em cada PR que toca PLAN.md. Comentário automático no PR.

Triagem de tickets

Tech lead recebe 10 tickets/dia. Roda /review em cada um. Filtra os 3 que precisam refinamento.

Comparação de propostas

2 RFCs de arquitetura. /review em cada um. Findings ajudam decisão.

Onboarding

Dev junior escreveu PLAN.md. /review dá feedback técnico antes do mentor revisar.

📌 Resumo

✓

/review é leitura — não cria nem modifica PLAN.md.

✓

1 rodada só — auditoria, não iteração.

✓

Custo ~30% do /plan — use livremente em PRs e tickets.

✓

Casos: PR, triagem, comparação, onboarding — múltiplos cenários práticos.

✓

Pode restringir persona — só segurança, só ops, etc.

✓

Output: review-findings.md — você decide o que integrar.

Próximo Módulo:

4.2 — 📄 Aplicações além de código

← Voltar à Trilha Próximo →