Agent Teams

Este é o mergulho profundo em Agent Teams. Para setup básico, veja Integração Claude Code.

Agent Teams é a capacidade principal. Com Agent Teams habilitado, o Claude Code pode coordenar múltiplos workers paralelos implementando sua especificação simultaneamente.

Defina a variável de ambiente:


export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Execute specforge init (ou re-execute com --force se já inicializado). A CLI gera arquivos de orquestração de Agent Teams:

Arquivo	Papel
`orchestrator.md`	Lê a especificação, analisa o grafo de dependência, atribui tickets a workers, monitora progresso
`worker.md`	Implementa um único ticket — lê contexto, escreve código, roda testes, reporta resultados
`validator.md`	Revisa trabalho completado — verifica critérios de aceite, roda suítes de teste, sinaliza problemas
`conventions.md`	Regras compartilhadas para estilo de código, mensagens de commit, nomes de branch, estrutura de PR

Depois inicie o Claude Code e diga:


Implement the active SpecForge specification

O orquestrador lê sua spec, identifica tickets acionáveis (todas dependências satisfeitas), cria workers por épico e coordena execução paralela. Validadores verificam cada ticket completado. O grafo de dependência garante que workers nunca colidam.

ℹ️ Agent Teams é uma funcionalidade do Claude Code (Opus 4.6+, experimental). O SpecForge não constrói sua própria orquestração em cima do Claude Code — ele gera a configuração que faz o Agent Teams funcionar com seu grafo de dependência pronto para uso.