Git worktree é um recurso do Git que cria cópias de trabalho adicionais de um repositório em diretórios separados. Cada worktree pode estar em uma branch diferente, mas todas compartilham o mesmo histórico de commits e objetos do Git. Isso permite trabalhar em várias branches ao mesmo tempo sem precisar clonar o repositório várias vezes.
Como funciona
Quando você cria um worktree com o comando git worktree add, o Git cria um novo diretório com os arquivos da branch escolhida. Esse diretório é uma cópia de trabalho independente: você pode editar, compilar e testar sem afetar outros worktrees. Por baixo, todos os worktrees apontam para o mesmo repositório .git, então commits feitos em um aparecem para os outros.
A vantagem é economia de espaço e tempo. Em vez de clonar o repositório inteiro para cada branch, você cria worktrees leves que compartilham objetos. Quando termina o trabalho em um worktree, basta removê-lo com git worktree remove.
Exemplo prático
Um desenvolvedor precisa revisar um pull request enquanto continua trabalhando na feature atual. Em vez de fazer stash ou clonar o repositório, cria um worktree para a branch do PR. Os dois trabalhos ficam isolados em diretórios diferentes, e ambos podem ser compilados e testados ao mesmo tempo.
No contexto de agentes de código, worktrees são especialmente úteis. Cada agente pode receber um worktree próprio para trabalhar em uma tarefa sem sobrescrever o código dos outros. Isso evita conflitos e permite rodar vários agentes em paralelo no mesmo projeto.
Para que serve
Git worktree permite paralelismo real no desenvolvimento. No bridgecode, cada agente de um squad pode operar em um worktree isolado, executando e testando mudanças sem pisar no código dos outros agentes. Isso torna a orquestração de agentes mais segura e rastreável.