Spec Kit, de GitHub: escribe primero la especificación y deja que el agente la ejecute

Este no es el repositorio más llamativo de la semana, pero probablemente sea el más útil, y no solo para quien programa. Spec Kit es la herramienta oficial de GitHub para lo que han bautizado como desarrollo guiado por especificación, y detrás del nombre hay una idea que se resume en una frase: escribe lo que quieres antes de pedirle a la IA que lo haga.

Ya va por las 128.000 estrellas, que para una herramienta de metodología —no de las que hacen algo vistoso en pantalla— es una barbaridad.

El problema que ataca

Cualquiera que haya trabajado un rato largo con un agente de programación conoce el patrón. Le pides algo en dos líneas. El agente entiende su versión de esas dos líneas, se pone a construir con energía, y cuarenta minutos después tienes algo que funciona pero que no es lo que querías. Corriges. Vuelve a construir. Se le olvida la corrección anterior. Y así.

El fallo no es del modelo. El fallo es que nunca escribiste bien lo que querías. Lo llevabas en la cabeza, con todos sus matices y sus casos raros, y de ahí solo salieron dos líneas.

Spec Kit le da la vuelta al proceso: la especificación deja de ser un papel que se escribe al principio y se olvida, y pasa a ser el documento que manda. El código es lo que sale de ella, no al revés.

Cómo funciona

Se instala como una herramienta de línea de órdenes:

uv tool install specify-cli

Necesita Python 3.11 o superior, Git, uv o pipx, y un agente de programación compatible. Funciona en Linux, macOS y Windows. Y esto es lo bueno: soporta más de 30 agentes distintos —GitHub Copilot, Claude, y la lista sigue creciendo—, así que no te ata a ninguno. Puedes ver los que admite tu versión con specify integration list.

Una vez dentro, el trabajo se hace con seis órdenes que marcan el recorrido:

Orden	Qué haces en ese paso
/speckit.constitution	Fijas los principios del proyecto: cómo se hacen las cosas aquí
/speckit.specify	Describes el qué y el por qué, sin entrar en el cómo
/speckit.plan	Defines la arquitectura y las decisiones técnicas
/speckit.tasks	Se genera la lista de tareas concretas
/speckit.implement	El agente ejecuta las tareas
/speckit.converge	Se revisa qué falta y qué ha quedado a medias

El paso que más me gusta es el último. converge es el que pregunta ¿esto está realmente terminado?, y es justo el que todos nos saltamos cuando algo parece funcionar. Que esté en el flujo por defecto, y no como buena intención, dice bastante de quién ha diseñado esto.

Y el primero, la "constitución", es más listo de lo que parece: son las reglas que el agente tiene que respetar en todo el proyecto, escritas una vez. Deja de repetir "usa TypeScript, no metas dependencias nuevas, comenta en español" en cada petición.

La parte que sirve aunque no programes

Aquí es donde esto se sale del terreno técnico, y es el motivo por el que lo traigo.

El patrón —principios, especificación, plan, tareas, ejecución, revisión— no tiene nada de específico del software. Es exactamente lo que falta en el 90% de los intentos de usar IA en una empresa que veo fracasar.

Piénsalo con un caso normal. Quieres que la IA redacte las respuestas a las reseñas de tu clínica. Lo que suele hacerse es abrir ChatGPT y pedirle "responde a esta reseña". Lo que habría que hacer es escribir una vez, en un documento: qué tono usamos, qué nunca decimos, cómo tratamos una queja médica, cuándo derivamos a teléfono, qué firma va al final. Eso es una constitución. Y a partir de ahí, cada petición hereda las reglas en lugar de improvisarlas.

El resultado no es un poco mejor. Es de otra categoría. Y no requiere ninguna herramienta: requiere media hora escribiendo. Sobre cómo formular bien esas instrucciones, tengo la guía en prompt engineering y lo básico en qué es un prompt.

Cuándo no te compensa

• Para un cambio pequeño, montar todo el ritual es más caro que hacerlo. Esto rinde en trabajos de días o semanas, no de veinte minutos.
• Si no usas ya un agente de programación, empieza por ahí: Claude Code o las alternativas que comparé en la mejor IA para programar. Spec Kit es la capa de encima, no la puerta de entrada.
• Si esperas que la especificación se escriba sola, no. El agente te ayuda a redactarla, pero las decisiones difíciles —qué entra, qué no, qué pasa en el caso raro— las sigues tomando tú. Esa es la parte que no se delega, y es precisamente la parte que vale.

Que la publique GitHub, con licencia MIT y soporte para agentes de la competencia incluidos, tiene su gracia: la metodología es de todos y la disputa está en otro sitio. Sea como sea, para quien trabaja a diario con agentes esto es de lo más rentable que puede leerse esta semana.

Preguntas frecuentes

¿Qué es el desarrollo guiado por especificación?

Es darle la vuelta al proceso habitual: la especificación deja de ser un documento previo que se archiva y pasa a ser la fuente de la que se genera la implementación. Si cambia lo que quieres, cambias la especificación, no el código a mano.

¿Sirve solo con GitHub Copilot?

No. Admite más de 30 agentes de programación, tanto de línea de órdenes como integrados en el editor. Puedes consultar la lista de tu versión con specify integration list.

¿Necesito saber Python?

Solo se usa para instalar la herramienta. El trabajo lo haces en tu lenguaje de siempre con tu agente de siempre.

¿Es gratis?

Sí, licencia MIT. Lo que pagas es el agente y el modelo que uses por debajo.

¿Vale para proyectos que no son software?

La herramienta está pensada para código, pero el método —principios, especificación, plan, tareas, revisión— se aplica igual de bien a cualquier trabajo que quieras delegar en una IA.