El Markdown se convierte en código fuente y debe guardarse en /src
Markdown in /src
Carson Gross sostiene que el Markdown está dejando de ser documentación para convertirse en código fuente. En entornos profesionales de programación agéntica, los prompts efímeros se pierden y el código generado queda como única verdad. Propone capturar la intención en archivos Markdown dentro de /src/md, junto al código, para que tanto humanos como agentes accedan al contexto. El código y los tests deberían derivarse de ese Markdown, no de sesiones de prompts.
A medida que el código se vuelve más barato de generar, lo que sigue siendo valioso es la intención detrás del código: qué hace, por qué lo hace y qué no debe hacer.