Agentes diferentes não devem pegar a mesma árvore.

Um problema difícil com agentes paralelos

s09-s11 permite que você inicie vários companheiros de equipe ao mesmo tempo, mas há uma armadilha: Eles estão todos no mesmo diretório de trabalho. Alice está alterando auth.py e Bob também está alterando auth.py ao mesmo tempo - conflitos de git, confusão de arquivos e contaminação mútua de testes.

A solução para s12 é git worktree: no mesmo warehouse, você pode fazer check-out de diferentes ramificações em diretórios diferentes por meio de git worktree add. Cada agente obtém sua própria árvore de trabalho e trabalha em seu próprio diretório, invisíveis entre si.

my-repo/ # Espaço de trabalho principal (para lead)
.worktrees/
  alice-auth/ #diretório de isolamento de alice
    (ramo: wt/alice-auth)
  bob-api/ #diretório de isolamento do bob
    (ramo: wt/bob-api)
  index.json # registro da árvore de trabalho
  events.jsonl #Registro de eventos do ciclo de vida

Divisão do trabalho em dois planos

s12 Divida explicitamente o sistema em dois planos:

• Plano de controle: arquivo JSON em .tasks/. Tarefa é uma unidade abstrata de "o que fazer", incluindo dependências, proprietário e status.
• Plano de execução: diretório em .worktrees/. Worktree é o contêiner físico de "onde fazer", um diretório + uma ramificação.

Os dois são vinculados bidirecionalmente por meio de task.worktree e worktree.task_id.

Esse tipo de desacoplamento permite: Reutilizar o mecanismo de gerenciamento de tarefas, mas alterar o ambiente de execução (por exemplo, não git worktree, mas docker container). Ou altere o mecanismo de tarefa, mas reutilize a árvore de trabalho (por exemplo, não um arquivo JSON, mas um banco de dados).

demonstração do ciclo de vida

Veja tudo abaixo: criar tarefa → criar árvore de trabalho → executar comandos → manter ou remover. Cada etapa possui um registro de log de eventos (events.jsonl), que é usado para observabilidade na produção.

keep vs remove

Existem dois finais quando o worktree completa sua missão:

• remove: git worktree remove --force, exclua o diretório. Os galhos também são geralmente limpos. É equivalente a “Não quero mais essa exploração”.
• keep: marque apenas status: mantido em .worktrees/index.json e o diretório físico será mantido. É equivalente a "Vou conseguir esse resultado, espere até mesclá-lo".

Modo comum: o subagente executa um refator experimental → executa com bons resultados → manter → revisão humana → mescla no branch principal → remove manualmente. Efeito ruim? Basta remover e jogar fora.