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 — 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

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. “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.

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