CLAUDE.md y AGENTS.mdleídos, editados y revisados en tu Mac.
Estos archivos le dicen a Claude Code y a Codex cómo trabajar en tu proyecto. DotMD los muestra como páginas, guarda cada versión y puede añadir las líneas que hacen que tu agente te envíe sus especificaciones para revisión.
macOS 14 o posterior. Leer es gratis; editar y revisar se pagan una sola vez.
Respuesta rápida
CLAUDE.md y AGENTS.md son archivos Markdown normales, así que DotMD los abre como cualquier .md: renderizados, con un índice y todas las versiones guardadas. En Settings → MCP → Agent rules, Add to Claude Code o Add to Codex pone las reglas de revisión de DotMD en ~/.claude/CLAUDE.md o ~/.codex/AGENTS.md, para que el agente te envíe cada especificación y espere tus comentarios.
Abrir y editar CLAUDE.md y AGENTS.md
Pulsa ⌘O y elige la carpeta del proyecto: su CLAUDE.md y su AGENTS.md aparecen en la barra lateral con el resto de su Markdown y se abren como páginas con un índice. La barra lateral omite las carpetas ocultas, así que para ~/.claude/CLAUDE.md pulsa ⌘O, luego ⇧⌘G en el panel y escribe la ruta.
Para cambiar un archivo, pulsa ⌘E. La página se convierte en texto que se formatea mientras escribes, y cada cambio se guarda de inmediato en el archivo. Editar forma parte de DotMD Editor.
Cuando el agente edita el archivo
Cuando Claude Code, Codex o git cambian un archivo de tu espacio de trabajo, la página abierta se recarga sola y un aviso muestra Changed on disk con las líneas añadidas y quitadas. Show Changes abre el historial de versiones; con DotMD Reviewer el texto antiguo sale en rojo y el nuevo en verde.
Si el archivo cambia mientras escribes en él, DotMD pregunta Load from Disk o Keep My Version, y guarda tu texto en el historial en cualquier caso.
Para revisar una a una las correcciones de un agente, mira revisar los cambios de un agente.
Añade las reglas de revisión de DotMD con un clic
Los modelos dan más peso a tus propios CLAUDE.md y AGENTS.md que a lo que una herramienta dice de sí misma, así que DotMD puede poner en ellos las líneas que hacen que un agente use la revisión. Abre Settings → MCP, despliega Agent rules y pulsa Add to Claude Code o Add to Codex. Las reglas van a ~/.claude/CLAUDE.md o a ~/.codex/AGENTS.md:
<!-- dotmd:begin (added by DotMD; DotMD can update or remove this block) -->
## DotMD
- When you create or substantially change a spec, plan, design doc or any Markdown document for the user, your LAST step is to call the DotMD MCP tool `request_review` with the file's path and wait for the answer. While it says the user is still reviewing, call it again. Never end your turn by just saying the file is ready.
- Fix each review comment, call `resolve_review_comments`, then `request_review` again until the user approves.
- When you review a file for the user, leave your remarks with `add_review_comments` and finish with `complete_review`.
<!-- dotmd:end -->
DotMD cambia solo la parte entre sus dos líneas de marca y guarda una copia del archivo anterior a su primer cambio, que termina en .dotmd-backup. Update sustituye el bloque cuando un DotMD más nuevo trae mejores reglas, y Remove lo quita.
Para el archivo propio de un proyecto, o para Cursor y otros agentes, pulsa Copy en el mismo sitio y pega las líneas donde el agente lee sus reglas. Las guías de Claude Code y Codex muestran un conjunto más corto que también puedes usar.
Qué hace el agente con ellas
Con las reglas puestas, el agente te envía cada especificación, plan o documento de diseño que escribe (request_review), espera mientras comentas, corrige cada comentario y lo envía de nuevo hasta que apruebes. Las revisiones con agentes por MCP forman parte de DotMD Reviewer.
Preguntas sobre CLAUDE.md y AGENTS.md
¿Qué son CLAUDE.md y AGENTS.md?
Archivos Markdown con instrucciones para un agente de programación. Claude Code lee CLAUDE.md y Codex lee AGENTS.md, en tu proyecto o, para todos los proyectos, en ~/.claude y ~/.codex.
¿DotMD cambia mi CLAUDE.md por su cuenta?
No. DotMD escribe en el archivo solo cuando pulsas Add o Update en Settings → MCP → Agent rules, y solo entre sus dos líneas de marca. Antes guarda una copia del archivo como .dotmd-backup.
¿Puedo editar CLAUDE.md en DotMD mientras el agente trabaja?
Sí. Cuando un agente cambia el archivo, la página se recarga. Si estabas escribiendo, DotMD pregunta si cargar el archivo del disco o conservar tu versión.
¿Necesito DotMD Reviewer para editar estos archivos?
No. Abrirlos es gratis y editar forma parte de DotMD Editor ($14.99 una vez). Las revisiones con agentes por MCP, que las reglas piden al agente que use, forman parte de DotMD Reviewer ($39.99 una vez).