Planifica antes de escribir el prompt
Tu agente de IA acaba de reescribir la mitad de tu código y ahora te toca desenredarlo. La solución no es un mejor prompt — es un hábito de cinco segundos: no dejes que el agente toque un archivo hasta que hayas leído y aprobado su plan.
El problema: los agentes se comprometen con un enfoque antes de que lo hayas visto
Pídele a un agente de programación que "agregue caché al endpoint de búsqueda" y, por defecto, empieza a leer archivos, a formar un enfoque y a editar — todo de un tirón. No te enteras de que eligió un caché en memoria en lugar de Redis, ni de que tocó tres archivos que no esperabas, hasta que el diff ya está en tu árbol de trabajo. Desenredar un diff sorpresa de 400 líneas cuesta mucho más tiempo que leer un plan de cinco líneas.
El problema de fondo es la secuencia. El plan de un agente de programación y sus ediciones normalmente van entrelazados: razona un poco, escribe un poco, razona un poco más. Cualquier corrección que tengas llega después de que el código ya existe, así que "arreglar" significa deshacer parcialmente el trabajo en lugar de guiarlo antes de que empiece.
La solución: separa la planificación de la edición
Toda herramienta agéntica de programación importante ahora admite alguna forma de modo de planificación de solo lectura — un estado en el que el agente puede investigar tu código (leer archivos, hacer grep, ejecutar comandos de shell no destructivos) pero está bloqueado mecánicamente para escribir o editar. Tiene que entregarte un plan y detenerse.
En Claude Code, en concreto, esto es el modo plan, uno de varios modos de permisos integrados:
| Modo | Qué se ejecuta sin preguntar |
|---|---|
default (Manual) | Solo lectura |
plan | Solo lectura — igual que Manual, pero orientado a producir un plan antes de aprobar cualquier edición |
acceptEdits | Lecturas, ediciones de archivos, comandos comunes del sistema de archivos |
bypassPermissions | Todo (solo en contenedores aislados) |
El modo plan no es una capacidad mágica nueva — es la misma postura de solo lectura del modo Manual, pero el agente sabe que el objetivo es converger en un plan aprobado, no hacer ediciones incrementales entre prompts. Lee el código, forma un enfoque y escribe ese enfoque en lugar de actuar sobre él.
Cómo ejecutarlo
- Entra en modo plan. Presiona
Shift+Taba mitad de sesión para alternar hacia él, antepón/plana un solo prompt, o inicia la sesión ya en él:claude --permission-mode plan. Para que cada sesión de un proyecto inicie en modo plan, configúralo en.claude/settings.json:{ "permissions": { "defaultMode": "plan" } } - Dale la tarea al agente. Lee los archivos relevantes, puede ejecutar comandos de shell de solo lectura para explorar y hace preguntas aclaratorias si algo es ambiguo — las mismas preguntas que querrías responder antes de que exista el código, no después.
- Lee el plan. Describe los pasos que piensa tomar y, en el mejor de los casos, los archivos que espera tocar. Este es el lugar más barato posible para detectar un enfoque equivocado: es texto plano, no un diff.
- Corrígelo en segundos, si hace falta. ¿Dirección equivocada? Dile al agente qué cambiar y revisa el plan — sin ediciones que deshacer. En Claude Code también puedes presionar
Ctrl+Gpara abrir el plan en tu editor de texto y editarlo a mano directamente antes de aprobarlo. - Aprueba y ejecuta. Cuando el plan se vea bien, apruébalo. Claude Code sale del modo plan y pasa a editar (aprobar las ediciones automáticamente, revisar cada una o ir paso a paso) — el agente ahora ejecuta el plan que ya autorizaste.
Ese bucle — planificar, revisar, ejecutar — es todo el hábito. Cuesta una tecla al entrar y unos segundos de lectura antes de desbloquear la escritura.
Cuándo vale la pena
- Refactorizaciones aterradoras. Cualquier cosa que toque más de un par de archivos. Ver el orden de los pasos antes de que ocurra detecta "esto va a romper el middleware de autenticación" en lugar de enterarte por una suite de pruebas que falla.
- Código heredado que no entiendes del todo. El plan del agente funciona además como una explicación forzada de lo que cree que hace el código — una verificación de sensatez barata sobre su propia comprensión antes de empezar a mutar cosas que no puedes revisar línea por línea fácilmente.
- Funciones nuevas con varias implementaciones razonables. Si hay más de una forma obvia de construir algo, quieres elegir la dirección antes de que cambien quince archivos, no después.
Para arreglar un typo de una línea, el modo plan es una sobrecarga que no necesitas — recurre a él cuando el costo de un primer intento equivocado sea mayor que el costo de un paso extra de aprobación.
Truco avanzado
Mientras el agente está planificando, pregúntale directamente: "¿qué es lo que no estoy considerando?" Un agente que planifica ya ha leído el código circundante y está listo para sacar a la luz casos límite, preocupaciones de migración o pruebas que se romperían — pero por lo general no las mencionará a menos que se lo pidas. Esta única pregunta suele revelar la restricción que olvidaste antes de que se convierta en un bug.
Para llevar
Mide dos veces, corta una — la misma regla que aplica a la carpintería aplica a soltar un agente autónomo sobre tu repo. El modo plan no hace más inteligente al agente; solo mueve tu revisión a antes de la edición en lugar de después, que es el único cambio que reduce de forma confiable el retrabajo. Una tecla (Shift+Tab) es todo el costo de entrada.
Recursos
- Claude Code — Choose a permission mode: Plan mode
- Claude Code — Common workflows: Plan before editing
- Claude Code — Ultraplan (browser-based plan review)
¿Estás construyendo una función con IA? Yeda AI diseña, audita y lanza sistemas LLM en producción.