🔍 /claudex review @PLAN.md
Quando usar: você já tem um PLAN.md (gerado por outra fonte ou manualmente). Quer que o Codex audite mas sem alterar o arquivo.
/claudex review @PLAN.md
Codex gera findings.md com observações. Plano original não é modificado. Use quando quer opinião mas pretende decidir manualmente o que mudar.
Custo: menor que plan, pois não há rodadas iterativas — só uma revisão.
🛑 /claudex cancel
Quando usar: ciclo em andamento foi mal pensado, prompt inicial estava ruim, ou simplesmente não vale gastar mais tokens.
/claudex cancel
Para imediatamente. Hook libera o lock, escreve "user_canceled" no decision_signal e retorna ALLOW. Você pode iniciar um novo ciclo sem aguardar.
Difere de /rollback: cancel preserva os arquivos parciais (PLAN.md, findings.md já gerados). Não apaga nada.
🔄 /claudex restart
Quando usar: ciclo travou no meio, mas o tópico ainda é válido. Você quer reiniciar do passo 1 sem mudar a descrição.
/claudex restart
Limpa state.yaml, mantém o tópico armazenado, reinicia da rodada 1. Útil quando algo deu errado mas você não quer redescrever o problema.
🧹 /claudex rollback
Quando usar: limpeza pesada. Apaga tudo de .claude/claudex/ exceto a configuração. Útil quando o estado ficou inconsistente.
/claudex rollback # pede confirmação
Atenção: apaga PLAN.md, findings-round-*.md, state.yaml, log.txt. Use só quando outras opções não funcionaram.
📊 /claudex status
Quando usar: você não lembra em que fase do ciclo está, ou quer ver progresso sem aguardar a sumarização final.
$ /claudex status Modo: plan Fase: reviewing Rodada: 2 de 3 Tópico: "adicionar expiração para links curtos" Achados R1: 6 (2 alto, 2 médio, 2 baixo) — 5 integrados Achados R2: em andamento Tempo decorrido: 4min 12s
Comando "leve" — só lê state.yaml, não dispara nada. Pode rodar a qualquer momento.
🩺 /claudex doctor
Já apresentado no Módulo 3.1. Quando usar: em qualquer suspeita de erro de ambiente — antes de começar, ou quando algo não funcionou como esperado.
/claudex doctor # diagnóstico padrão /claudex doctor --verbose # cada check com detalhe
Pode ser chamado durante um ciclo sem interromper. Diagnostica sem alterar nada.
📋 Tabela rápida de referência
| Comando | Quando | Apaga arquivos? |
|---|---|---|
plan | Criar plano novo | não |
review | Auditar plano existente | não |
cancel | Parar ciclo em andamento | não |
restart | Reiniciar ciclo travado | parcial (state.yaml) |
rollback | Limpeza completa | SIM (com confirmação) |
status | Ver progresso | não |
doctor | Diagnóstico ambiente | não |
📌 Resumo
Próximo Módulo:
3.5 — 📁 Usando arquivos de escopo