Primeros Pasos
SpecForge es un plugin para tu herramienta de IA que te ayuda a planificar, rastrear y verificar funciones de software. En lugar de repetirte en cada chat, creas una spec (un plan corto con una lista de verificación de "listo") y tu IA la sigue automáticamente.
Funciona con cualquier lenguaje de programación, cualquier framework y la mayoría de herramientas de IA.
Antes de empezar
- Node.js ≥ 22 — descargar en nodejs.org — necesario para ejecutar SpecForge localmente. Sin cuenta, todos los datos quedan en tu máquina.
- Cualquiera de las herramientas de IA listadas abajo
Herramientas de IA compatibles
SpecForge se conecta a herramientas de IA que soportan el Model Context Protocol (MCP) — un estándar abierto para plugins de IA:
| Herramienta de IA | Cómo conectar |
|---|---|
| Claude Desktop | Editar archivo de config (ver pasos abajo) |
| Claude Code | Un comando: claude mcp add |
| ChatGPT Desktop | Editar archivo de config — requiere Plus o Pro |
| Cursor | Editar ~/.cursor/mcp.json |
| Windsurf | Editar ~/.codeium/windsurf/mcp_config.json |
| Gemini CLI | Editar ~/.gemini/settings.json |
| Cline (VS Code) | Configuración de Cline → MCP Servers |
Instalación
El bloque de configuración es el mismo para todos — solo cambia la ubicación del archivo:
json
{
"mcpServers": {
"specforge": {
"command": "npx",
"args": ["-y", "specforge-mcp@latest"]
}
}
}Claude Desktop
Paso 1. Abre Claude Desktop en tu computadora.
Paso 2. Ve al menú Claude → Settings → pestaña Developer → botón Edit Config.
Esto abre el archivo de config en tu editor. Si está vacío, empieza con
{}.
Paso 3. Pega el bloque de configuración de arriba dentro de "mcpServers" y guarda el archivo.
Paso 4. Cierra y vuelve a abrir Claude Desktop completamente.
Paso 5. Abre una nueva conversación — SpecForge aparece en el panel de herramientas (🔌).
Claude Code
bash
claude mcp add specforge -- npx -y specforge-mcp@latestReinicia Claude Code. SpecForge estará disponible en tu próxima sesión. Docs de Claude Code →
ChatGPT Desktop
Abre o crea el archivo de config en:
- Mac:
~/Library/Application Support/ChatGPT/config.json - Windows:
%APPDATA%\ChatGPT\config.json
Pega el bloque dentro de "mcpServers", guarda y reinicia ChatGPT. Requiere ChatGPT Plus o Pro.
Cursor
Abre o crea ~/.cursor/mcp.json y pega el bloque de configuración. Luego reinicia Cursor. Docs de Cursor →
Windsurf
Abre o crea ~/.codeium/windsurf/mcp_config.json y pega el bloque de configuración. Luego reinicia Windsurf. Docs de Windsurf →
Gemini CLI
Abre o crea ~/.gemini/settings.json y pega el bloque de configuración. Luego reinicia Gemini CLI. Gemini CLI →
Cline (extensión de VS Code)
En VS Code con Cline instalado: abre la barra lateral de Cline → clic en MCP Servers → pega el bloque. Cline →
Tu Primer Proyecto
Paso 1 — Verificar que SpecForge funciona
Abre un chat nuevo en tu agente de IA (Claude Desktop, Cursor, Windsurf, etc.) y escribe:
"Lista todas las herramientas de specforge"
Deberías ver una lista de 59+ herramientas. Si no aparece nada, vuelve al paso de instalación — el agente puede necesitar un reinicio completo.
Paso 2 — Inicializar tu proyecto
Dile a tu agente de IA la ruta de tu carpeta de proyecto:
"Inicializa mi proyecto en /Users/tunombre/proyectos/mi-app con specforge"
Reemplaza /Users/tunombre/proyectos/mi-app con la ruta real de tu proyecto.
SpecForge escanea el directorio y detecta automáticamente tu lenguaje, framework, package manager y arquitectura. Devuelve un projectId (ej: proj_abc123) — guárdalo, lo necesitarás en los siguientes pasos.
Paso 3 — Crear tu primera spec
Dile a tu IA qué quieres construir:
"Crea una spec para agregar login con Google OAuth al proyecto proj_abc123"
SpecForge crea una spec — un documento corto con un plan paso a paso y una lista de verificación de qué significa "listo". Todo se guarda localmente en tu carpeta de proyecto.
Paso 4 — Construir guiado por la spec
Continúa tu conversación con tu IA normalmente. La spec es el acuerdo — el agente la lee, la sigue y verifica su trabajo automáticamente.
Cuando creas que terminaste, verifica:
"Valida la spec SPEC-001 contra el código en /Users/tunombre/proyectos/mi-app/src"
Paso 5 — Detectar cuándo las cosas se desvían
A medida que el proyecto crece, el código puede desviarse del plan original (a esto le llamamos "drift" — cuando lo que se construyó ya no coincide con lo que se acordó). Mantén las specs sincronizadas:
"Verifica si mi implementación todavía coincide con SPEC-001"
SpecForge te dice exactamente qué puntos están listos, cuáles faltan y qué cambió respecto al plan original.