El plano de tu app

Un repo instalable con las cinco preguntas exactas que se le hacen a un cliente (o a ti) antes de construir una app, la plantilla del plano por secciones, y el plano real de una app de cliente en producción como ejemplo lleno.

Para qué sirve

Una app que se construye sin plano se construye tres veces. El plano es un documento de dos páginas que fija qué hace la app, para quién, qué NO hace, y en qué orden se construye. Claude Code construye mucho mejor desde un plano que desde una conversación.

Las cinco preguntas

1. Quién la usa y qué hace hoy sin la app (la tarea a mano, con tiempos).
2. Cuál es la única cosa que tiene que hacer bien (si hace solo eso, ya sirve).
3. De dónde entran los datos y a dónde salen (una hoja, un formulario, una API, un chat).
4. Qué pasa cuando algo falla (quién se entera y cómo).
5. Qué NO va en la versión 1 (la lista de lo que se dijo «después»).

La plantilla del plano

# Plano: [nombre de la app]
## 1. Para quién y para qué (de la pregunta 1)
## 2. La única cosa (de la 2): en una frase, y cómo se mide que la hace bien
## 3. Datos: entradas, salidas, y qué se guarda (de la 3)
## 4. Pantallas: una lista, con qué se ve y qué se toca en cada una (máximo 5 en la v1)
## 5. Cuando falla (de la 4)
## 6. Lo que NO va en la v1 (de la 5)
## 7. Orden de construcción: qué se hace primero para poder probar antes
## 8. Cómo se prueba: 3 casos con entrada y salida esperada

El ejemplo lleno (resumido)

App de un cliente: nutricionista que arma planes de alimentación. La única cosa: que el motor proponga el plan una vez y todo lo que ella edite se recalcule y se mande. Datos: entran las medidas y preferencias por formulario; sale el PDF por WhatsApp. Pantallas: 4. Cuando falla: si un macro no cuadra, la app lo marca en rojo y no manda. NO va en la v1: la app del paciente. Orden: motor → edición → PDF → envío. Pruebas: tres pacientes reales con planes que ella ya había hecho a mano, comparados.

Cómo se usa con Claude Code

Lee PLANO.md. Construye solo la sección 7, paso 1. Cuando termine, corre el caso de prueba 1 de la sección 8 y muéstrame el resultado antes de seguir.

Un paso por vez. La app se prueba desde el primer paso, no al final.

Qué NO resuelve

No decide si la app vale la pena: eso se decide con la pregunta 1 (cuánto tiempo devuelve).

Siguiente paso

Si la app tiene una página pública, «Landing en dos pasos» hace el diseño con el mismo método: primero el archivo, después el código.