Escribí qué querés antes de que la IA escriba código (Spec Kit)

Le pedís “una app para gestionar clientes” y la IA arranca a los cinco segundos. El problema no es lo que escribe: es que todo lo que vos no dijiste, lo decidió ella — y lo decidió distinto cada vez que le volviste a pedir algo. A la semana tenés un Frankenstein.

Spec Kit invierte el orden: primero la especificación, después el plan técnico, después las tareas, y recién al final el código. Es open-source y lo mantiene GitHub (más de 130.000 estrellas).

• 4pasos: constitución, spec, plan, tareas
• GitHubquién lo mantiene
• Multi-agenteClaude, Copilot y otros

01 Qué es

📟 En criollo

Spec (especificación) = el documento que dice qué tiene que hacer el software y qué no. En la industria siempre existió, pero se escribía y se tiraba. Acá la spec no se tira: es la fuente de la que sale el código.

🧪 La analogía

Es el plano del arquitecto. Sin plano, el albañil levanta paredes que se ven bien y después no entra el baño. Y cuando le preguntás por qué, tiene razón: nadie le dijo dónde iba el baño.

02 Cómo se instala

✅ Cómo se hace

1. Necesita uv, un gestor de Python (lo instalás siguiendo el link de abajo).
2. Instalá la herramienta y arrancá tu proyecto indicando qué agente usás.

uv tool install specify-cli
specify init mi-proyecto --integration claude

03 Los comandos, en orden

Una vez inicializado, dentro de Claude Code usás estos comandos. El orden importa: cada uno se apoya en lo que dejó el anterior.

• /speckit.constitution — las reglas del proyecto que no se negocian (stack, principios, límites).
• /speckit.specify — qué querés construir: requisitos e historias de usuario. Todavía no hay tecnología acá.
• /speckit.clarify — te pregunta lo que quedó ambiguo antes de que sea un bug.
• /speckit.plan — el plan técnico con tu stack elegido.
• /speckit.tasks — lo parte en tareas concretas y ejecutables.
• /speckit.implement — recién ahora se escribe código.

⚡ Tip del Tincho

El comando que más te va a ahorrar es /speckit.clarify. Es la IA preguntando “¿y si el usuario no pagó?”, “¿qué pasa si sube un archivo de 2 GB?”. Cada pregunta que respondés ahí es una decisión que ella no va a tomar sola por vos más adelante.

⚠️ Ojo con esto

Esto agrega fricción a propósito y no siempre vale la pena. Para un cambio chico o una prueba rápida es puro trámite. Rinde cuando el proyecto es de verdad, va a durar meses o lo van a tocar varias personas — ahí la spec es lo que evita que cada sesión reinvente el criterio.

04 Para qué te va a servir

• Que la IA construya lo que tenías en la cabeza y no lo que ella completó.
• Tener un documento que sobrevive a la sesión: mañana Claude arranca de la spec, no de cero.
• Poder decir en voz alta qué no entra en la primera versión, que es la mitad del trabajo.

⚡ De la casa para vos

Va en la misma dirección que saas-builder, que ya está en esta Biblioteca: pensar antes de construir. La diferencia es que saas-builder te acompaña con criterio propio en cada área, y Spec Kit te da el proceso formal y los documentos. Se pueden usar juntos.