Spots

Claude Code: organize agentes em paralelo com Git Worktrees

Enquanto fazia o curso Claude Code: Software Engineering with Generative AI Agents, imaginei um produto mantido por várias squads: Checkout muda a criação do pedido, Pagamentos atualiza o status, Contas consome o evento e Plataforma prepara o pacote de release/homolog. Cada equipe cuida de uma parte, mas uma mudança compartilhada pode fazer essas frentes se atropelarem.

É como várias equipes numa oficina: cada uma

É como várias equipes numa oficina: cada uma precisa da própria vaga para desmontar um carro, mas todas ainda dependem do mesmo estoque de peças e da inspeção final. O curso me ajudou a perceber que a mesma disputa acontece entre agentes: duas sessões podem tentar trabalhar no mesmo checkout e misturar alterações. Os worktrees dão uma vaga isolada a cada sessão; o Claude Code Desktop torna essas frentes visíveis e aproxima branch, diff, PR e CI.

O Git cria o worktree; o mérito do

O Git cria o worktree; o mérito do harness do Claude Code é transformar essa capacidade num fluxo visual guiado e amarrar cada sessão ao seu diretório, branch e trabalho em andamento.

O Claude Code já oferece partes desse fluxo

O Claude Code já oferece partes desse fluxo no CLI, no Desktop e em comandos de orquestração. A oportunidade é conectá-las ao processo que cada squad usa e aos contratos que coordenam mudanças entre equipes. 1. O problema da squad não é criar branches

Squads grandes já sabem criar branches. O problema

Squads grandes já sabem criar branches. O problema aparece quando a quantidade de trabalho simultâneo cresce dentro da equipe: uma pessoa interrompe a feature para corrigir um incidente; outra precisa revisar um PR sem perder o estado local; um agente altera dependências enquanto outro mexe na mesma configuração; várias mudanças ficam prontas ao mesmo tempo e encontram a mesma fila de CI e review; uma migration, um lockfile ou um contrato compartilhado aproxima tarefas que pareciam independentes.

Entre squads, a colisão pode acontecer mesmo quando

Entre squads, a colisão pode acontecer mesmo quando ninguém edita o mesmo arquivo: uma squad muda a API enquanto outra ainda depende da versão anterior; um PR de infraestrutura precisa entrar antes dos PRs consumidores; dois repositórios avançam em ritmos diferentes dentro da mesma iniciativa; um pacote compartilhado não tem owner ou política de compatibilidade clara; a mudança passa no CI isolado de cada squad, mas falha quando os componentes se encontram.

Uma branch separa o histórico, mas um checkout

Uma branch separa o histórico, mas um checkout tradicional continua ocupando um único working directory. Trocar de branch muda os arquivos daquela pasta. Para trabalho humano sequencial, isso costuma bastar. Para sessões paralelas de coding agents, o diretório compartilhado vira um gargalo. Um worktree acrescenta o isolamento físico:

Cada diretório tem seus próprios arquivos e sua

Cada diretório tem seus próprios arquivos e sua própria branch, enquanto todos compartilham o histórico do mesmo repositório.

Isso não elimina conflito de merge nem coordena

Isso não elimina conflito de merge nem coordena contratos entre squads. O que ele elimina é uma classe anterior de colisão: duas tarefas modificando o mesmo checkout enquanto ainda estão sendo executadas. 2. A camada visual que organiza o trabalho paralelo

Git worktree não foi inventado pelo Claude Code

Git worktree não foi inventado pelo Claude Code. O diferencial do Claude Code Desktop está em incorporar essa capacidade nativa do Git a uma interface que torna o trabalho paralelo compreensível e revisável.

News

Claude Code: organize agentes em paralelo com Git Worktrees

Enquanto fazia o curso Claude Code: Software Engineering with Generative AI Agents, imaginei um produto mantido por várias squads: Checkout muda a criação do pedido, Pagamentos atualiza o status…

@spots #dev
Source: Dev.to
See more like this