Glosario
Una referencia rápida para los términos que verás en SpecForge — escrita para personas, no solo para desarrolladores.
Spec
Una spec (abreviatura de specification, especificación) es un plan corto para una función o cambio que quieres construir. Piénsala como un acuerdo entre tú y tu IA: describe qué construir, cómo debe funcionar y qué significa que esté listo.
Ejemplo: Una spec para "login con Google" incluiría: configurar las credenciales OAuth, agregar el botón de login, guardar la sesión del usuario, redirigir después del login. Tu IA lee esto y lo sigue paso a paso.
Lista de verificación de "listo"
Cada spec tiene una lista de verificación — una lista de condiciones que deben cumplirse antes de considerar la función terminada. Elimina la ambigüedad: en vez de "más o menos funciona", sabes exactamente qué casillas están marcadas y cuáles faltan.
Drift (desvío)
El drift (desvío) ocurre cuando el código que construiste ya no coincide con la spec original. Es algo normal — los requisitos cambian, se toman atajos, las ideas evolucionan. SpecForge detecta el drift y te dice exactamente qué se alejó del plan.
Por qué importa: Sin detección de drift, podrías creer que una función está lista cuando en realidad partes críticas cambiaron o faltan.
Servidor MCP
Un servidor MCP es un plugin que extiende tu herramienta de IA (como Claude, Cursor o Windsurf) con nuevas capacidades. SpecForge corre como un servidor MCP en tu máquina — tu IA puede llamar a sus herramientas para crear specs, validar código, detectar drift y más.
Analogía: Piénsalo como una extensión del navegador, pero para tu asistente de IA.
SDD (Desarrollo Guiado por Specs)
El SDD es un enfoque de desarrollo donde cada función empieza con una spec clara antes de escribir cualquier código. La spec se convierte en la única fuente de verdad — tu IA la sigue, y tú validas contra ella cuando terminas.
A diferencia de: El desarrollo ad-hoc, donde describes lo que quieres en el chat y esperas que la IA lo interprete correctamente.
Proyecto
En SpecForge, un proyecto es una carpeta en tu computadora que inicializaste con SpecForge. Cada proyecto tiene un ID único y guarda todas sus specs, decisiones y métricas de forma local — sin nube.
Stream
SpecForge organiza sus 59 herramientas en 8 streams (A al H). Cada stream agrupa herramientas que hacen cosas similares: planificación, análisis, diseño, entrega, etc. No necesitas conocer las 59 — solo el stream relevante para lo que estás haciendo.
Validación
La validación ocurre cuando SpecForge lee tu código y lo compara con la lista de verificación de una spec. Te dice qué elementos están completos, cuáles faltan y qué cambió respecto al plan original.
Cuándo usarla: Después de que tú (o tu IA) crean que una función está lista.
Criterios de aceptación
Los criterios de aceptación son las condiciones específicas que deben cumplirse para que una spec se considere terminada. Son los ítems de la lista de verificación. Cada criterio es concreto y verificable — no "el login debe funcionar" sino "el usuario es redirigido a /dashboard después de un login exitoso".
Inicializar
Inicializar un proyecto significa apuntar SpecForge a tu carpeta de proyecto para que escanee tu código, detecte tu lenguaje y framework, y configure el almacenamiento local de specs. Tarda unos segundos y solo necesitas hacerlo una vez por proyecto.
Patrón
Un patrón es una solución recurrente que SpecForge aprende de tu proyecto. Con el tiempo, SpecForge puede reconocer enfoques comunes en tu código y sugerirlos al crear nuevas specs — para que tu IA construya de forma consistente.
Deuda técnica
La deuda técnica se refiere a trabajo diferido o atajos tomados durante el desarrollo. En SpecForge, los ítems de deuda técnica se registran por separado en el archivo de progreso de una spec — no bloquean que la spec esté "lista", pero quedan registrados para no olvidarlos.
¿Falta un término? Deja un comentario abajo o contáctanos en npm.