¿Por qué cuatro archivos y no uno?
En este artículo te explico por qué dividir la documentación del proyecto en discovery.md, research.md, plan.md y progress.md brinda a la IA el contexto exacto, evita explicaciones repetidas y permite que cada sesión continúe justo donde la anterior terminó.
La inteligencia artificial no tiene memoria. Sin estructura, cada sesión comienza desde cero. Aquí está cómo solucionarlo.
Etiquetas: Vibecoding · Estructura de proyecto · Flujo de trabajo de IA · Productividad
La mayoría de los proyectos codificados con vibecoding no fallan porque la idea es mala. Fallan porque no hay estructura. Abres una nueva sesión de IA, explicas el proyecto desde cero, llegas a la mitad de una característica, cierras la pestaña y la próxima vez que la abras, la IA no tiene idea de qué estabas construyendo o por qué.
Esto no es un defecto en la IA. Simplemente no tiene memoria entre sesiones. Así que la solución es simple: tú le das la memoria.
Utilizo cuatro archivos de markdown para cada proyecto. Viven en la raíz del repositorio, se confirman como cualquier otro código y son lo primero que pego en cualquier nueva sesión de IA.
No los llenas manualmente. Utilizas una solicitud. La IA te entrevista, hace las preguntas adecuadas una a la vez y construye el archivo a partir de tus respuestas.
¿Por qué cuatro archivos y no uno?
Podrías volcar todo en un solo archivo grande. Pero mantenerlos separados significa que solo pegas lo que es relevante. Comenzar una nueva sesión para trabajar en una característica! Pega `plan.md` y `progress.md`. Revisar una decisión técnica? `research.md` lo tiene. Cada archivo tiene un trabajo. Eso los hace fáciles de actualizar y fáciles de usar.
