El vibe coding lleva meses siendo la forma por defecto de trabajar con agentes de IA: abres Claude Code, Cursor o Copilot, le describes lo que quieres y cruzas los dedos. A veces funciona. Cuando el proyecto crece, empieza a fallar de formas predecibles. GitHub acaba de publicar spec-kit, un repositorio que ya supera las 92.000 estrellas y que propone una alternativa más seria: el Spec-Driven Development.
La diferencia no es filosófica. Con vibe coding le pides a la IA que construya algo y el agente interpreta tu intención lo mejor que puede. Con spec-kit, antes de que el agente escriba una lÃnea de código, tienes una especificación estructurada que describe qué construir, por qué, con qué reglas y en qué orden. El agente no interpreta, ejecuta.
Los seis comandos del flujo
El workflow de spec-kit se articula en seis pasos. Los cuatro primeros son de preparación; los dos últimos, de ejecución:
- /speckit.constitution: establece las reglas del proyecto antes de tocar nada. Calidad de código, criterios de testing, decisiones de UX. Todo lo que deberÃa estar claro desde el principio y casi nunca lo está.
- /speckit.specify: describes qué quieres construir, sin hablar de tecnologÃa todavÃa. El agente no necesita saber si usarás React o Vue para entender qué tiene que hacer el producto.
- /speckit.clarify: la IA hace preguntas. Si tu especificación tiene huecos o contradicciones, este paso los saca antes de que se conviertan en bugs de implementación.
- /speckit.plan: ahora sÃ, eliges el stack. El agente construye el plan técnico sobre la especificación que ya has validado.
- /speckit.tasks: genera la lista de tareas ordenada por dependencias. Primero lo que tiene que ir primero.
- /speckit.implement: el agente construye todo según el plan.
El entregable del proceso no es solo código. Es una especificación viva que puedes revisar, actualizar y reutilizar en futuras iteraciones del producto.
Por qué esto interesa más allá del hype
El problema del vibe coding no es que produzca código malo siempre. Es que produce resultados inconsistentes. Una sesión sale bien, la siguiente genera algo que rompe lo anterior porque el agente no tenÃa contexto suficiente. La especificación resuelve ese problema dándole al agente un documento de referencia estable que no desaparece cuando cierras la ventana.
Hay otro cambio menos obvio: fuerza a pensar antes de construir. Suena trivial, pero buena parte de los proyectos que mueren con agentes de IA mueren porque nadie terminó de aclarar qué se estaba construyendo. La IA genera código, el desarrollador acepta el output, y tres horas después nadie sabe bien qué hace la aplicación ni por qué tiene esa arquitectura.
Spec-kit no te ahorra ese trabajo, te lo pone delante desde el principio, cuando todavÃa es barato resolverlo.
Compatibilidad con los agentes más usados
Uno de los puntos fuertes del proyecto es que no está atado a ningún agente. Funciona con Claude Code, GitHub Copilot, Cursor, Codex, Gemini y más de 25 herramientas más. La documentación completa está en github.github.com/spec-kit, con guÃas especÃficas para cada integración.
La instalación se hace con uv o pipx directamente desde el repositorio de GitHub. El equipo avisa expresamente de que cualquier paquete con el mismo nombre en PyPI no tiene relación con este proyecto.
92.000 estrellas en poco tiempo para un repositorio de GitHub, oficial de GitHub, sobre metodologÃa de desarrollo con agentes. Algo le está resonando a mucha gente.
