MarsDawn

Revisar el plan de un agente en cinco minutos

Tu agente escribió un plan y espera tu visto bueno. Tienes cinco minutos, no una hora. Esta es una forma de aprovecharlos que funciona en cualquier editor, incluso en uno de texto plano. MarsDawn ayuda con algunos pasos, y te diremos cuáles. No ayuda con el más importante.

No leas el plan de arriba abajo. Revisa su estructura, comprueba una afirmación, encuentra lo irreversible, mira los diagramas y el alcance, y escribe comentarios que el agente pueda aplicar. Seis pasos, unos cinco minutos.

Por qué importa antes de ejecutarlo

Chip Huyen, al explicar por qué la planificación debe ir separada de la ejecución, pone el costo sin rodeos: «Sin supervisión, un agente puede ejecutar esos pasos durante horas, gastando tiempo y dinero en llamadas a la API, antes de que te des cuenta de que no lleva a ninguna parte». Lo que añadimos nosotros: un plan es el lugar más barato para detectar un error. Corregir una línea de plan.md cuesta una frase. Corregir lo que el agente hizo después cuesta una tarde.

El ejemplo

Le pediste a un agente que moviera los avatares de los usuarios a un almacenamiento de objetos sin romper los enlaces existentes. Te devuelve esto:

# Plan: move user avatars to object storage

## Goal
Serve avatars from object storage instead of the app server.

## Steps
1. Add a storage client and config. ✅ done
2. Write a script that copies existing avatars to the bucket.
3. Switch the avatar URLs in the templates.
4. Delete `public/avatars/` from the server.
5. Run the copy script.

## Status
All tests pass.

Se lee bien. También borraría todos los avatares antes de copiar uno solo.

Los seis pasos

1. Lee solo los encabezados. (un minuto aproximadamente) ¿El plan coincide con lo que pediste? Si falta una sección, normalmente falta trabajo. Aquí: Goal, Steps, Status. Pediste que los enlaces existentes siguieran funcionando, y ningún encabezado habla de los enlaces antiguos ni de cómo deshacer el cambio. Ese es tu primer comentario.

En una terminal, grep -n '^#' plan.md muestra solo los encabezados, y la mayoría de los editores también pueden mostrar un esquema. En MarsDawn, la pestaña Esquema de la barra lateral (Visualización ▸ Mostrar barra lateral, ⌃⌘S) los enumera, y un clic te lleva a cada uno.

2. Encuentra cada lugar que afirme que algo está hecho, que pasó o que se verificó, y comprueba uno tú mismo. (un minuto aproximadamente) Abre el archivo, ejecuta la prueba, cuenta las filas. Chip Huyen describe un fallo en el que «el agente está convencido de haber completado una tarea cuando no es así». En su ejemplo, a un agente se le pide alojar a 50 personas en 30 habitaciones de hotel, acomoda a 40 y dice que terminó.

grep -n -i -E 'done|pass|verified|✅' plan.md

Aquí encuentra «✅ done» y «All tests pass.» ¿Qué pruebas? ¿Alguna toca los avatares? Ejecútalas, o pregunta. MarsDawn no puede hacer este paso por ti. Nadie más que tú puede.

3. Busca los pasos que no se pueden deshacer. (un minuto aproximadamente) Borrar datos, migraciones, force-push, cualquier cosa que envíe, pague o publique. Esos esperan tu aprobación explícita. Chip Huyen describe la misma idea desde el lado del sistema: «Si un plan incluye operaciones riesgosas, como actualizar una base de datos o fusionar un cambio de código, el sistema puede pedir aprobación humana explícita antes de ejecutarlas, o dejar que las ejecuten personas». Aquí, el paso 4 borra los originales, y va antes del paso 5, la copia.

4. Lee los diagramas renderizados y compara cada flecha con el texto. Un diagrama de flujo que dice «copiar → verificar → borrar» mientras los pasos dicen otra cosa es un hallazgo. Este plan no tiene diagramas, así que hoy te lo saltas. Cuando haya uno, mira la imagen, no el código Mermaid: muchos editores tienen vista previa, y Cómo ver un archivo Markdown en la Mac y Ver Markdown en otros lugares recorren las opciones. En MarsDawn, el diagrama renderizado está junto a su código (⌘2), y un diagrama roto muestra su código con el error debajo, lo que merece un comentario propio.

5. Haz una lista de los archivos y sistemas que toca el plan, y pregunta por todo lo que no pediste. (pasos 4 y 5 juntos, un minuto aproximadamente) Aquí: la configuración de almacenamiento, las plantillas, una carpeta en el servidor, un bucket. ¿Quién puede leer el bucket? No dijiste que debiera ser público. Si abriste la carpeta de trabajo del agente en MarsDawn (Archivo ▸ Abrir carpeta…, ⇧⌘O), los archivos nuevos que escribe aparecen en la pestaña Archivos en un segundo aproximadamente, y el encabezado muestra la rama de git o el worktree, para que sepas qué copia de trabajo estás revisando.

6. Escribe tus comentarios como lugar, problema y solución, un problema por línea. (el último minuto)

plan.md:10: deletes the avatars before step 5 copies them. Copy first, check the count, then delete, and wait for my OK before deleting.
plan.md:14: which tests? Add one that loads an old avatar URL after the switch.
plan.md:6: nothing about keeping old links working. Add a step for that, and a way to undo the switch.

Cualquier editor con números de línea sirve. En MarsDawn, Edición ▸ Copiar referencia (⌥⌘C) copia tu posición como plan.md:10, y Copiar para IA (⌃⌥⌘C) añade debajo el texto seleccionado.

Si tienes un minuto

Haz el paso 2. Ahí es donde atrapas a un agente que cree que ya terminó.

Cuando cinco minutos no bastan

A veces no puedes saber si un paso es correcto, porque está fuera de lo que conoces. Jess Ou, en el artículo explicativo de LangChain sobre agentes de 2026, lo dice en dos frases: «No delegues un juicio que no puedes evaluar. Si tú no reconocerías una buena respuesta, el agente tampoco». Lo que concluimos nosotros: si no puedes juzgar un paso, eso no es motivo para aprobarlo más rápido. Es motivo para preguntarle a alguien que sí pueda.

Qué hace MarsDawn aquí, y qué no

MarsDawn no incluye ningún modelo de IA. No encontrará los problemas de este plan, y no hace ni el paso 2 ni el paso 3. Mantiene el archivo legible mientras trabajas: el esquema para el paso 1, los diagramas renderizados para el paso 4, la pestaña Archivos para el paso 5, las referencias de línea para el paso 6. Y si el agente revisa el plan mientras lo lees, MarsDawn lo recarga y conserva tu posición, siempre que no tengas cambios sin guardar.

Cuando el plan esté decidido, si alguien más necesita verlo, Compartir PDF exportados y Markdown a PDF explican cómo enviarlo en PDF.

Pruébalo

MarsDawn está en el Mac App Store. También existe la herramienta de línea de comandos gratuita marsdawn:

brew install redtear1115/tap/marsdawn

Exporta Markdown a PDF sin la app.

Línea de comandos · Antes de comprar, conviene saber: Lo que MarsDawn no hace

Para seguir leyendo

Fuentes