O que é um git worktree e porque é importante para a orquestração?

Um worktree é uma cópia de trabalho do repositório num diretório separado, ligada a uma branch diferente. Permite que múltiplas instâncias de Claude trabalhem no mesmo projeto sem se interferirem — cada uma no seu próprio espaço, na sua própria branch. No final, fazes merge do trabalho. Sem worktrees, os agentes paralelos sobrescreveriam os ficheiros uns dos outros.

Quantas instâncias paralelas são ideais?

Os rendimentos decrescentes chegam geralmente com 2–3 instâncias paralelas. Mais de 3 instâncias simultâneas aumenta o custo de coordenação (teu e dos tokens) sem incremento proporcional de produtividade. A exceção são projetos com workstreams genuinamente independentes — frontend, backend, testes — onde 3–4 agentes produzem ganhos claros.

Como divido as tarefas entre agentes de forma eficaz?

A regra básica: cada agente precisa de um objetivo claro, contexto suficiente para trabalhar de forma autónoma e acesso apenas aos ficheiros que lhe correspondem. As melhores divisões são por camada (frontend/backend), por funcionalidade (auth/pagamentos/notificações) ou por fase (implementar/testar/documentar). Evita divisões onde os agentes precisem de editar os mesmos ficheiros.

O Agent Teams está pronto para produção?

O Agent Teams é experimental à data de publicação deste artigo. Funciona bem para casos de uso de investigação e desenvolvimento onde o overhead de coordenação é aceitável. Para projetos de produção com prazos, a recomendação é o subnível 2 (worktrees geridos manualmente) até que a funcionalidade amadureça.

O Nível 6 requer conhecimentos avançados de git?

Requer conforto com os conceitos básicos de git (branches, merge, conflitos) e a capacidade de resolver conflitos de merge. Não requer ser um especialista em git. O comando --worktree é simples; o mais complexo costuma ser gerir o merge final quando vários agentes trabalharam em áreas adjacentes.

Nível 6 — O Orquestrador

13 de março de 2026

Mentalidade: «Não és um programador — és um gestor»

O Nível 6 é o topo do programa. A mudança de mentalidade é radical: deixas de executar e começas a gerir. Não és a pessoa que faz o trabalho — és a pessoa que decide que trabalho se faz, quem o faz e quando se integra.

Geres sub-agentes como geriras uma equipa real. Atribuis-lhes tarefas específicas, dás-lhes contexto suficiente para trabalhar de forma autónoma e supervisas a integração do resultado. A IA não é a tua ferramenta — é a tua equipa.

Estás aqui quando...

Executas múltiplas sessões de Claude em paralelo no mesmo projeto
Usas worktrees para espaços de trabalho isolados e sem conflitos
Decides O QUÊ se faz — não COMO se faz
Geres sub-agentes e equipas de agentes como um team lead real
Fazes merge do trabalho paralelo no final de cada ciclo

Competências a dominar

Divisão de tarefas + planeamento de workstreams paralelos (auth / frontend / pagamentos em simultâneo)
Git worktrees (flag --worktree / -w) — cada agente tem a sua própria «secretária», merge no final
Gestão de sessões multi-terminal e switching de contexto
Agent Teams (experimental) — sub-agentes que comunicam entre si + um agente supervisor que coordena e te reporta

Os 4 subníveis de orquestração

Subnível 1 — Múltiplos terminais, mesma branch: Várias instâncias de Claude Code no mesmo projeto. Simples, mas com risco de conflitos se ambas editarem os mesmos ficheiros simultaneamente.
Subnível 2 — Git worktrees: Cada instância trabalha na sua própria branch/worktree. Sem conflitos. Merge no final. Mais técnico, mais limpo. Começa com: claude --worktree frontend, claude --worktree backend.
Subnível 3 — Sub-agentes via worktrees: Pedes a Claude que lance sub-agentes em worktrees separados automaticamente. Menos visível, mais abstraído — Claude gere a coordenação por ti.
Subnível 4 — Agent Teams (experimental): Sub-agentes que comunicam entre si + um agente supervisor. Ativar via settings.json. Maior custo de tokens por overhead de coordenação. Ideal para: funcionalidades paralelas, trabalho cross-layer, investigação, debugging.

A armadilha: Saltar os fundamentos

Sem os Níveis 1–5 dominados, obtês cinco agentes a produzir cinco versões de slop em simultâneo. Cada nível anterior alimenta este. Não há atalhos. Os rendimentos decrescentes também aparecem além de 2–3 instâncias paralelas — mais terminais não equivale a mais produtividade.

A orquestração amplifica o que já tens, para bem ou para mal. Se as tuas competências de contexto (Nível 3), seleção de ferramentas (Nível 4) e skills (Nível 5) são sólidas, a orquestração multiplica-as. Se são fracas, a orquestração multiplica essa fraqueza.

A jornada completa

Passaste de dar comandos a uma ferramenta → colaborar com um parceiro → curar contexto → equipar um especialista → codificar os teus workflows → gerir uma equipa que se gere a si própria.

Nível 1: Comando → Output
Nível 2: Planear → Colaborar
Nível 3: Curar → Contexto
Nível 4: Equipar → Ferramentas
Nível 5: Codificar → Workflows
Nível 6: Orquestrar → Escalar

Próximos passos

Chegar ao Nível 6 com uma equipa requer que os Níveis 1–5 estejam sólidos. Se quiseres acelerar esse caminho e garantir que a fundação é robusta, podemos desenhar o programa de formação completo para a tua equipa.

Perguntas frequentes

O que é um git worktree e porque é importante para a orquestração?: Um worktree é uma cópia de trabalho do repositório num diretório separado, ligada a uma branch diferente. Permite que múltiplas instâncias de Claude trabalhem no mesmo projeto sem se interferirem — cada uma no seu próprio espaço, na sua própria branch. No final, fazes merge do trabalho. Sem worktrees, os agentes paralelos sobrescreveriam os ficheiros uns dos outros.
Quantas instâncias paralelas são ideais?: Os rendimentos decrescentes chegam geralmente com 2–3 instâncias paralelas. Mais de 3 instâncias simultâneas aumenta o custo de coordenação (teu e dos tokens) sem incremento proporcional de produtividade. A exceção são projetos com workstreams genuinamente independentes — frontend, backend, testes — onde 3–4 agentes produzem ganhos claros.
Como divido as tarefas entre agentes de forma eficaz?: A regra básica: cada agente precisa de um objetivo claro, contexto suficiente para trabalhar de forma autónoma e acesso apenas aos ficheiros que lhe correspondem. As melhores divisões são por camada (frontend/backend), por funcionalidade (auth/pagamentos/notificações) ou por fase (implementar/testar/documentar). Evita divisões onde os agentes precisem de editar os mesmos ficheiros.
O Agent Teams está pronto para produção?: O Agent Teams é experimental à data de publicação deste artigo. Funciona bem para casos de uso de investigação e desenvolvimento onde o overhead de coordenação é aceitável. Para projetos de produção com prazos, a recomendação é o subnível 2 (worktrees geridos manualmente) até que a funcionalidade amadureça.
O Nível 6 requer conhecimentos avançados de git?: Requer conforto com os conceitos básicos de git (branches, merge, conflitos) e a capacidade de resolver conflitos de merge. Não requer ser um especialista em git. O comando --worktree é simples; o mais complexo costuma ser gerir o merge final quando vários agentes trabalharam em áreas adjacentes.