Implementação Autônoma

Use execução paralela orquestrada para implementar uma especificação SpecForge inteira de forma autônoma.

É aqui que o SpecForge muda o que um único desenvolvedor consegue fazer. Em vez de implementar tickets um por um, você diz ao seu agente de código para implementar uma especificação inteira. Ele lê o plano, coordena workers paralelos, e eles implementam, validam e reportam — enquanto você monitora o progresso pelo painel.

O resultado: uma especificação com 15+ tickets, totalmente implementada em branches, com commits vinculados e gates de qualidade aprovados. Em uma única work session.

💡 A implementação autônoma assume que sua especificação já está planejada e validada. Se você ainda não criou e refinou sua especificação, comece com Primeira Especificação.

Pré-requisitos

Antes de começar:

• Um agente de código com capacidades de equipe/paralelo (ex.: Claude Code com Agent Teams)
• CLI do SpecForge configurada no seu repositório (specforge init concluído)
• Uma especificação com tickets em status ready
• Chave de API autenticada (specforge login)

Habilitar Agent Teams (Claude Code)

Durante o specforge init, a configuração de Agent Teams é gerada automaticamente quando o Claude Code é detectado. Verifique em .specforge/config.json:

{
  "projectId": "proj_abc123",
  "specificationId": "spec_xyz789",
  "agentTeams": {
    "enabled": true,
    "strategy": "auto",
    "maxTicketsPerTeam": 5,
    "maxParallelEpics": 3,
    "branchPrefix": "ticket/"
  }
}

Defina a variável de ambiente antes de iniciar o Claude Code:

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

ℹ️ Agent Teams é uma funcionalidade do Claude Code (Opus 4.6+, experimental). O SpecForge gera os agentes, skills e configuração de orquestração para que o Agent Teams funcione com seu grafo de dependência pronto para uso.

O Fluxo

1. Inicie Seu Agente de Código

Abra o Claude Code (ou seu agente preferido) no seu repositório.

2. Dê a Instrução

Implement the active SpecForge specification

Só isso. Uma frase.

3. O Que Acontece a Seguir

O agente lê a configuração do SpecForge e executa um fluxo estruturado:

1. Carregar especificação — Busca a especificação completa, épicos, tickets e grafo de dependência via MCP
2. Analisar dependências — Identifica o caminho crítico e determina quais épicos podem rodar em paralelo
3. Apresentar plano de implementação — Mostra o que pretende fazer, em que ordem, e pede confirmação
4. Criar equipes de workers — Uma equipe por épico (ou por lote de tickets, dependendo da estratégia)
5. Workers implementam — Cada worker pega tickets, escreve código, roda testes e reporta resultados
6. Gates de qualidade — Um validador verifica cada implementação contra os critérios de aceite
7. Relatórios de progresso — Status dos tickets atualizam em tempo real no painel do SpecForge

⚠️ Sempre revise o plano de implementação antes de confirmar. O orquestrador mostra o escopo completo — número de equipes, atribuições de tickets, estratégia de branches — antes de escrever qualquer código.

4. Monitore pelo Painel

Enquanto os agentes trabalham, o painel do SpecForge atualiza em tempo real:

• Tickets transitam de ready para in_progress para in_review para done
• Logs de sessão mostram qual agente está trabalhando em quê
• O grafo de dependência destaca caminhos concluídos
• Tickets bloqueados são desbloqueados automaticamente conforme dependências são resolvidas

Opções de Configuração

strategy

Controla como o orquestrador distribui o trabalho:

maxTicketsPerTeam

Quantos tickets um único worker lida antes do orquestrador criar uma nova equipe. Intervalo: 1 a 20. Valores menores significam workers mais focados. Valores maiores reduzem overhead de troca de contexto.

maxParallelEpics

Número máximo de épicos rodando ao mesmo tempo. Intervalo: 1 a 10. Limitado pelos recursos da sua máquina e pelos limites de concorrência do seu agente.

branchPrefix

Prefixo para branches git criadas durante a implementação:

Consciência de Tokens

A execução paralela consome significativamente mais tokens que o trabalho sequencial. Um guia aproximado:

• 1 equipe ≈ 1x uso de tokens base
• 3 equipes paralelas ≈ 3-4x base
• 5 equipes paralelas ≈ 5-6x base

✅ Comece com maxParallelEpics: 1 para entender o consumo de tokens para seu codebase antes de escalar.

Pré-visualizar Antes de Commitar

Execute um dry run para ver o plano de execução sem implementar nada:

specforge plan

Isso exibe: número de épicos e tickets a implementar, atribuições propostas de equipe, ordem de execução baseada em dependências, nomes de branch estimados e qualquer ticket bloqueado ou pré-requisito faltando.

Revise isso antes de executar a implementação completa.

Juntando Tudo

A sequência completa, do zero à implementação autônoma:

# 0. Planeje sua especificação (webapp ou via MCP)
#    Certifique-se de que o planning review passou
 
# 1. Configure o projeto
specforge init
 
# 2. Defina a variável de ambiente (Claude Code)
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
 
# 3. Pré-visualize o plano
specforge plan
 
# 4. Inicie seu agente de código e diga:
#    "Implement the active SpecForge specification"
 
# 5. Revise o plano, confirme e monitore pelo painel

Esta é a implementação autônoma. Uma especificação, um comando, implementação completa com orquestração ciente de dependências e validação integrada.