De README.md a PROGRAM.md: Markdown ya es un lenguaje de programación
Durante 22 años, Markdown fue un formato de documentación. Escribías READMEs, publicaciones de blog y notas. Explicaba cosas a los humanos.
Luego algo cambió. En 2024, los asistentes de código de IA empezaron a leer .cursorrules y copilot-instructions.md. En 2025, AGENTS.md emergió como un estándar universal. A principios de 2026, Andrej Karpathy publicó autoresearch, donde toda la contribución humana es un archivo Markdown llamado program.md.
La evolución es clara:
| Era | Archivo | Audiencia | Propósito |
|---|---|---|---|
| 2004-2023 | README.md | Humanos | Documentación |
| 2024 | .cursorrules | Herramientas de código IA | Reglas de estilo de código |
| 2025 | AGENTS.md | Agentes de código IA | Instrucciones de proyecto |
| 2026 | program.md | Agentes autónomos | Programas de investigación |
Markdown ya no es solo documentación. Es un lenguaje de programación para la IA.
Las tres generaciones
Generación 1: Documentación (README.md)
El caso de uso original de Markdown. Escribes un README para ayudar a los humanos a entender tu proyecto. Es pasivo — está ahí hasta que un humano lo lee. Ninguna máquina actúa sobre él.
Generación 2: Configuración (AGENTS.md, CLAUDE.md)
Los asistentes de código de IA necesitan contexto del proyecto. AGENTS.md les indica los comandos de build, las convenciones de código y las decisiones arquitectónicas. CLAUDE.md personaliza el comportamiento de Claude Code. Estos archivos son activos — una IA los lee y cambia su comportamiento en consecuencia.
Pero el humano sigue escribiendo el código. El archivo Markdown solo ayuda a la IA a asistir mejor.
Generación 3: Programación (program.md)
Con autoresearch, el humano no escribe ningún código en absoluto. Toda la contribución es program.md — un archivo Markdown que define objetivos de investigación, restricciones y estrategia. El agente de IA lo lee y luego escribe, ejecuta e itera de forma autónoma sobre el código durante horas o días.
Esto es Markdown como lenguaje de programación. El resultado no es texto formateado — es código en ejecución, resultados experimentales y descubrimientos científicos.
¿Por qué Markdown?
¿Por qué todos los sistemas de IA convergieron en Markdown en lugar de, digamos, YAML, JSON o un DSL personalizado?
Está en los datos de entrenamiento. Los LLMs han visto miles de millones de archivos Markdown durante el entrenamiento. Entienden sus convenciones en profundidad — los encabezados indican jerarquía, los puntos indican listas, los bloques de código indican contenido ejecutable.
Es flexible. Markdown no impone un esquema rígido. Puedes escribir instrucciones de forma libre, tablas estructuradas, ejemplos de código y lenguaje natural en el mismo archivo. Esta flexibilidad coincide con cómo los humanos piensan en dirigir agentes de IA.
Es auditable. Puedes leer un program.md y entender exactamente qué se le está diciendo al agente que haga. Intenta eso con una configuración YAML de 500 líneas.
Es versionable. Cada cambio en las instrucciones de tu agente es un commit de git. Puedes comparar, revisar y revertir cambios de comportamiento de agentes igual que los cambios de código.
Lo que esto significa para ti
Si Markdown se está convirtiendo en un lenguaje de programación, entonces todos los que escriben Markdown se están convirtiendo en programadores de algún tipo. La habilidad no es la sintaxis — es la claridad de pensamiento y la precisión de las instrucciones.
Lo que importa ahora:
Aprender a escribir instrucciones Markdown precisas. Cuanto mejor sea tu AGENTS.md o program.md, mejor rendirá tu agente de IA. Esta es una nueva habilidad que combina conocimiento técnico con escritura clara.
Construir una biblioteca de referencia en Markdown. Cuando escribes instrucciones para agentes de IA, necesitas material de referencia: documentación, ejemplos, artículos, mejores prácticas. Tener este material en formato Markdown limpio lo hace inmediatamente utilizable.
Entender el ecosistema Markdown para IA. Conocer la diferencia entre AGENTS.md, CLAUDE.md, llms.txt y program.md. Cada uno sirve un propósito diferente en la creciente pila Markdown-for-AI.
Capturar conocimiento para instrucciones de agentes
Escribir buenas instrucciones para agentes de IA requiere conocimiento. Necesitas entender el dominio, las herramientas, las restricciones y los objetivos. Gran parte de este conocimiento vive en la web — en páginas de documentación, publicaciones de blog, artículos de investigación y tutoriales.
Save convierte cualquiera de estas fuentes web en Markdown limpio con un clic. Cuando estás elaborando un program.md o AGENTS.md, tener tu material de referencia ya en Markdown significa que puedes extraer, referenciar y construir sobre él de inmediato.
Los investigadores que escriben los mejores archivos program.md no parten de cero. Están construyendo sobre el conocimiento que han capturado y organizado en formato Markdown.
Save convierte cualquier página web en Markdown limpio — perfecto para construir la biblioteca de referencia que necesitas para escribir instrucciones efectivas para agentes de IA. Prueba Save gratis
## Continue reading
Cómo escribir un buen program.md: guía práctica para instrucciones de agentes IA
program.md es el archivo que programa agentes IA en el autoresearch de Karpathy. Aquí está cómo escribir uno que obtenga resultados — con estructura, ejemplos y mejores prácticas.
El Autoresearch de Karpathy & PROGRAM.md: la IA que hace experimentos mientras duermes
El autoresearch de Andrej Karpathy permite a agentes IA ejecutar 100+ experimentos de ML durante la noche, guiados por un solo archivo Markdown llamado program.md. Aquí está cómo funciona y por qué importa.
El vibe coding ha muerto. Bienvenido al Agentic Engineering con Markdown.
Karpathy dice que el vibe coding es pasado. El nuevo paradigma es el Agentic Engineering, donde orquestas agentes IA a través de archivos Markdown en lugar de escribir código tú mismo.
AGENTS.md & CLAUDE.md: El nuevo README para agentes de codificación IA
Aprende cómo los archivos AGENTS.md y CLAUDE.md guían a los asistentes de codificación IA como GitHub Copilot, Cursor y Claude Code. Además, cómo escribir archivos de instrucciones efectivos para tus proyectos.
Written by
Jean-Sébastien Wallez
I've been making internet products for 10+ years. Built Save on weekends because I wanted my own reading library in clean markdown for Claude and Obsidian. Write here about web clipping, AI workflows, and the small things that make a personal knowledge base actually useful.