Planejamento e Execução

Um fluxo de planejamento e execução divide um trabalho entre duas funções: uma sessão de planejamento, que prepara e revisa o trabalho, e uma ou mais sessões de execução, que o realizam. Este capítulo trata de como iniciar um fluxo pelo menu ou a partir de uma sessão, revisar uma divisão em tarefas, escolher os diretórios de trabalho e acompanhar o progresso do fluxo.

1. Como o fluxo funciona

Um fluxo tem duas funções, e cada uma é executada como uma sessão própria na barra lateral:

• Planejamento e revisão. A sessão de planejamento estuda a tarefa e o projeto, escreve as instruções para a sessão de execução e revisa cada resultado. Ela pede correções até que o resultado seja aceitável e só o aceita depois de conferir as alterações reais e as evidências de verificação.
• Execução. A sessão de execução implementa as instruções e envia um relatório. As correções vão para a mesma sessão de execução, que mantém o contexto entre as rodadas.

A sessão de execução aparece como filha da sessão de planejamento na barra lateral. As duas sessões são executadas na visão de conversa. As mensagens trocadas entre as funções mostram o ícone do agente, o nome da sessão e a função de quem as enviou ("Planejamento" ou "Execução"), para que você acompanhe a troca em qualquer uma das conversas.

As duas funções precisam de um agente compatível com a visão de conversa: Claude Code, Codex, OpenCode, Pi ou OMP. As sessões de planejamento e de execução podem usar agentes, modelos e esforços de raciocínio diferentes.

Você pode ler, responder ou interromper qualquer uma das sessões a qualquer momento. As solicitações de permissão de qualquer uma das funções continuam aguardando a sua resposta.

2. Início pelo menu

Abra o menu de contexto de um projeto, grupo ou sessão, ou o submenu "Nova sessão filha" dele, e escolha "Nova sessão de planejamento/execução…". A caixa de diálogo contém:

• "Criar em": onde a sessão de planejamento será criada. A sessão de execução é criada abaixo dela.
• "Instruções da tarefa": descreva a tarefa, os requisitos e os critérios de aceitação. Você pode colar imagens; elas são enviadas com a tarefa da sessão de planejamento e com as primeiras instruções da sessão de execução.
• "Dividir automaticamente em várias tarefas": consulte o §4.
• "Planejamento e revisão" e "Execução": o agente ("Tipo de sessão"), o "Modelo" e o "Esforço de raciocínio" de cada função. As opções de modelo e de esforço vêm do agente selecionado. A caixa de diálogo lembra suas últimas escolhas para cada função.
• "Caminho do diretório de trabalho" e a escolha do diretório: consulte o §5.

Escolha "Criar e iniciar" para iniciar a sessão de planejamento. Ela cria a sessão de execução quando o plano estiver pronto. Abrir ou cancelar a caixa de diálogo não cria nada. A caixa de diálogo tem endereço próprio, então você pode copiar o link, atualizar a página ou usar os botões de voltar e avançar sem perdê-la.

3. Início a partir de uma sessão

Dentro de qualquer sessão iniciada pelo VelaTerm, execute:

vspawn --plan-execute \
  --plan-agent claude --plan-model opus --plan-effort high \
  --exec-agent codex --exec-model gpt-5.5 --exec-effort medium \
  "Implement the agreed changes and verify all acceptance criteria"

No Claude Code, /vspawn --plan-execute <task> faz o mesmo; no Codex, use $vspawn --plan-execute <task>. A habilidade escreve uma tarefa autossuficiente com base na conversa atual antes de iniciar o fluxo. Essas habilidades exigem as Vela Skills (Configurações ▸ Geral).

A nova sessão de planejamento é criada abaixo da sessão que executou o comando. A solicitação abre primeiro o cartão de confirmação descrito em Criação de Sessões e Colaboração no Git §4, onde você pode revisar e alterar a tarefa e as configurações das duas funções.

Sem um agente explícito, uma sessão de planejamento iniciada a partir de uma sessão de Claude, Codex, OpenCode, Pi ou OMP usa o mesmo agente; a partir de qualquer outra sessão, usa o Claude Code. Um modelo ou esforço que o agente selecionado não aceita é rejeitado antes que qualquer sessão seja iniciada.

As novas sessões não veem a conversa que deu origem ao fluxo. Inclua na tarefa as decisões tomadas até o momento, as alterações existentes, as restrições e o local de entrega exigido.

4. Divisão em várias tarefas

Ative "Dividir automaticamente em várias tarefas" na caixa de diálogo ou adicione --split-tasks a vspawn --plan-execute. A sessão de planejamento então investiga o trabalho e propõe de 1 a 12 tarefas independentes. Nenhuma sessão de execução é iniciada até que você confirme as tarefas.

A proposta abre a caixa de diálogo "Revisar tarefas de execução":

• Selecione uma tarefa na lista para editar o "Nome da sessão", as "Instruções da tarefa", o agente, o "Modelo" e o "Esforço de raciocínio" dela. Suas edições são mantidas quando você alterna entre as tarefas.
• "Remover tarefa" descarta uma tarefa; "Desfazer remoção" a traz de volta. Pelo menos uma tarefa precisa permanecer.
• O botão de início ("Iniciar N sessões") cria uma sessão de execução para cada tarefa.
• Fechar a caixa de diálogo deixa a proposta aguardando. Um link "Revisar tarefas de execução" permanece na tela para reabri-la. Cancelar a proposta interrompe o fluxo sem criar sessões de execução.
• A caixa de diálogo tem endereço próprio e continua disponível após uma atualização da página; as edições ainda não confirmadas são perdidas na atualização.

Quando a habilidade é usada com divisão em tarefas, ela adiciona --yes para que apenas essa revisão final apareça. A revisão pode alterar as configurações de cada sessão de execução, mas não as da sessão de planejamento, que já está em execução.

Uma única sessão de planejamento recebe os relatórios de todas as sessões de execução e revisa cada tarefa separadamente, com rodadas de correção próprias. O fluxo como um todo só é concluído depois que todas as tarefas forem aceitas.

Divida o trabalho em tarefas que não editem os mesmos arquivos. Cada sessão de execução roda o próprio processo de agente, então escolha o número de tarefas levando em conta os recursos da máquina.

5. Diretórios de trabalho e worktrees

A escolha do diretório vale para todas as funções do fluxo:

Os novos worktrees partem do commit atual e não incluem alterações não commitadas. Se não for possível criar um worktree, a sessão afetada não é iniciada; ela não passa a usar outro diretório. Na linha de comando, --worktree sozinho equivale a shared.

Os resultados ficam nos worktrees até você fazer o merge. Use "Git ▸ Merge…" em uma sessão para fazer o merge de uma branch (consulte Criação de Sessões e Colaboração no Git §6). O fluxo não faz merge, push nem exclusão de worktrees por conta própria.

6. Acompanhamento do progresso

• A conversa de planejamento mostra cada relatório e cada correção à medida que acontecem. Enquanto as sessões de execução trabalham, a sessão de planejamento aguarda os relatórios delas.
• vflow status <workflow-id> mostra o estado de um fluxo, as tarefas, as sessões e a rodada atual. O ID do fluxo aparece nas mensagens do fluxo.
• vflow stop <workflow-id> impede novas rodadas e pede que as sessões em execução parem. Parar o fluxo inteiro interrompe as tarefas dele; parar uma tarefa não afeta as demais.
• vstat mostra quais sessões estão trabalhando, pedindo permissão ou aguardando. Uma sessão de execução em espera não terminou necessariamente a tarefa; só a aceitação pela sessão de planejamento conta como conclusão.
• Se uma função encerrar o turno sem repassar o trabalho, o fluxo fica bloqueado. Verifique a conversa, responda ao que for necessário e continue a partir da sessão de planejamento.

Os comandos estão descritos em Comandos de Sessão.