Programación y vibe coding
Spec Kit: que tu agente de código acuerde la especificación antes de programar
Spec Kit es un kit abierto de GitHub que añade a tu agente de código un proceso fijo: reglas del proyecto, especificación, plan, tareas, implementación y una revisión que compara lo construido con lo pedido. Funciona con Claude Code, Cursor, Codex, Copilot y más. Curado, no probado por Fluye.
| Herramientas | Claude Code (principal)CursorGitHub Copilot |
|---|---|
| Qué necesitas |
|
| Coste aprox. | Spec Kit es gratis y de código abierto (licencia MIT). Pagas el agente de código que ya uses, según tu plan. |
| Tiempo de montaje | 20 min (primera vez) |
| Nivel | Media |
| Plan gratis | Puede bastar para pruebas |
Prompt listo para usar
Vamos a construir [FUNCIONALIDAD] en [PROYECTO] con el proceso de Spec Kit. No escribas código hasta el paso 4. 1. Constitución: propón 5 reglas del proyecto centradas en [PRIORIDADES]. Espera mi OK. 2. Especificación: escribe qué tiene que hacer y por qué, para [USUARIO]. Sin hablar todavía de tecnología. Marca con [DUDA] lo que no esté claro y pregúntamelo. 3. Plan y tareas: usa [STACK], divide el trabajo en tareas pequeñas que se puedan revisar una a una y enséñamelas. 4. Implementa tarea a tarea y, al terminar, compara lo construido con la especificación. Dime qué cumple, qué falta y qué has cambiado respecto al plan.
| Variable | Qué poner | Ejemplo |
|---|---|---|
[FUNCIONALIDAD] | Lo que quieres construir | un panel para ver las reservas de la semana |
[PROYECTO] | La app o el repositorio | la web de la clínica |
[PRIORIDADES] | Lo que más te importa en el código | tests, accesibilidad y código fácil de mantener |
[USUARIO] | Quién va a usar la función | la recepcionista, desde el móvil |
[STACK] | Tecnología que quieres usar | Astro y SQLite |
Pégalo en: Claude Code, Cursor, GitHub Copilot
Prompt propio de Fluye que sigue el orden de Spec Kit. Con Spec Kit instalado, lanza en su lugar los comandos del kit (/speckit-constitution, /speckit-specify, /speckit-plan, /speckit-tasks, /speckit-implement y /speckit-converge) y pega en cada uno la parte que toca. La forma exacta cambia según el agente.
Cómo funciona
- Instala la CLI de Spec Kit. Con Python 3.11 o superior y uv, ejecuta uv tool install specify-cli en la terminal. Es la instalación que da el README de github/spec-kit.
- Crea el proyecto con tu agente. specify init mi-proyecto --integration claude para Claude Code. Otras claves de la documentación: cursor-agent, codex, copilot o gemini. Para un repo que ya existe, sigue la guía de proyectos existentes.
- Escribe la constitución una vez. En el chat del agente, no en la terminal: /speckit-constitution con las reglas que valen para todo el proyecto, como calidad, tests y mantenimiento.
- Especifica qué quieres y por qué. /speckit-specify describe la función desde el punto de vista del usuario, sin tecnología. Revisa el texto antes de seguir: es lo que luego se va a comprobar.
- Plan, tareas e implementación. /speckit-plan con el stack y la arquitectura, /speckit-tasks para la lista de tareas y /speckit-implement para que el agente construya. El README pide lanzarlos de uno en uno y revisar cada resultado.
- Repite hasta que converja. /speckit-converge compara lo construido con la especificación. Se repiten implement y converge hasta que el informe diga Converged.
Qué resultado esperar
Una función construida a partir de una especificación escrita y revisada por ti, con plan, lista de tareas y un informe que dice si lo construido cumple lo pedido.
- Qué se hizo
- Un kit abierto de GitHub que obliga al agente de código a acordar por escrito qué va a construir antes de escribir una línea, y a comprobar después que lo construido cumple lo acordado.
- Cómo fue
- Según su README, se instala con uv, se conecta a tu agente con una clave de integración y sigue seis pasos: constitución, especificación, plan, tareas, implementación y convergencia. Saman Ahmed lo resumía en X el 28 oct como el flujo de 6 comandos.
- A tener en cuenta
- No hay cifras medidas de mejora. Para cambios pequeños sobra. Sin prueba propia.
Límites y precauciones
- Ni el README ni el post de origen dan cifras de mejora medidas: no sabemos cuánto tiempo ahorra ni cuántos errores evita.
- Para un cambio pequeño es más lento que pedírselo directamente al agente.
- Cada paso consume tokens de tu agente: una función grande pasa por seis pasos con revisión.
- Sin prueba propia todavía.
- No edites a mano los comandos o skills que genera Spec Kit: la documentación pide cambiarlos con presets u overrides del proyecto.
- Los componentes de los catálogos de la comunidad no están auditados. El README avisa: revisa su código antes de instalarlos.
- Revisa la especificación tú. Si la das por buena sin leerla, el agente construirá con seguridad lo que no querías.
Variantes
- cursor: Spec Kit se integra con Cursor con la clave cursor-agent: specify init mi-proyecto --integration cursor-agent.
- github-copilot: El ejemplo del README usa GitHub Copilot (--integration copilot). La extensión de bugs (specify extension add bug) añade un proceso aparte para diagnosticar y arreglar fallos.
Fuente: el README de Spec Kit en GitHub, su documentación de integraciones a 29 oct 2026 y el post de Saman Ahmed en X del 28 oct 2026. Caso curado, no probado por Fluye.
«Define what to build and why, then turn the specification into a plan, tasks, and working code.» (Define qué construir y por qué, y convierte la especificación en un plan, tareas y código que funciona.) README de Spec Kit.
Pedirle a un agente de código que construya algo funciona bien mientras el proyecto es pequeño. Cuando crece, el agente empieza a decidir cosas que no le has pedido y cuesta saber si lo que ha hecho es lo que querías. Spec Kit ataca ese problema con un método que GitHub llama desarrollo guiado por especificaciones: primero se escribe qué se quiere y por qué, y el código viene después.
El kit es abierto, con licencia MIT y más de 143K estrellas en GitHub a 29 oct. Se instala con uv y se conecta a tu agente con una clave: claude para Claude Code, cursor-agent para Cursor, codex, copilot o gemini, entre más de 40. A partir de ahí trabajas en el chat del agente con seis pasos: las reglas del proyecto (la constitución), la especificación, el plan técnico, la lista de tareas, la implementación y la convergencia, que compara lo construido con lo especificado y se repite hasta que cuadra.
Saman Ahmed lo vendía en X como el fin del vibe coding. Es más prudente verlo como una capa de orden encima del agente que ya usas: no programa mejor por sí mismo, pero te obliga a revisar la especificación antes y deja por escrito qué falta al final. Para un cambio de diez minutos no compensa; para una función con varias pantallas, sí puede.
Si buscas el flujo básico de trabajar con un agente en tu repo, empieza por programar con un agente de código. Para el ciclo de plan, test y revisión dentro de Claude Code, mira ECC para Claude Code, y si quieres prototipar rápido sin tanta ceremonia, crear una app con IA. Más sobre la herramienta en la ficha de Claude Code.
Preguntas frecuentes
¿Lo habéis probado?
No. La ficha resume el README de github/spec-kit y su documentación a 29 oct 2026, y el post de Saman Ahmed del 28 oct. No hemos medido si mejora el código ni cuánto tarda.
¿Cuánto cuesta Spec Kit?
Nada. Es de código abierto con licencia MIT. Lo que pagas es el agente de código que uses con él, según tu plan.
¿Con qué agentes funciona?
La documentación lista más de 40 integraciones, entre ellas Claude Code (claude), Cursor (cursor-agent), Codex CLI (codex), GitHub Copilot (copilot), Gemini CLI (gemini), Goose y Hermes.
¿Sirve para un proyecto que ya tengo?
Sí. La documentación tiene una guía para proyectos existentes, y la extensión de bugs se puede usar sin pasar antes por todo el proceso de especificación.
¿Qué diferencia hay con pedirle el código directamente al agente?
Que antes de programar hay un documento que dice qué se quiere y por qué, y al final una revisión que compara el resultado con ese documento. Es más lento, pero el agente se desvía menos en proyectos grandes.
Telegram. Suscríbete al canal de Telegram para no perderte nada y estar al loro de todo lo nuevo en automatización y agentes de IA.Unirme al canal