Skip to Content
IntegraçõesClaude Code

Claude Code

Conecte o SpecForge ao Claude Code com ferramentas MCP e Agent Teams para implementação paralela autônoma.

O Claude Code é a integração mais profunda do SpecForge. A CLI gera não apenas configuração MCP, mas agentes especializados, skills operacionais e orquestração de Agent Teams — tudo que o Claude Code precisa para planejar, implementar e validar uma especificação de forma autônoma.

Outros agentes ganham acesso MCP. O Claude Code ganha a stack completa.

Setup Rápido

Na raiz do seu repositório:

specforge init

A CLI detecta o Claude Code e gera:

ArquivoPropósito
.mcp.jsonRegistra o servidor MCP do SpecForge — 22 ferramentas disponíveis
CLAUDE.mdAncora o contexto do projeto — qual projeto e especificação do SpecForge este repositório está conectado
.claude/skills/Skills operacionais que ensinam o Claude Code a usar ferramentas MCP do SpecForge para planejamento, implementação e validação
.claude/agents/Definições de agentes especializados para implementação paralela orquestrada via Agent Teams
.specforge/config.jsonIDs de projeto e especificação, configuração de Agent Teams

Se você já tem um .mcp.json com outros servidores, o specforge init faz o merge da entrada do SpecForge sem tocar na sua configuração existente.

✅ Execute specforge scaffold --target claude-code para regenerar apenas os arquivos do Claude Code sem passar pelo fluxo completo de init.

Configuração MCP

O .mcp.json gerado:

{
  "mcpServers": {
    "specforge": {
      "command": "npx",
      "args": ["-y", "@specforge/cli@latest"],
      "env": {
        "SPECFORGE_API_KEY": "your-api-key"
      }
    }
  }
}

O Claude Code detecta isso na próxima inicialização. Todas as 22 ferramentas do SpecForge ficam disponíveis na conversa.

Ferramentas Disponíveis

Uma vez conectado, o Claude Code tem acesso ao toolkit completo do SpecForge:

  • Planejamento — Criar e gerenciar especificações, épicos, tickets, dependências e blueprints
  • Consultas — Buscar tickets, obter árvores de dependência, encontrar bloqueadores, visualizar caminhos críticos
  • Implementação — Iniciar work sessions, vincular commits e PRs, revisar implementações
  • Relatórios — Gerar relatórios de progresso, validar completude da especificação

Todas as ferramentas são chamáveis naturalmente na conversa. Diga ao Claude Code o que você quer, e ele escolhe a ferramenta certa.

O Que Torna o Claude Code Diferente

Agentes

O diretório .claude/agents/ contém definições de agentes que o Claude Code carrega automaticamente. Não são instruções genéricas — são papéis especializados projetados em torno do fluxo de trabalho do SpecForge:

  • Agentes de planejamento guiam você pelo refinamento da especificação, fazendo as perguntas certas sobre objetivos, restrições, casos extremos e critérios de aceite
  • Agentes de implementação sabem como pegar tickets, seguir passos de implementação, reportar progresso e completar work sessions
  • Agentes de validação verificam trabalho completado contra critérios de aceite e reportam achados

Skills

O diretório .claude/skills/ contém skills operacionais — protocolos passo a passo para usar ferramentas MCP do SpecForge corretamente. Skills codificam o fluxo de trabalho para que o Claude Code não precise descobrir o sequenciamento de ferramentas do zero:

  • Como iniciar uma sessão de planejamento e iterar pela decomposição
  • Como pegar um ticket, implementá-lo e fechar a work session
  • Como executar reviews e endereçar achados
  • Como lidar com bloqueios e descobertas durante a implementação

Agent Teams

Esta é 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:

ArquivoPapel
orchestrator.mdLê a especificação, analisa o grafo de dependência, atribui tickets a workers, monitora progresso
worker.mdImplementa um único ticket — lê contexto, escreve código, roda testes, reporta resultados
validator.mdRevisa trabalho completado — verifica critérios de aceite, roda suítes de teste, sinaliza problemas
conventions.mdRegras 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.

Fluxo de Trabalho: Planejamento + Implementação

Um fluxo de trabalho típico usando Claude Code com SpecForge:

Planejamento (conversacional):

  1. “Create a new specification for user authentication”
  2. O Claude Code chama create_specification
  3. “Decompose this into epics and tickets”
  4. O Claude Code executa a sessão de planejamento, cria estrutura, vincula dependências
  5. “Run the planning review”
  6. O Claude Code chama review_planning, mostra a pontuação e achados
  7. Você refina baseado no feedback, re-executa até o gate passar

Implementação (autônoma):

  1. “Implement the active specification”
  2. O Claude Code (com Agent Teams) cria workers, implementa em paralelo
  3. Você monitora pelo painel ou com specforge status
  4. Após todos os tickets completarem, o Claude Code executa o implementation review
  5. Endereça quaisquer achados, re-executa se necessário

A transição do planejamento para implementação é seamless — mesma ferramenta, mesma sessão, mesma conexão MCP.

Configuração Manual

Se você prefere configurar manualmente ao invés de usar specforge init:

# Gerar apenas arquivos do Claude Code
specforge scaffold --target claude-code

Isso cria a configuração MCP, CLAUDE.md, agentes e skills sem o fluxo interativo de seleção de projeto.

Próximos Passos

BlueprintsClaude Desktop