Qué escriben los agentes
| Archivo | Qué es | Quién lo escribe |
|---|---|---|
AGENTS.md, CLAUDE.md | Instrucciones que el agente lee al principio de cada sesión | Tú, a menudo con ayuda del agente |
| Planes y especificaciones | Lo que el agente está a punto de construir, paso a paso | El agente, cuando le pides un plan |
| Notas y decisiones | Por qué hizo algo, qué probó | El agente |
| Informes y resúmenes | Qué hizo, qué queda por hacer | El agente, al final de una tarea |
| Archivos de memoria | Cosas que ha aprendido sobre ti y sobre el proyecto | Algunos 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.
- Añade una carpeta en Mis carpetas. Cuando un agente escribe un archivo ahí, aparece marcado con N (nuevo) o U (actualizado). Un archivo abierto se recarga cuando un agente u otra app lo modifica, y conserva tu posición.
- Mira lo que ha cambiado. Cuando un archivo ha cambiado desde la última vez que lo leíste, un aviso lo indica. Haz clic en Resaltar cambios: el texto añadido sale en azul y el texto eliminado o editado, en naranja. Recorre los cambios con ↑ y ↓. El filtro Modificados de Mis carpetas muestra todos los archivos que han cambiado.
- Compara en paralelo, como la página mostrada con formato o como el código fuente.
- Vuelve atrás. Con el historial de archivos activado, Archivo › Mostrar historial… muestra las versiones guardadas. Cuando usas Restaurar con una versión anterior, el archivo actual se guarda antes en el historial. En un archivo que tienes abierto, el historial conserva cada guardado hecho por otra app. En un archivo que no está abierto, puede que no se conserven todos los guardados hechos con menos de un segundo de diferencia.
- Si editas mientras el agente escribe, PilcrowMD te avisa y te pregunta antes de guardar encima del cambio del agente.
- Sin cuenta, sin seguimiento, sin conexión a internet. Firmada y notarizada por Apple.
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.
- Mis carpetas se actualiza cuando vuelves a la lista o tiras hacia abajo para actualizar.
- Google Drive puede tardar en transmitir un cambio hecho en tu ordenador. Abre el archivo: Drive descarga entonces la versión nueva, y PilcrowMD ofrece Toca para recargar.
- No hay recarga en directo ni comprobación en segundo plano, y en Android no hay Comparar. Abre el archivo para ver lo más reciente.
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)