Criação de Sessões e Colaboração no Git

Duas funcionalidades que atuam em conjunto: criar subtarefas em sessões filhas independentes com vspawn (opcionalmente em worktrees git isolados) e uma fusão gráfica para reunir ramificações paralelas. Juntas, elas tornam “vários agentes trabalhando no mesmo repositório em paralelo” um fluxo de trabalho cotidiano.

1. O que é a criação de sessões

De dentro de qualquer sessão, divida um subtarefa: VelaTerm cria uma nova sessão filha ** sob ** o nó atual (a árvore se torna hierárquica: pai → filho → neto), opcionalmente fornece um worktree git isolado e insere a descrição da tarefa como a primeira mensagem **** da nova sessão — o novo agente começa a trabalhar assim que é iniciado, sem necessidade de reexplicação.

O que você obtém é uma sessão real na árvore — com seu próprio processo, totalmente interativo e capaz de ser retomado — que pode ser observada ou acessada a qualquer momento. Não se trata de uma tarefa em segundo plano oculta.

2. Quatro pontos de entrada

Os dois comandos de terminal são injetados automaticamente no PATH de cada sessão — sem necessidade de instalação.

Pré-requisito para as habilidades /: antes que o Claude possa usar /vspawn ou /vspawn-tree (ou criar subtarefas por iniciativa própria), ative Habilidades Vela em Configurações ▸ Geral. Isso instala as habilidades /vspawn, /vspawn-tree e /vopen como um pacote em ~/.claude/skills/; elas são atualizadas automaticamente com as atualizações do app. Após ativar, inicie uma nova sessão do Claude (ou reinicie uma existente) para que o agente as reconheça. Sem isso, o Claude simplesmente não conhece esses comandos — apenas os vspawn / vspawn-tree digitados no terminal funcionam.

3. Confirmação antes da criação

Por padrão, toda criação exibe primeiro um cartão de confirmação (no canto superior direito, não modal, sem roubar o foco):

• Três campos editáveis: o prompt **** (multi-linha), o tipo de agente **** (padrão é o do pai) e worktree git separado.
• “Iniciar” começa a sessão filha; “Cancelar” descarta o pedido. Quando um agente cria várias ao mesmo tempo, os cartões são processados um por um (o contador restante é exibido no cartão).
• Se preferir pular a confirmação completamente, desative “Confirmar antes da criação” em Configurações ▸ Comportamento.

4. Worktrees: paralelismo sem interferências

Com a opção de worktree ativada, a sessão filha trabalha em um novo ramo em seu próprio diretório de trabalho — isolado do espaço de trabalho principal e dos outros filhos. Essa é a estrutura ideal para paralelismo multi-agente. O gerenciamento fica no menu de contexto da sessão, em “Worktree ▸”: visualizar alterações, copiar/abrir a pasta do worktree, excluir o worktree (com opção de forçar a eliminação de alterações não commitadas).

A criação a partir de um diretório que não é git ainda funciona; nesse caso, ela recorre ao compartilhamento do diretório do pai, sem worktree.

5. Fusão: fusão gráfica Git

Quando o trabalho estiver concluído, faça a fusão. Qualquer sessão cujo diretório de trabalho seja um repositório git (com ou sem worktree): clique com o botão direito → “Git ▸ Fusão…” para abrir a caixa de diálogo de fusão:

• **Você escolhe tanto o ramo de origem quanto o de destino **, e pode trocar a direção — fundir o ramo da sessão filha de volta ao principal, ou trazer o principal para a filha para atualizar seu ponto de referência, tudo a partir da mesma caixa de diálogo.
• A fusão é executada no worktree onde o ramo de destino está checkado; se o worktree de origem tiver alterações não commitadas, elas são commitadas primeiro para que nada se perca.
• Em caso de conflito, a cena é mantida no lugar para que você (ou um agente) resolva no terminal e continue.

A fusão não exclui automaticamente o worktree — limpe-o posteriormente por meio de “Worktree ▸ Excluir worktree…” assim que tiver certeza.

6. Um fluxo de trabalho típico

1. Na sessão principal, peça ao Claude para analisar a tarefa e, em seguida, /vspawn-tree refactor the checkout module para criá-la (requer Habilidades Vela — veja §2).
2. Revise o prompt no cartão de confirmação e clique em Iniciar — a sessão filha começa em seu próprio worktree, visível na barra lateral abaixo do pai, com um ponto que fica verde.
3. Continue trabalhando na sessão principal; quando a sessão filha fizer alguma pergunta ou concluir, seu ponto fica amarelo e é exibida uma notificação.
4. Acesse-a para revisar, depois clique com o botão direito → “Git ▸ Fusão…” para fundir seu ramo de volta ao principal.
5. Use “Worktree ▸ Excluir worktree…” para limpar, e arquive a sessão filha como registro.