Cómo leer los archivos Markdown que escriben tus agentes de IA

Los agentes de programación con IA escriben mucho Markdown. Un plan antes de empezar. Una especificación. Notas sobre lo que han decidido. Un informe cuando terminan. Archivos de instrucciones que leen, como AGENTS.md o CLAUDE.md. A menudo, un archivo de memoria al que van añadiendo cosas.

Todo es texto sin formato con #, ** y | dentro. Puedes leerlo en un editor de código, pero los planes largos y las tablas son difíciles de leer ahí, y es fácil pasar por alto lo que el agente acaba de cambiar.

Esta página trata de cómo leer esos archivos: como páginas limpias y de una manera que te muestre lo que ha cambiado.

Qué escriben los agentes

ArchivoQué esQuién lo escribe
AGENTS.md, CLAUDE.mdInstrucciones que el agente lee al principio de cada sesiónTú, a menudo con ayuda del agente
Planes y especificacionesLo que el agente está a punto de construir, paso a pasoEl agente, cuando le pides un plan
Notas y decisionesPor qué hizo algo, qué probóEl agente
Informes y resúmenesQué hizo, qué queda por hacerEl agente, al final de una tarea
Archivos de memoriaCosas que ha aprendido sobre ti y sobre el proyectoAlgunos agentes, por su cuenta

Páginas específicas de cada agente:

Tres cosas que ayudan

1. Lee la carpeta, no un solo archivo. Los agentes escriben muchos archivos en varias carpetas. Abre toda la carpeta del proyecto en un lector de Markdown, para poder moverte entre el plan, la especificación y el informe.

2. Mira los archivos nuevos y modificados. Mientras un agente trabaja, aparecen archivos y cambian. Quieres ver cuáles, sin abrir cada uno.

3. Mira lo que ha cambiado dentro de un archivo. Cuando un agente edita un plan que ya has leído, quieres ver solo lo que ha cambiado, sin volver a leer todo el plan.

En un Mac: PilcrowMD (beta)

PilcrowMD para Mac (beta) es un lector de Markdown gratuito creado para esto.

PilcrowMD para Mac (beta)

En tu teléfono: comprueba el trabajo del agente

Los agentes no se ejecutan en un teléfono, pero puedes leer lo que escribieron. Si la carpeta del agente se sincroniza con Google Drive, añade esa carpeta en Mis carpetas en PilcrowMD para Android.

Probado con Google Drive y con el almacenamiento del teléfono. Otras apps en la nube pueden funcionar si muestran sus carpetas en el selector de carpetas de Android.

Preguntas frecuentes

¿Necesito PilcrowMD para leer estos archivos? No. Son texto sin formato; cualquier editor los abre. Un lector de Markdown muestra las tablas, el código y los títulos como una página, lo que ayuda con los planes largos.

¿PilcrowMD cambiará los archivos de mi agente? No, a menos que edites y guardes. En caso contrario no se escribe nada, y te pregunta antes de guardar encima de un cambio hecho por otra app.

¿Envía mis archivos a alguna parte? No. La app para Mac no se conecta a internet, y la app para Android no tiene permiso de internet. En Android, la sincronización la hace la app en la nube que hayas elegido, como Google Drive.

También en Mac: PilcrowMD para Mac (beta)