Carson Gross, profesor y consultor de software, propone que el Markdown debe almacenarse en la carpeta /src junto al código generado por agentes de IA, reemplazando a los prompts efímeros como fuente de verdad. Este artículo argumenta que, aunque el código generado por LLMs es la realidad operativa actual, la documentación en Markdown ofrece ventajas técnicas como ser texto plano, difable y legible por humanos sin herramientas. Gross sugiere crear una nueva estructura de directorios, /src/md, para capturar decisiones arquitectónicas y de diseño a nivel de código, manteniendo la localidad del contexto para agentes y humanos. La propuesta distingue entre la especificación estática en Markdown, que debe ser curada por humanos, y las pruebas automatizadas en /test, que derivan de dicha documentación. Este enfoque busca reducir la dependencia de wikis externas o herramientas de gestión de proyectos para la lógica central del sistema, integrando la intención del código directamente en su ubicación física. El autor reconoce que esta es una propuesta experimental y abierta a discusión, destacando que el Markdown debe mantenerse a un nivel de abstracción adecuado y que los agentes de IA no deben generar contenido en esta carpeta, sino que los desarrolladores humanos deben sincronizar la documentación con el código resultante.
Noticias agregadas con IA