AVDR
Guia do mapa
Como usar
O que é. Três partes: o problema de pôr dois agentes no mesmo lugar, as 3 regras da minha operação e o passo a passo para rodar a sua frota.
Por onde começar. Com 2 frentes, não com 10. Quando juntar 2 ficar tranquilo, abra a terceira.
Três palavras antes. Frente é uma tarefa com começo, meio e fim, tocada por um agente. Cópia isolada é uma pasta separada do mesmo projeto, onde só aquele agente mexe (no Git, o nome é worktree). Junção é trazer o que foi feito na cópia de volta para a versão principal (no Git, merge).
Parte 1. O problema: dois agentes no mesmo arquivo
Pôr dois agentes para trabalhar na mesma pasta ao mesmo tempo é como duas pessoas editando o mesmo documento sem saber uma da outra. Uma salva por cima da outra, e ninguém percebe até quebrar.
Mais agentes não resolvem sozinhos. O que resolve é a regra de quem mexe em quê.
Parte 2. As 3 regras que fazem funcionar
Na minha operação, em 15/09/2026, às 17h21, havia 61 frentes de IA abertas ao mesmo tempo, cada uma na sua cópia isolada.
- Cada agente trabalha numa cópia isolada do projeto e só mexe no que é seu. Antes de começar, a frente declara o que vai alterar. Se descobrir que precisa mexer em algo de outra frente, pausa essa parte e pede.
- A junção é uma de cada vez. As frentes andam juntas, mas voltam para a versão principal em fila: junta uma, confere, junta a próxima. Arquivo que todas usam, como as regras gerais, só muda na hora da junção.
- Nada vai ao ar sem aprovação. Juntar não é publicar. Publicar e enviar para o repositório na internet dependem da minha aprovação explícita.
Fora do computador vale a mesma regra. Um sistema externo, como uma automação, um domínio ou uma conta de anúncio, tem um único agente mexendo por vez. Ler pode ser em paralelo.
Libere a parte 3
Deixe seu e-mail e abra agora o passo a passo para rodar a sua frota, com os comandos e o texto pronto para colar. Sem spam: só os próximos guias.
Parte 3. Rode a sua frota, passo a passo
Antes de começar.
- O projeto precisa estar no Git e ter pelo menos um commit (uma versão salva). Sem commit, a cópia isolada não é criada.
- Claude Code instalado. O passo a passo oficial está em code.claude.com/docs/en/setup.
- Se o seu trabalho é documento e não código, a regra vale igual: cada frente com o seu arquivo e uma junção por vez.
Passo 1. Liste as frentes e o que cada uma pode alterar
Uma linha por frente: o que entrega e o que pode alterar. Duas frentes que precisam do mesmo arquivo não andam juntas: uma espera a outra.
Passo 2. Abra cada frente numa cópia isolada
No terminal, dentro do projeto, um comando por frente, cada um no seu terminal:
claude --worktree cadastro-novo
O Claude Code cria a cópia em .claude/worktrees/cadastro-novo/, num ramo novo chamado worktree-cadastro-novo, e abre a conversa lá dentro. Para a segunda frente, abra outro terminal e troque o nome.
Coloque .claude/worktrees/ no arquivo .gitignore, para as cópias não aparecerem como arquivos soltos no projeto principal. A cópia começa limpa: peça ao Claude para instalar o que o projeto precisa.
Sem o Claude Code, só com o Git, este comando cria a cópia na pasta ao lado, num ramo novo com o nome da pasta:
git worktree add ../projeto-cadastro-novo
Fonte: code.claude.com/docs/en/worktrees e git-scm.com/docs/git-worktree
Passo 3. Escreva a regra no CLAUDE.md
O CLAUDE.md é o arquivo de instruções que o Claude lê no começo de toda conversa. Cole este bloco nele:
## Frentes em paralelo - Cada frente trabalha só na própria cópia isolada. Nunca edite a pasta principal do projeto. - No começo, declare em uma linha o que esta frente vai alterar. Não saia dessa lista sem me perguntar. - Se precisar mexer em algo de outra frente ou num arquivo que todas usam, pare essa parte e me avise. - Sistema externo (automação, site no ar, conta de anúncio): só uma frente mexe por vez. Ler pode. - Terminou: rode os testes na cópia, me mostre o que mudou e espere. A junção na versão principal é uma de cada vez, e quem manda juntar sou eu. - Juntar não é publicar. Publicar ou enviar para o repositório na internet só com o meu "pode".
Passo 4. Junte uma frente de cada vez
- Escolha a frente que terminou.
- Veja o que mudou e rode os testes na cópia.
- Junte na versão principal. Pode pedir ao Claude Code: ele junta e mostra o resultado.
- Rode os testes de novo na versão principal. Passou: próxima frente. Quebrou: conserte antes de juntar outra.
- Arquivo que todas as frentes usam se resolve contra a versão mais nova, na hora da junção.
Passo 5. Veja e limpe as cópias
Para listar as cópias abertas:
git worktree list
Ao sair de uma conversa aberta com --worktree, o Claude Code apaga sozinho a cópia que ficou sem mudança (se a sessão tiver nome, ele pergunta antes) e pergunta o que fazer quando há trabalho nela.
Para remover uma cópia na mão:
git worktree remove ../projeto-cadastro-novo
O Git só remove cópia limpa, sem arquivo alterado ou novo. Com trabalho dentro, ele recusa: junte ou descarte antes.