Skip to Content
IntegraçõesClaude CodeVisão Geral

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 — 17 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"],
      "env": {
        "SPECFORGE_API_KEY": "your-api-key"
      }
    }
  }
}

O Claude Code detecta isso na próxima inicialização. Todas as 17 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

Pipeline: specforge init detecta Claude Code, gera arquivos de config, habilita Agent Teams

Além das ferramentas MCP, o specforge init gera agentes especializados, skills operacionais e arquivos de orquestração de Agent Teams — dando ao Claude Code um entendimento completo do fluxo de trabalho do SpecForge sem nenhuma configuração manual.

Mergulhos profundos:

  • Agent Teams → — Implementação paralela com orquestrador, workers e validadores
  • Agentes & Skills → — Definições de agentes especializados e protocolos operacionais de skills

Fluxo de Trabalho: Planejamento + Implementação

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

Planejamento (conversacional):

  1. Você bootstrapa a especificação com specforge init (o humano cria o projeto + especificação)
  2. “Decompose this into epics and tickets”
  3. O Claude Code chama start_planning_session para iniciar o planejamento
  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 complete_planning_session, cujo gate de revisão retorna a pontuação e os 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. Conforme cada ticket completa, seu gate de assay por ticket valida o trabalho dentro de complete_work_session — um ticket que fica aquém retorna achados e não avança para done
  5. Endereça quaisquer achados nos tickets afetados e re-executa aquelas sessões; quando todo ticket passa, a spec está done

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

Workflow de duas fases: planejamento conversacional à esquerda, implementação autônoma à direita

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

BlueprintsAgent Teams