De la idea al blueprint: planificá antes de construir

Ya construiste apps chicas con IA y quisiste ir por algo más grande… y a mitad de camino el proyecto se te desarmó: la IA olvidó decisiones, agregó cosas que nadie pidió y vos ya no sabías qué faltaba. Este tutorial te enseña a escribir un blueprint —un plan corto en un archivo de texto que la IA lee antes de tocar código— para que los proyectos de varios días lleguen enteros al final. Es para vos si ya viviste el ciclo pedir-probar-corregir y querés subir de nivel.

Antes de empezar

• Haber construido al menos una app chica con IA. Si todavía no, empezá por ahí: el blueprint sirve cuando el proyecto ya no entra en un solo archivo.
• Un lugar donde escribir el plan. Un archivo de texto alcanza. Si usás Claude Code, mejor: el blueprint vive en la carpeta del proyecto y la IA lo lee en cada sesión.
• Una idea real que te pique. Con ideas de mentira no se aprende a recortar, y recortar es el corazón de este método.

Paso 1 — Escribí la frase madre

Una sola frase con tres partes: qué hace, para quién, qué problema resuelve. "Una agenda donde un gimnasio registra a sus alumnos y ve quién no viene hace dos semanas" — eso es una frase madre. Si necesitás dos frases, probablemente tengas dos apps: elegí una y la otra va a la lista de "después".

Paso 2 — Repartí las funciones en tres columnas

Anotá todo lo que se te ocurra y repartilo sin piedad:

• V1: lo mínimo que ya sirve usándose. Tres a cinco funciones, no más.
• Después: buenas ideas que hoy estorban.
• Nunca: lo que suena lindo pero no es tu app (ahí suelen caer "notificaciones", "app móvil" y "que tenga IA").

La columna V1 chica no es falta de ambición: es lo que hace que llegues al final con algo usable en la mano.

Paso 3 — Describí los datos con palabras

Antes de construir, escribí qué cosas guarda la app y qué tiene cada una: "un alumno tiene nombre, teléfono, plan y fecha de última visita". Sin jerga, en español. Este paso de cinco minutos evita la mitad de los retrabajos, porque cambiar los datos a mitad de proyecto es lo más caro que hay.

Paso 4 — Armá el BLUEPRINT.md

Juntá todo en un archivo con esta estructura (adaptala, pero no la agrandes):

# BLUEPRINT — [nombre de la app]

## Qué es (una frase)
...

## Quién la usa
...

## Funciones de la V1
- ...

## Explícitamente FUERA de la V1
- ...

## Datos que guarda
- Alumno: nombre, teléfono, plan, última visita
- ...

## Pantallas
1. ...

## Cómo sé que está terminada
- [ ] Puedo registrar un alumno y verlo en la lista
- [ ] ...

Una página, dos como máximo. La sección "FUERA de la V1" es la más valiosa del archivo: le corta el paso a la IA cuando quiere agregar de más… y a vos también.

Paso 5 — Hacé que la IA lo ataque antes de construir

Pasale el blueprint con esta consigna:

Leé este blueprint. NO construyas nada todavía. Decime: qué falta
definir, qué contradicciones ves, y qué tres preguntas me harías
antes de empezar. Sé duro.

Las preguntas que te devuelva son los huecos que te iban a explotar en el día tres. Respondelas, actualizá el archivo, repetí hasta que no queden huecos graves. Media hora acá vale días después.

Paso 6 — Construí por etapas contra el blueprint

Nada de "hacé todo". Pedí etapas verificables: "Etapa 1: la lista de alumnos con alta y baja. Nada más." Probás, tildás lo que corresponda en "Cómo sé que está terminada", y recién ahí pedís la etapa 2. Si en el camino cambiás de opinión —va a pasar—, primero corregís el blueprint y después pedís el cambio. El archivo siempre refleja el plan vigente.

Errores comunes

• Blueprint de diez páginas. La parálisis por planificación es tan mortal como no planificar. Arreglo: máximo dos páginas; si sobra, va a "después".
• Saltarse la sección "FUERA de la V1". Sin ella, cada sesión agrega funciones fantasma. Arreglo: escribila aunque te duela, y defendela.
• No actualizar el archivo cuando el rumbo cambia. A la tercera sesión la IA sigue el plan viejo y vos el nuevo. Arreglo: el blueprint se toca antes que el código, siempre.
• Tratarlo como contrato. Es un mapa, no una cadena: si al probar descubrís algo mejor, cambialo con criterio y seguí.

Siguiente paso

Con blueprint ya podés encarar proyectos de una o dos semanas sin que se desarmen. Lo que sigue: aprender a versionar tu proyecto (guardar puntos de retorno para experimentar sin miedo) y a trabajar con la IA en la carpeta del proyecto, donde el blueprint se vuelve la memoria compartida entre vos y la máquina, sesión tras sesión.