El artículo explora la revitalización de la 'programación legible' (programación legible) en la era de los agentes de inteligencia artificial (IA). La programación legible, una técnica donde el código se entrelaza con prosa explicativa, permite que incluso personas no expertas comprendan el funcionamiento de un programa. Aunque conceptualmente atractiva, históricamente ha sido poco utilizada debido a la dificultad de mantener sincronizados el código y la documentación, convirtiéndose en una tarea tediosa. Tradicionalmente, se ha visto en forma de Jupyter notebooks en el ámbito de la ciencia de datos, o a través de herramientas como Org Mode en Emacs, pero estas soluciones a menudo resultan complejas para proyectos grandes.
El autor ha experimentado con Org Mode para tareas como pruebas manuales y documentación, encontrando útil la combinación de ejecución de comandos y toma de notas en un solo documento. Sin embargo, el verdadero potencial surge con la llegada de los agentes de IA como Claude y Kimi, que comprenden la sintaxis de Org Mode y pueden generar y mantener el código y la documentación de manera eficiente. Estos agentes pueden escribir 'runbooks' (documentos de ejecución) en Org, permitiendo a los desarrolladores revisar el código, editarlo y solicitar al agente que actualice la documentación correspondiente, eliminando así el problema de mantener dos narrativas separadas.
La clave es que el agente se convierte en el responsable de la 'tangle' (extracción del código del documento Org), automatizando un proceso que antes era manual y propenso a errores. Esto no solo simplifica el flujo de trabajo, sino que también abre la puerta a la exportación del código base en múltiples formatos, lo que es especialmente valioso en un entorno donde los ingenieros pasan más tiempo leyendo código que escribiéndolo. Además, la presencia constante de la documentación junto al código podría mejorar la calidad del código generado. Aunque el autor aún no ha aplicado esta técnica a proyectos a gran escala, considera que la combinación de programación legible y agentes de IA representa un cambio de paradigma significativo, permitiendo la creación de bases de código que pueden ser leídas como una narrativa coherente, mantenida en sincronía por máquinas.
Finalmente, el artículo reconoce que Org Mode, aunque potente, puede ser una limitación debido a su estrecha integración con Emacs. Sin embargo, el autor enfatiza que el concepto subyacente de programación legible es lo que realmente importa, y sugiere que Markdown (con la adición de metadatos) podría ser una alternativa viable en el futuro.