Cómo mantener a tu agente de codificación de IA en el buen camino: explorar, planificar y luego construir

Cuando la gente usa por primera vez una herramienta de codificación con agentes como Claude Code o Cursor, tiende a escribir una petición de una línea y a cruzar los dedos. A veces funciona. A menudo el agente construye con total seguridad lo incorrecto — resolviendo un problema que no preguntaste, tocando archivos que no esperabas, o saltándose el caso límite que en realidad importaba.

La solución no es un modelo más listo. Es un flujo de trabajo: explorar primero, luego planificar, luego construir. Este es el patrón que Anthropic recomienda en su guía oficial de buenas prácticas de Claude Code, y la misma idea aplica a cualquier agente que pueda leer tu repositorio antes de editarlo.

Por qué saltar directamente al código falla

Un agente de IA trabaja dentro de una ventana de contexto limitada — el registro en curso de tu conversación más cada archivo que lee y cada comando que ejecuta. Dos cosas salen mal cuando te saltas la planificación:

1. El agente adivina la intención. No puede leerte la mente, así que un prompt vago obtiene una implementación plausible pero equivocada.
2. Los errores se acumulan en silencio. Una vez que el agente empieza a editar, una suposición errónea en el primer paso queda enterrada bajo otros diez cambios antes de que te des cuenta.

Separar el pensar del hacer atrapa la suposición equivocada mientras todavía es barata de corregir — una frase de corrección en lugar de revertir 12 archivos.

Paso 1: Explora en modo de solo lectura

La mayoría de los agentes serios tienen ahora un modo en el que pueden leer y analizar pero no pueden cambiar nada. En Claude Code se llama plan mode: un estado de solo lectura en el que el agente lee archivos y responde preguntas sin editar, ejecutar comandos que cambien el estado ni confirmar commits.

Empieza pidiéndole al agente que entienda el código, no que lo cambie:

Read /src/auth and explain how we handle sessions and login.
Also look at how we manage environment variables for secrets.

Estás construyendo un contexto compartido y verificando que el agente realmente entiende tu base de código antes de confiarle su modificación.

Paso 2: Pide un plan y luego cuestiónalo

Una vez que el agente ha explorado, pídele un plan concreto antes de escribir código:

I want to add Google OAuth login. What files need to change?
What's the session flow? Write a step-by-step plan — don't write code yet.

El agente devuelve un plan numerado: qué archivos tocará, el nuevo flujo de sesión, dónde almacenará los tokens. Ahora no aceptes el primer borrador. Este es el momento más barato para corregir el rumbo. Presiona sobre las lagunas:

• "¿Qué pasa si el callback de OAuth falla a mitad de camino?"
• "Ya tenemos un helper refreshToken en src/auth/tokens.ts — reutilízalo en lugar de escribir uno nuevo."
• "Limítate solo al flujo de login. No toques el código existente de restablecimiento de contraseña."

Unos minutos refinando el plan aquí te ahorran una hora desenredando una implementación equivocada más tarde.

Paso 3: Construye con una forma de verificar

Solo ahora dejas que el agente escriba código — y le das una forma de comprobar su propio trabajo. La adición más potente a cualquier prompt es un paso de verificación que el agente pueda ejecutar él mismo:

Implement the OAuth flow from your plan. Write a test for the callback
handler covering the failure case, run the test suite, and fix any failures.

Sin una comprobación que pueda ejecutar — pruebas, una compilación, una captura de pantalla para comparar — "parece terminado" es la única señal que tiene el agente, y tú te conviertes en el detector de errores de cada equivocación. Con una comprobación, el bucle se cierra solo: el agente escribe, ejecuta la prueba, lee el resultado e itera hasta que pasa. Pídele que muestre la salida real de la prueba en lugar de limitarse a afirmar el éxito.

Paso 4: Saber cuándo saltarse el plan

La planificación tiene un coste y no siempre vale la pena. Si el cambio es pequeño y el alcance es obvio — corregir una errata, añadir una línea de log, renombrar una variable — simplemente pide al agente que lo haga directamente. Una buena regla práctica de la guía de Anthropic: si pudieras describir el diff en una sola frase, sáltate el plan. Reserva el ciclo de explorar-planificar-construir para el trabajo que abarca varios archivos, usa un enfoque del que no estás seguro o toca código que no conoces bien.

Una red de seguridad: corrige el rumbo pronto y usa puntos de control

Incluso con un buen plan, los agentes se desvían. Dos hábitos te mantienen al mando:

• Interrumpe en el momento en que se descarrila. No esperes a que el agente termine un enfoque equivocado. En Claude Code, Esc lo detiene a mitad de acción con el contexto preservado para que puedas redirigirlo.
• Usa puntos de control para experimentar con libertad. Claude Code toma una instantánea de tus archivos antes de cada cambio, así que puedes pedirle al agente que pruebe algo arriesgado y, si no funciona, retroceder (Esc Esc o /rewind) y probar otro enfoque. (Los puntos de control rastrean las propias ediciones del agente, no los procesos externos — son una comodidad, no un reemplazo de git).

Y si te encuentras corrigiendo el mismo error más de dos veces, el contexto probablemente esté contaminado con intentos fallidos. Límpialo y reinicia con un prompt más afinado que incorpore lo que acabas de aprender — una sesión limpia con un mejor prompt casi siempre supera a una larga llena de callejones sin salida.

La conclusión

Explorar, planificar, construir, verificar. Se siente más lento en la primera tarea y se amortiza en la segunda. Dejas de obtener código seguro pero equivocado, y empiezas a obtener un agente que construye lo que realmente querías decir.