Documento de concepto — una página
Una página. No más. Si el concepto no cabe en una página, no lo entiendes todavía o estás incluyendo el producto final en lugar del MVP. Este documento vive en el repo como `specs/concept.md` y el agente lo lee al empezar cualquier sesión larga.
Concepto claro = una página que cualquier persona — humana o agente — puede leer en 3 minutos y saber qué construir.
La estructura de la página
- Qué hace (1 frase) — tu fórmula del subtema "qué hace el producto".
- Para quién (3 líneas) — el ICP con atributos.
- Problema que resuelve (1 párrafo) — "hoy, [usuario] pierde [X] cuando [contexto]".
- Flujo mínimo (5 cajas) — los 5 pasos del usuario al valor.
- Dentro de v1 (lista) — features mínimas.
- Fuera de v1 (lista con razones) — recortes conscientes.
- Diferenciadores reales (3 items) — pasados por el test.
- Criterio de éxito (1 métrica) — qué cuenta como "el MVP funciona".
Cómo se usa
El agente lo lee al inicio de cada sesión. Cuando propone algo que sale de scope, apunta a la razón del punto 6. Cuando añade feature "lógica", revisa contra 5. Cuando dudas de decisión, vuelves al 1.
Una sola página elimina el 80% del ir y venir "¿era parte del MVP?".
La prueba del documento
Dáselo a tres personas distintas: un developer, un usuario ideal, un inversionista. Cada uno debería poder resumir el producto sin hacer preguntas. Si alguno tiene que preguntar, el documento se ajusta.
Escribe tu `specs/concept.md` en una sentada de 60 minutos. Al terminar, pásalo a dos personas distintas y pídeles que lo resuman. Si los resúmenes no coinciden, reescribe.
- Una sola página, ocho secciones, formato fijo.
- Vive en el repo como `specs/concept.md` y el agente lo lee al inicio de sesiones largas.
- La prueba del documento: tres personas distintas deben poder resumirlo igual sin preguntar.