Verboo Code: como planejar antes de codar com /plan

Você pede uma mudança que mexe em seis arquivos, o agente sai editando, e só no terceiro arquivo você percebe que ele escolheu uma abordagem que você não queria. O /plan da Verboo Code evita isso: o agente primeiro lê o projeto e escreve um plano num arquivo, e só começa a editar depois que você aprova. Este guia mostra os comandos, onde o plano fica salvo e as opções do diálogo de aprovação.

O que o /plan faz na Verboo Code?

Ele liga o modo de planejamento na sessão atual. Nesse modo o agente explora o código, desenha a abordagem e grava o plano num arquivo Markdown, em vez de sair editando o projeto. A descrição no código é literal: "Enable plan mode or view the current session plan".

/plan

A CLI responde Enabled plan mode. Daí em diante, descreva a tarefa normalmente. O modo vale só para a sessão em que você ligou.

Como ver o plano que o agente escreveu?

Rode /plan de novo, já dentro do modo. A CLI mostra o plano atual com o caminho do arquivo. Se o agente ainda não escreveu nada, a resposta é Already in plan mode. No plan written yet.

/plan

Para editar na mão, use /plan open: ele abre o arquivo do plano no seu editor externo. Funciona quando já existe um plano escrito. Mexeu no texto, salvou, fechou: o agente trabalha a partir da versão que está no disco.

/plan open

Onde o plano fica salvo?

Num arquivo .md com nome de três palavras sorteadas (adjetivo, verbo e substantivo), dentro de ~/.verboo/plans/. Se você define VERBOO_CONFIG_DIR, a pasta plans/ fica dentro dele.

Configuração	Onde o plano vai parar
Padrão	~/.verboo/plans/<nome-sorteado>.md
VERBOO_CONFIG_DIR definido	$VERBOO_CONFIG_DIR/plans/
plansDirectory no settings.json	A pasta indicada, relativa à raiz do projeto

A configuração plansDirectory serve para versionar os planos junto com o código. Ela precisa apontar para dentro do projeto: se o caminho sair da raiz, a CLI ignora e volta para a pasta padrão.

{
  "plansDirectory": "docs/plans"
}

Como aprovar o plano e deixar o agente codificar?

Quando o plano está pronto, o agente chama a ferramenta interna ExitPlanMode, que abre o diálogo de aprovação com o plano na tela. Ela só pede aprovação para tarefas que envolvem escrever código: se você pediu só uma pesquisa pelo projeto, o agente responde direto, sem diálogo.

As opções do diálogo, como estão no código (os rótulos aparecem em inglês na CLI):

Opção	O que acontece
Yes, clear context ... and auto-accept edits	Limpa o contexto (mostra quanto já estava usado), aprova e libera as edições sem pedir uma a uma
Yes, auto-accept edits	Mantém o contexto e libera as edições sem pedir uma a uma
Yes, manually approve edits	Mantém o contexto e continua pedindo permissão a cada edição
No, keep planning	Recusa o plano, você escreve o que mudar e o agente refaz

Dependendo do que está habilitado na sua instalação, o rótulo da liberação muda: em vez de auto-accept edits pode aparecer use auto mode ou bypass permissions. A opção de limpar o contexto só aparece quando faz sentido limpar. Dois atalhos úteis no diálogo: Ctrl+G abre o plano no editor para você ajustar antes de aprovar, e Shift+Tab aprova direto com auto-accept edits.

Como entrar no modo de planejamento sem digitar /plan?

De dois jeitos. O primeiro é o Shift+Tab, que alterna os modos de permissão da sessão. No código, a ordem a partir do modo padrão é default, acceptEdits e plan; depois do plan ele segue para outro modo ou volta ao padrão, conforme o que estiver disponível.

O segundo é já abrir a sessão em modo de planejamento, com a flag --permission-mode:

verboo --permission-mode plan

Também dá para fixar como padrão com defaultMode no settings.json, mas para a maioria das tarefas ligar o plano sob demanda é mais prático. O próprio agente tem uma ferramenta para propor a entrada em plan mode quando a tarefa parece grande, e nesse caso você aprova ou recusa.

O plano sobrevive se eu fechar e retomar a sessão?

Sim, na maior parte dos casos. Ao retomar uma sessão, a Verboo Code reaplica o mesmo arquivo de plano àquela sessão. Se o arquivo sumiu do disco, ela tenta recuperar o conteúdo a partir dos snapshots e do histórico da conversa.

Isso combina com o /resume: você planeja hoje, fecha, e amanhã continua do mesmo plano. Se a conversa ficar longa durante a execução, o /compact resume o histórico sem perder o arquivo do plano, que fica no disco.

Quando usar /plan e quando não usar?

Use quando a mudança toca vários arquivos, tem mais de uma abordagem possível ou o requisito está meio solto: nova funcionalidade, refatoração, mudança de arquitetura. Não use em ajuste pequeno, como renomear uma variável ou corrigir um typo; o plano só adiciona uma volta.

• Use /plan quando um erro de rumo custaria desfazer vários arquivos.
• Combine com o /goal para a execução longa depois do plano aprovado.
• Se algo sair do trilho mesmo assim, o /rewind desfaz a edição.
• Para controlar o que o agente pode rodar, veja o /permissions.