Spec driven development: programar apps con IA

Le pedís una app a la IA, te devuelve 200 líneas de código, lo pegás, no funciona y no sabés por dónde empezar a arreglarlo. Ese momento de frustración es exactamente el problema que resuelve el spec driven development.

El error de arrancar por el código

Cuando trabajamos con asistentes de IA, la tentación es ir directo a la pregunta: “haceme una app de turnos”. El resultado suele ser genérico, incompleto o directamente inutilizable. La IA no falló: le dimos un objetivo difuso y esperamos precisión.

En el video Empieza a hacer apps sin saber programar, con Alan Buscaglia (conocido como “el Gentleman de la programación”), el punto de partida es justamente ese: antes de escribir una sola línea, hay que saber qué se quiere construir.

Qué es el spec driven development

Es una forma de trabajar en la que el spec (la especificación) manda. Antes de generar código, escribís con claridad qué tiene que hacer el sistema:

• Qué problema resuelve y para quién.
• Qué funcionalidades entran y cuáles quedan afuera.
• Cómo se ve la pantalla principal y qué datos maneja.
• Qué se considera “terminado” y qué sería un error.

Ese documento se convierte en el contexto que le entregás a la IA. Ya no le pedís magia: le pedís que implemente algo definido.

Por qué se volvió más importante con IA

La IA generativa acelera la escritura de código, pero no adivina intenciones. Cuanto más vago el pedido, más retrabajo. Y al revés: una especificación clara reduce las idas y vueltas, hace que las respuestas sean consistentes y permite que alguien sin formación técnica tradicional pueda avanzar igual.

Además, la spec cumple otra función: es tu red de seguridad. Si el resultado no sirve, no revisás 500 líneas a ciegas; comparás lo que salió con lo que habías pedido. El error se detecta antes y se corrige más rápido.

Cómo empezar, en pasos concretos

1. Escribí el objetivo en una frase. Si no podés, el proyecto es demasiado grande todavía.
2. Listá 3 a 5 funcionalidades. Nada más. Lo demás es ruido para la primera versión.
3. Definí la pantalla mínima. Qué ve el usuario y qué puede hacer ahí.
4. Pedile el código a la IA con ese contexto. Iterá sobre la spec, no sobre el desorden.
5. Probá, anotá qué falló y actualizá el documento. La spec es un archivo vivo.

La lógica se sostiene incluso si recién arrancás: pensar antes de pedir es la parte del trabajo que la IA todavía no hace por vos.

Para llevar

• El spec driven development pone la especificación primero y el código después: define el problema antes de resolverlo.
• Con IA, un pedido vago produce resultados vagos; un pedido claro produce resultados útiles.
• La especificación es tu criterio de control: te deja comparar lo pedido con lo obtenido sin leer todo el código.
• No necesitás saber programar para empezar, pero sí necesitás saber explicar qué querés construir.