Tu agente de código escribe el plan.Revísalo antes de que escriba el código.

Revisa el plan antes del código

Una suposición errónea en un plan cuesta un comentario. La misma suposición en el código cuesta leer un diff, hacer un revert y volver a ejecutar. Lee primero el plan, mientras cambiarlo sale barato.

En una terminal, el plan es un bloque de texto largo por el que haces scroll. En DotMD es un documento renderizado, y cada observación queda unida al pasaje del que habla:

1. Pide el plan como archivo

   «Escribe el plan en docs/plan.md y envíamelo a DotMD para revisión».

2. Comenta donde esté mal

   Selecciona un pasaje, pulsa ⌥⌘M y escribe el cambio que quieres. Hazlo con todo el plan y luego haz clic en Send.

3. Comprueba las correcciones como un diff

   El agente edita el archivo; el texto antiguo va en rojo y el nuevo en verde, junto al comentario al que responde cada corrección. Accept, Reopen o Accept All.

4. Aprueba y deja que construya

   Haz clic en Approve y el agente sigue con el código.

El agente ve cada comentario con su pasaje, sus líneas y quién lo escribió, así que sabe exactamente a qué te refieres. También puede leer el pasaje que has seleccionado: «Reescribe el párrafo que seleccioné en DotMD».

Pídele que «me muestre los cambios en DotMD» cuando termine, y abre la revisión por ti.

Los documentos que escriben los agentes

Los planes son solo el principio. Los agentes escriben más cosas, y puedes revisarlas igual:

• Specs y documentos de diseño.
• Registros de decisiones de arquitectura (ADR).
• READMEs y entradas de CHANGELOG.
• Planes de migración, despliegue y pruebas.
• Tablas comparativas de librerías y servicios.

Un segundo agente también puede revisar el trabajo del primero: Claude Code escribe, Codex deja comentarios y tú decides. Consulta Un agente revisa a otro.

Encaja con tu entorno

DotMD ejecuta un pequeño servidor MCP en tu Mac y tu agente se conecta con una sola línea. Claude Code, Codex, Cursor y Visual Studio Code funcionan; cada guía tiene la configuración exacta.

• Archivos, no una copia. DotMD lee y escribe los archivos Markdown de la carpeta de tu proyecto. No hay nada que importar ni sincronizar.
• git. Cuando git, un editor o un agente cambian un archivo, DotMD lo detecta y conserva el texto anterior como versión. Los comentarios siguen a un archivo renombrado con git mv la primera vez que lo abres en su nuevo sitio.
• Docker. Un agente dentro de un contenedor llega a DotMD en http://host.docker.internal:8089/mcp.

Hazlo costumbre: unas líneas en AGENTS.md

Un agente envía un documento para revisión cuando se lo pides. Para que lo haga siempre y busque tus comentarios en DotMD, añade estas líneas a AGENTS.md para Codex o a CLAUDE.md para Claude Code:

Comments and reviews on Markdown files are kept in DotMD (MCP server `dotmd`), not in the files.
When I mention comments, a review or remarks on a .md file, read them with get_review_comments,
fix each one and send it back with resolve_review_comments.
After writing or substantially changing a spec, plan or design doc for me, send it to me with
request_review and wait for my answer; call it again after fixing my comments, until I approve.

La primera línea es la más importante. Tus comentarios los guarda DotMD, no el archivo, así que un agente que no piensa en DotMD los busca en el proyecto y no encuentra nada.

Tus archivos siguen siendo tuyos

• No hay cuentas. Tus archivos, comentarios e historial de versiones se quedan en tu Mac.
• El servidor MCP responde solo en 127.0.0.1, así que otros ordenadores no pueden llegar a él y las páginas web no pueden usarlo.
• Los comentarios y el historial los guarda DotMD, no tus archivos. El Markdown de tu repositorio no tiene marcas ni comentarios HTML.

Preguntas de desarrolladores

Más preguntas