# PLAN.md

> Plantilla de plan de proyecto para construir con IA.
> Llenala **antes** de pedir la primera línea de código y pasásela a tu agente
> junto con el resto de los archivos de contexto.
>
> Para qué sirve: sin esto, la IA arranca por lo que le parece más divertido de
> construir y a los tres días tenés un proyecto con tres animaciones y ningún
> formulario que funcione. El plan es lo que ordena en qué orden se hace y,
> sobre todo, qué no se hace.

---

## 1. Qué es esto en una frase

<!-- Una sola oración. Si necesitás dos, todavía no está claro.
     Ejemplo: "Un sitio de una página para una clínica dental que convierta
     visitas en citas agendadas." -->

## 2. Para quién

<!-- Quién lo va a usar y qué está tratando de lograr cuando llega.
     No es demografía, es intención: "alguien con dolor de muela un domingo
     buscando quién atiende hoy" es útil; "mujeres de 25 a 45" no. -->

## 3. Qué tiene que pasar para que esto haya servido

<!-- El resultado medible. Si no se puede contar, no va acá.
     Ejemplo: "3 citas agendadas por semana desde el sitio."
     Este número es el que decide después qué se construye y qué se corta. -->

---

## 4. Las épicas

Bloques grandes de trabajo. Entre 3 y 6. Si te salen 12, estás listando tareas,
no épicas.

| # | Épica | Para qué existe | Prioridad |
|---|---|---|---|
| E1 | | | Alta |
| E2 | | | Alta |
| E3 | | | Media |
| E4 | | | Baja |

**Regla de orden:** la épica que toca la plata o el resultado de la sección 3 va
primero. Siempre. El diseño de la sección "sobre nosotros" no bloquea a nadie.

---

## 5. Las historias de usuario

Una por cada cosa que alguien tiene que poder hacer. Formato:

> **Como** [quién], **quiero** [qué], **para** [por qué].
>
> **Se considera terminada cuando:**
> - [ ] Condición verificable 1
> - [ ] Condición verificable 2

Las condiciones tienen que poder revisarse mirando la pantalla, no leyendo el
código. "El formulario valida bien" no sirve. "Si mando el formulario vacío,
aparece un mensaje debajo de cada campo obligatorio y no se envía nada" sí.

### E1

<!-- Historias de la épica 1 -->

### E2

<!-- Historias de la épica 2 -->

---

## 6. Los edge cases

Acá es donde se separa una demo de algo que se puede cobrar. La IA no los
piensa solos: hay que escribirlos.

Por cada historia importante, contestá:

- **¿Qué pasa si está vacío?** Sin datos, primera visita, lista sin resultados.
- **¿Qué pasa si falla?** Se cayó la red, el pago fue rechazado, el correo
  rebotó. Qué ve la persona y qué puede hacer al respecto.
- **¿Qué pasa si lo hacen dos veces?** Doble clic en pagar, formulario enviado
  dos veces, refrescar la página de confirmación.
- **¿Qué pasa si viene mal escrito?** Correo sin arroba, texto donde va un
  número, alguien pegando 4,000 caracteres en un campo de nombre.
- **¿Qué pasa en un teléfono?** Con una mano, en datos móviles, con el teclado
  tapando media pantalla.
- **¿Qué pasa si no hay JavaScript o carga lento?** Qué se ve mientras tanto.

| Caso | Qué debería pasar |
|---|---|
| | |
| | |

---

## 7. Lo que NO se construye

<!-- La sección más importante del archivo y la que todos dejan vacía.
     Escribí acá lo que ya se te ocurrió y decidiste dejar afuera, con el
     porqué. Sirve para dos cosas: que la IA no lo agregue por iniciativa
     propia, y que dentro de tres semanas no lo rediscutas de cero. -->

- **No va:** … **Porque:** …
- **No va:** … **Porque:** …

---

## 8. Decisiones tomadas

Cada vez que elijas entre dos caminos, anotalo con la fecha y la razón. Es lo
que evita rehacer la misma discusión y le da a la IA el criterio, no solo el
resultado.

| Fecha | Decisión | Por qué | Qué se descartó |
|---|---|---|---|
| | | | |

---

## 9. Cómo se sabe que está listo para publicar

- [ ] Todas las historias de las épicas de prioridad alta están terminadas
- [ ] Los edge cases de la tabla están cubiertos y probados a mano
- [ ] Lo que cobra, cobra de verdad, probado con un pago real
- [ ] Los correos llegan a bandeja de entrada, no a spam
- [ ] Está medido: se sabe cuánta gente llega y cuánta convierte
- [ ] Google lo puede encontrar y la vista previa del link se ve bien
- [ ] Se revisó en un teléfono de verdad, no solo en el navegador achicado