PTENES
MÓDULO 0.5

📋 Modo de planificación: revisar antes de ejecutar

El agente muestra lo que va a hacer antes de hacerlo. Apruebas, corriges o cancelas, sin sobresaltos ni sorpresas.

6
Temas
25
Minutos
Principiante
Nivel
Teoría
Tipo
0 de 60%
1

📝 Qué es el modo de planificación

¿Eres nuevo aquí? Modo de planificación es una forma de pedirle al agente: «antes de hacer cualquier cosa, muéstrame lo que piensas hacer». Escribe los pasos, tú los lees y, solo después de que los apruebes, los ejecuta de verdad. Es la medida de seguridad más sencilla del curso.

Piénsalo así: es la diferencia entre un albañil que llega y rompe la pared de inmediato, y uno que primero te muestra el plano, te explica qué va a derribar y qué va a construir, y solo toma el mazo después de que le digas «adelante». En el día a día con un agente de código, esa pausa cuesta pocos segundos y evita el peor sobresalto: descubrir después que borró, sobrescribió o publicó algo que no pediste. Cuanto más nueva sea la relación de confianza con el agente, más conviene mantener este hábito — con el tiempo, aprendes en qué tareas puedes relajarte.

💡 Concepto principal

  • •Plan ≠ ejecución. Nada cambia en tu computadora hasta que lo apruebes.
  • •Puedes aprobar, editar o cancelar el plan.
  • •El plan siempre es texto — ningún archivo (el nombre que se le da a cualquier documento guardado en la computadora, ya sea texto, imagen u hoja de cálculo) se crea, se elimina o se modifica mientras solo se está leyendo.

🔍 Ver por dentro

Mientras el modo de planificación está activo, el agente solo está «pensando en voz alta»: el texto del plan queda en la conversación, en la pantalla, y no se guarda nada en el disco de tu computadora ni se envía a internet, aparte de lo habitual en la conversación. Usar el modo de planificación no tiene un costo extra: solo estás pidiendo ver el plan antes de autorizarlo. Es el mismo agente, la misma sesión, pero con el freno de mano puesto hasta que lo sueltes.

2

🔄 El ciclo completo: pedir, revisar, aprobar

Mira el ciclo de principio a fin — es la misma secuencia para todas las tareas hechas en modo plan.

1. Tú pides 2. El agente escribe el plan 3. Tú revisas 4a. Aprueba → ejecuta 4b. Corrige →vuelve al paso 2

Leyenda: el ciclo puede cerrarse con la aprobación (se ejecuta de verdad) o volver para crear un nuevo plan corregido: nunca se ejecuta sin pasar por tu revisión.

Observa que el paso 2 es el único en el que el agente "trabaja" antes de tu aprobación — y aun así, ese trabajo es solo de lectura y razonamiento: puede abrir archivos existentes para entender el proyecto, pero todavía no guarda nada nuevo. Solo en el paso 4a, después de que des luz verde, se ejecutan realmente los comandos (las instrucciones que el agente envía a la computadora para ejecutar, como crear un archivo o instalar un programa). Si corriges el plan en el paso 4b, el agente vuelve a escribir la propuesta desde cero teniendo en cuenta tu ajuste — no intenta "parchar" el plan anterior a escondidas; el nuevo plan aparece completo otra vez para que lo revises.

💡 Consejo práctico

Si el plan parece bueno, pero está incompleto, no hace falta rechazarlo todo: di exactamente qué falta («incluye también una prueba») y el agente ajustará ese punto sin descartar el resto del razonamiento.

🛠️ Error común

Cerrar la ventana de la terminal (el programa de texto donde conversas con el agente mediante comandos) pensando que eso «cancela» el plan de forma segura. En realidad, es mejor responder explícitamente «no» o pedir un ajuste: cerrarla a mitad del proceso puede dejar la sesión en un estado incierto la próxima vez que la abras.

3

⏰ Cuándo usarlo (y cuándo no hace falta)

Usar siempre frena el ritmo en tareas pequeñas; nunca usarlo es arriesgado en tareas grandes. El equilibrio depende del riesgo y de la reversibilidad de la tarea: cuanto más difícil sea deshacer lo que hará el agente, más conviene detenerse a revisar el plan antes.

✓ Usa el modo plan

  • ✓Tareas que modifican muchos archivos
  • ✓Cualquier cosa que borre o publique
  • ✓Instalar un programa nuevo o cambiar la configuración del sistema
  • ✓La primera vez que pides un tipo de tarea nuevo

— Opcional

  • •Tareas pequeñas y fáciles de deshacer
  • •Preguntas que no cambian nada ("explícame esto")
  • •Una tarea que ya has pedido varias veces y cuyo resultado conoces

Cómo aumenta el riesgo según el tamaño de la tarea

1

Leer o explicar algo

No cambia nada en la computadora: el modo de planificación es prescindible.

2

Crear un archivo nuevo aislado

Fácil de borrar si algo sale mal — el modo plano ayuda, pero no es crítico.

3

Modificar varios archivos existentes

Difícil de revertir manualmente — usa el modo de plan.

4

Borrar, sobrescribir o publicar algo en Internet

Puede ser irreversible: el modo plan es obligatorio, sin excepción.

4

✏️ Editar el plan antes de aprobarlo

Puedes pedir un ajuste al plan («hazlo sin el paso 3», «usa otro nombre de carpeta" — carpeta es el espacio donde se organizan los archivos, como un cajón dentro de la computadora) antes de aprobar — corregir el plan es mucho más barato que deshacer una ejecución ya realizada.

Editar no es solo eliminar pasos: también puedes pedir más detalles («¿qué archivo exactamente vas a cambiar?»), cambiar el orden («haz la copia de seguridad primero») o pedir una alternativa más segura («en vez de sobrescribir, crea una copia nueva»). El agente reescribe el plan teniendo en cuenta tu pedido y muestra la versión actualizada; tú sigues teniendo el control hasta que digas «adelante».

💡 Consejo práctico

Lee el plan de principio a fin antes de decidir. Si un paso te parece extraño, pregunta antes de aprobarlo, no después.

🛠️ Error común

Aprobar demasiado rápido solo para «no frenar el trabajo». Aprobar en 2 segundos sin leer anula toda la protección del modo de plan: si no vas a leer el plan, da igual que lo hayas pedido o no.

5

🎯 Señales de que el plan necesita ajustes

Algunas señales indican que conviene pedir una revisión antes de aprobar. Con la práctica, este criterio se vuelve rápido — al principio, es mejor pecar de precavido.

✓ Buen plan

  • ✓Pasos específicos, con nombre de archivo/carpeta
  • ✓Solo se ocupa de lo que pediste
  • ✓Explica el «porqué» de cada paso, no solo el «qué»

✗ Plan para revisar

  • ✗Pasos vagos ("ajustar los archivos necesarios")
  • ✗Menciona borrar o sobrescribir algo que no pediste
  • ✗Modifica una carpeta o un proyecto diferente del que mencionaste
Leí el plan específico y restringido Aprobar → ejecutar vago o fuera de lo solicitado Pedir un ajuste vuelve al paso 2 del ciclo

Leyenda: la misma pregunta simple decide el camino: ¿el plan describe exactamente lo que pedí, ni más ni menos?

6

🏋️ Practicar: pide algo pequeño en modo plan

¿Eres nuevo aquí? Comando es la frase corta que escribes en el terminal — la ventana de texto donde conversas por escrito con el agente, sin menús ni botones, para pedir algo específico. Nada ayuda más que un ejemplo real. Pide una tarea pequeña en modo plan y observa el plan generado.

# En la sesión de Claude Code, activa el modo de plan y escribe:
Crea un archivo notas.txt con 3 ideas de automatización para mi día a día.

Objetivo: ver un plan real antes de aprobar algo por primera vez. Cómo verificar: el agente debe mostrar «voy a crear el archivo notas.txt con...» antes de que ocurra cualquier cosa; solo lo ejecuta después de que des tu OK.

🛠️ Errores comunes en este ejercicio

  • •No encuentres dónde se activa el modo de planificación: por lo general es una tecla de acceso rápido o un comando específico de la herramienta; si no sabes cuál, pregúntale directamente al propio agente: «¿cómo activo el modo de planificación aquí?».
  • •Ver "Permission denied" (permiso denegado) y pensar que se bloqueó para siempre — normalmente solo es el sistema pidiendo una confirmación adicional antes de permitir que el agente escriba en el disco; lee el mensaje completo antes de entrar en pánico.
  • •Cerrar la ventana pensando que «cancelaste»: la forma correcta de cancelar es responder «no» o «cancela» dentro de la propia conversación.

🔍 Por dentro

Repite este ejercicio dos o tres veces más con solicitudes diferentes antes de seguir al módulo 0.6 — familiarizarte con el ciclo es lo que transforma una "regla memorizada" en un hábito automático. Prueba también con una solicitud un poco arriesgada (por ejemplo, "borra el archivo notas.txt") solo para ver cómo el plan se vuelve más explícito cuando la acción es más seria.

✅ Resumen del módulo

Si te llevas una sola cosa de este módulo, que sea esta: el modo de planificación no es burocracia, es el botón de pausa que separa «el agente pensó en esto» de «el agente hizo esto». En los próximos módulos de la ruta verás permisos y reglas de seguridad más específicas, pero el hábito de leer antes de aprobar sigue siendo la base de todo, en cualquier herramienta y con cualquier nivel de experiencia.

✓
Modo de planificación: el agente muestra lo que va a hacer antes de hacerlo; tú apruebas, corriges o cancelas.
✓
Ciclo: pedir → plan → revisión → aprobación → ejecución.
✓
Cuándo usar: siempre en tareas grandes o irreversibles; opcional en las pequeñas.
✓
Señal de alerta: un plan vago o que va más allá de lo pedido merece revisión.

Próximo módulo:

0.6 — Permisos y seguridad: qué nunca debes dejar que haga el agente