Início Rápido
SpecForge é um plugin para sua ferramenta de IA que ajuda a planejar, acompanhar e verificar funcionalidades de software. Em vez de se repetir em cada chat, você cria uma spec (um plano curto com uma lista do que significa "pronto") e sua IA a segue automaticamente.
Antes de começar
- Node.js ≥ 22 — baixe em nodejs.org
- Qualquer uma das ferramentas de IA listadas abaixo
Ferramentas de IA compatíveis
SpecForge conecta-se a ferramentas de IA que suportam o Model Context Protocol (MCP) — um padrão aberto para plugins de IA:
| Agente | Método de instalação | Link |
|---|---|---|
| Claude Desktop | Editar arquivo de configuração | Anthropic |
| Claude Code | Comando claude mcp add | Anthropic |
| Cursor | Editar ~/.cursor/mcp.json | Cursor |
| Windsurf | Editar ~/.codeium/windsurf/mcp_config.json | Codeium |
| Gemini CLI | Editar ~/.gemini/settings.json | |
| ChatGPT Desktop | Editar arquivo de config — requer Plus ou Pro | |
| Cline (VS Code) | Configurações do Cline → MCP Servers |
Instalação
O bloco de configuração é o mesmo para todas as ferramentas — apenas o local do arquivo muda:
json
{
"mcpServers": {
"specforge": {
"command": "npx",
"args": ["-y", "specforge-mcp@latest"]
}
}
}Claude Desktop
Passo 1. Abra o Claude Desktop no seu computador.
Passo 2. Vá ao menu Claude → Configurações → aba Desenvolvedor → clique em Editar Config.
Isso abre o arquivo de configuração no seu editor de texto. Se o arquivo estiver vazio, comece com
{}.
Passo 3. Cole o bloco de configuração acima dentro de "mcpServers", salve o arquivo.
Passo 4. Feche completamente e reabra o Claude Desktop.
Passo 5. Abra uma nova conversa — SpecForge aparece no painel de ferramentas (🔌).
Claude Code
bash
claude mcp add specforge -- npx -y specforge-mcp@latestReinicie o Claude Code. SpecForge estará disponível na sua próxima sessão. Documentação do Claude Code →
ChatGPT Desktop
Abra ou crie o arquivo de configuração em:
- Mac:
~/Library/Application Support/ChatGPT/config.json - Windows:
%APPDATA%\ChatGPT\config.json
Cole o bloco dentro de "mcpServers", salve e reinicie o ChatGPT. Requer ChatGPT Plus ou Pro.
Cursor
Abra ou crie ~/.cursor/mcp.json e cole o bloco de configuração. Depois reinicie o Cursor. Documentação do Cursor →
Windsurf
Abra ou crie ~/.codeium/windsurf/mcp_config.json e cole o bloco de configuração. Depois reinicie o Windsurf. Documentação do Windsurf →
Gemini CLI
Abra ou crie ~/.gemini/settings.json e cole o bloco de configuração. Depois reinicie o Gemini CLI. Gemini CLI →
Cline (extensão VS Code)
No VS Code com Cline instalado: abra a barra lateral do Cline → clique em MCP Servers → cole o bloco. Cline →
Seu Primeiro Projeto
Passo 1 — Verifique se o SpecForge está funcionando
Abra uma nova conversa no seu agente de IA (Claude Desktop, Cursor, Windsurf, etc.) e digite:
"Liste todas as ferramentas do specforge"
Você deve ver uma lista de 59+ ferramentas. Se nada aparecer, volte à etapa de instalação — o agente pode precisar de um reinício completo.
Passo 2 — Inicialize seu projeto
Informe ao seu agente de IA o caminho para a pasta do seu projeto:
"Inicialize meu projeto em /Users/seunome/projetos/meu-app com o specforge"
Substitua /Users/seunome/projetos/meu-app pelo caminho real da pasta do seu projeto.
SpecForge varre o diretório e detecta automaticamente sua linguagem, framework, gerenciador de pacotes e arquitetura. Ele retorna um projectId (ex.: proj_abc123) — guarde isso, você vai precisar em seguida.
Passo 3 — Crie sua primeira spec
Diga ao Claude qual funcionalidade você quer construir:
"Crie uma spec para adicionar login de usuário com Google OAuth no projeto proj_abc123"
SpecForge cria uma spec — um documento curto com um plano passo a passo e uma lista do que significa "pronto". Tudo salvo localmente na pasta do projeto.
Passo 4 — Construa guiado pela spec
Continue sua conversa com o agente de IA normalmente. A spec funciona como um contrato de desenvolvimento — o agente a lê, a segue e verifica o trabalho contra ela.
Quando achar que está pronto, valide:
"Valide a spec SPEC-001 contra o código em /Users/seunome/projetos/meu-app/src"
Passo 5 — Detecte drift
À medida que seu código evolui, mantenha as specs sincronizadas:
"Verifique se minha implementação ainda corresponde à SPEC-001"
SpecForge diz exatamente quais pontos estão prontos, quais faltam e o que mudou em relação ao plano original (chamamos isso de "drift" — quando o que foi construído não bate mais com o que foi combinado).