MarsDawn

La división read-only/write action de Chip Huyen, y por qué importa antes de aprobar nada

El ensayo «Agents» de Chip Huyen de enero de 2025 parte de la definición de manual y llega a algo más concreto: las acciones de un agente se parten en las que solo miran el mundo y las que lo cambian. Esa división es una buena forma de decidir, en los cinco minutos que tienes, qué líneas de un plan merecen una mirada más atenta antes de decir que sí.

Lo que sostiene el texto

Huyen abre con sencillez:

“An agent is anything that can perceive its environment and act upon that environment.”

Desde ahí construye lo que necesita un agente: un entorno en el que actuar y un conjunto de herramientas — su «tool inventory» — que determina qué puede hacer. Nombra la distinción entre acciones que solo dejan al agente percibir su entorno («read-only actions») y acciones que le permiten actuar sobre ese entorno («write actions»). Sobre el riesgo del segundo tipo es directa: «Write actions enable a system to do more», pero «the prospect of giving AI the ability to automatically alter our lives is frightening» — en sus palabras, «you shouldn’t allow an unreliable AI to initiate bank transfers.» Igual de clara sobre la parte de un agente más difícil de acertar:

“If you’ve ever been in any planning meeting, you know that planning is hard.”

Huyen no menciona MarsDawn en ningún sitio de este ensayo y no recomienda ninguna herramienta Markdown. /reviewing-agent-plans/ ya cita tres de sus frases del mismo ensayo: el coste de saltarse la supervisión antes de que corra un plan, el agente que cree haber terminado cuando no lo ha hecho, y, en el paso 3 de su checklist, su línea de que un sistema ante una operación arriesgada «can ask for explicit human approval before executing». Esta nota no repite esas citas; si no has leído esa página, está enlazada abajo.

Nuestra lectura, no la de Huyen

La división read-only/write de Huyen no está escrita como consejo de revisión — es una forma de clasificar lo que hace una herramienta. Pero es una prueba sencilla y de propósito general para detectar exactamente el tipo de línea de operación arriesgada ante la que el paso 3 de esa checklist ya te pide frenar: leer un archivo, lanzar una búsqueda, listar un directorio son solo lectura, y un paso read-only que falla te cuesta un nuevo intento; borrar datos, forzar un push, fusionar una rama, enviar un correo, cargar una tarjeta son write actions, y — como ella dice — un paso write que falla es el tipo aterrador, y para cuando lees el informe del agente puede haber ocurrido ya. Su punto de que planificar es difícil incluso para personas en una sala es un buen freno a esperar de un plan más precisión de la que el formato puede cargar: un plan que se lee con seguridad no es lo mismo que un plan correcto.

Dónde ayuda MarsDawn y dónde no

MarsDawn no puede distinguir un paso read-only de uno write en un plan — es un juicio que el texto no etiqueta, y nada en la app lee por significado. No tiene ningún modelo de IA dentro: no marcará la línea arriesgada por ti, no hará la comprobación de «planificar es difícil» ni calificará el plan. Lo que hace es mantener el archivo legible mientras tú haces ese juicio: la pestaña Esquema (Visualización ▸ Mostrar barra lateral, ⌃⌘S) te deja recorrer la forma de un plan antes de leerlo línea a línea, el código y la página renderizada lado a lado (⌘2) para que un diagrama de los pasos no se quede atascado como Mermaid en bruto, y Edición ▸ Copiar referencia (⌥⌘C) convierte tu sitio en plan.md:10, listo para pegar como feedback en cuanto veas una write action en el orden equivocado.

Probarlo

MarsDawn está en el Mac App Store. La herramienta de línea de comandos gratuita marsdawn ya funciona hoy:

brew install redtear1115/tap/marsdawn

Exporta Markdown a PDF sin la app.

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

Siguiente

Fuentes