GitHub Spec Kit: Dejá de Vibe Codear y Empezá a Construir con Specs
Si alguna vez le pasaste un prompt vago a tu agente de coding y lo viste construir con confianza la cosa equivocada, spec-kit es para vos.
GitHub acaba de publicar un toolkit open source llamado spec-kit — más de 68.000 estrellas en pocas semanas — que introduce un workflow estructurado y spec-driven para el desarrollo asistido por IA. La idea es simple: en lugar de describir lo que querés en un solo prompt y esperar lo mejor, primero construís una especificación ejecutable y después dejás que tu agente implemente contra ella. Funciona con Claude Code, Cursor, Copilot, Windsurf, Codex y más de 15 agentes adicionales.
Acá te explico cómo arrancar.
Instalá el CLI
Spec-kit viene con un CLI llamado specify. Instalalo una sola vez con uv:
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
Luego inicializá un nuevo proyecto para tu agente preferido:
specify init mi-proyecto --ai claude
# o para Cursor
specify init mi-proyecto --ai cursor-agent
# o en el directorio actual
specify init . --ai claude
Esto genera un directorio .specify/ con templates, scripts y slash commands conectados a tu agente.
El workflow: 7 comandos que reemplazan el prompting ad-hoc
Después de ejecutar specify init, tu agente tiene acceso a estos slash commands:
/speckit.constitution — Empezá por acá. Definí los principios que gobiernan tu proyecto: estándares de calidad de código, requisitos de testing, restricciones de arquitectura. Este archivo guía cada decisión posterior que tome el agente.
/speckit.specify — Describí qué querés construir y por qué. Enfocate en el comportamiento y las historias de usuario, no en el stack tecnológico. Sé explícito. Cuanto más detalle pongas acá, menos retrabajo después.
/speckit.clarify — Ejecutá esto antes de planificar. El agente hace preguntas estructuradas sobre áreas sub-especificadas y registra las respuestas. Saltarse este paso es exactamente cómo terminás con una app hermosa que hace lo que no tenía que hacer.
/speckit.plan — Acá sí especificás el stack tecnológico y la arquitectura. El agente genera un plan de implementación, contratos de API, modelo de datos y documentos de investigación basados en tu spec.
/speckit.tasks — Divide el plan en tareas ordenadas y accionables. Marca las tareas paralelas con [P], especifica rutas de archivos exactas e incorpora checkpoints de TDD.
/speckit.implement — Ejecuta la lista de tareas. El agente valida que la constitution, el spec, el plan y las tareas estén todos en su lugar antes de escribir una sola línea de código.
/speckit.checklist / /speckit.analyze — Controles de calidad opcionales: verificación de consistencia entre artefactos y checklists de validación personalizados antes de la implementación.
Por qué esto importa
El problema con el coding asistido por IA no es la capacidad del agente — es la estructura. Un agente capaz con un prompt vago produce output capaz pero equivocado. Spec-kit obliga a que el spec exista como un artefacto real antes de que se escriba cualquier código, lo que significa que tu agente tiene algo concreto contra qué implementar en lugar de interpolar desde tu intención.
También hace que el desarrollo asistido por IA sea repetible. El spec vive en tu repositorio. Un nuevo miembro del equipo — o una nueva sesión de agente — puede leerlo y entender exactamente qué se supone que hace el sistema y por qué.
El toolkit cubre tres escenarios explícitamente: proyectos greenfield (de 0 a 1), desarrollo iterativo de features en codebases existentes (brownfield) y exploración creativa donde querés prototipar múltiples enfoques en paralelo.
Probalo
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
specify init mi-proyecto --ai claude
Luego abrí Claude Code en ese directorio, ejecutá /speckit.constitution y describí los principios de tu proyecto. El resto del workflow fluye naturalmente.
Spec-kit no te va a impedir vibe codear si eso es lo que querés. Pero para cualquier cosa que realmente planeás shipear, le da a tu agente lo que le faltaba: un spec real desde donde trabajar.
¿Ya usás algún workflow de specs antes de implementar con tu agente? ¿O arrancás directo desde el prompt?
Fuente: github/spec-kit