Espaços de trabalho (worktrees)

Em breve

Por que cada tarefa vive na sua própria cópia do código e como um espaço de trabalho é criado, usado e apagado.

No Taller, cada tarefa tem o seu próprio espaço de trabalho. Por dentro, é um worktree do git: uma cópia do repositório no seu disco, com a sua própria branch. Em vez de trocar de branch e guardar mudanças pela metade numa única pasta, cada tarefa tem a sua. Por isso vários agentes podem trabalhar ao mesmo tempo sem pisar nos arquivos uns dos outros.

É a mesma regra que a plataforma segue: cada tarefa da equipe de agentes é visível e tem o seu próprio espaço e a sua própria branch.

Como funciona

Cada projeto tem um ponto de partida (normalmente a branch principal).
Cada espaço de trabalho nasce de uma branch ou de um commit que você escolhe.
Cada espaço tem a sua branch, seus arquivos e seus terminais com agentes.
Apagar um espaço remove a pasta e a branch, sempre com confirmação.

O ciclo de uma tarefa

Criar: nome da tarefa, de onde começar e, se você quiser, o link para o problema ou para a mudança relacionada.
Trabalhar: terminais com agentes, editor e navegador, tudo dentro desse espaço.
Revisar: o diff contra o ponto de partida, com comentários por linha.
Entregar: salvar, enviar e abrir a revisão, sem sair do Taller.
Arquivar ou apagar: um clique remove o espaço e a sua branch.

De onde começar

Ao criar um espaço, você pode partir de:

A branch principal do projeto (o mais comum).
Outra branch local, para empilhar trabalho sobre uma mudança que ainda está em revisão.
Um commit específico.
Uma branch remota, que o Taller baixa para você.

Arquivos que o git não guarda

Um espaço novo é uma cópia limpa: não traz as dependências instaladas, os caches nem os arquivos de segredos locais que o git ignora. Para não refazê-los toda vez, você pode:

Compartilhar pastas pesadas (como node_modules) entre espaços, por link.
Copiar arquivos específicos (como .env.local) para cada espaço novo com um arquivo .worktreeinclude na raiz do projeto:

# .worktreeinclude
.env.local
.vscode/settings.json

Nome da branch

Por padrão, o Taller cria o nome da branch a partir do nome que você dá à tarefa. Se você precisa de um nome exato (por exemplo feat/pagos), escreva nas opções avançadas ao criar o espaço.

Onde roda

Um espaço pode viver no seu computador ou em outra máquina. Veja servidores remotos e SSH.