Patrón: primero planear, después programar
Deja que la IA escriba primero un plan antes de ponerse a programar, eso evita fallos costosos.
El problema con "simplemente hazlo"
Si le dices directamente a un agente "construye esto", empieza a actuar de inmediato, y a menudo hace suposiciones silenciosas que resultan equivocadas. Te das cuenta solo cuando ya está medio construido algo mal.
El patrón
Pídele a la IA primero un plan, antes de que se escriba ningún código:
- Describe el objetivo y los requisitos
- Pídele a la IA que cree un plan paso a paso (sin código)
- Lee el plan, corrige suposiciones erróneas, responde preguntas abiertas
- Solo entonces: "Implementa el plan"
Por qué funciona mejor
Un plan es barato de leer y corregir; el código es más caro de leer y corregir. Encontrar un error en el plan ("olvidaste que ya tenemos un middleware de auth") cuesta un minuto. Encontrar el mismo error en el código terminado cuesta mucho más tiempo.
Cuándo es especialmente importante
- En tareas de varios pasos o poco claras
- Cuando hay varios archivos o sistemas implicados
- Cuando los errores saldrían caros (código en producción, migraciones de bases de datos)
Para cambios pequeños e inequívocos ("cambia este color"), un paso de planificación explícito suele ser excesivo.
Así se ve
Tú: Antes de escribir código: dame un plan para añadir rate limiting a la API.
Agente: Plan:
1. Añadir un middleware de rate limiting en app.js con un contador de ventana deslizante
2. Aplicarlo a todas las rutas /api, devolver 429 si se supera el límite
3. Añadir configuración de límites por ruta en config.js
Tú: Se ve bien. Haz solo el paso 1 por ahora, lo reviso antes de seguir.
Agente: Empiezo con el paso 1 — el middleware en app.js.
EJEMPLO
Prompt: 'Primero crea un plan (sin cambios de código) para una función de login con email y contraseña. Confirmo el plan antes de que empieces.'
🛠️ EJERCICIO — PRUÉBALO TÚ
Toma una funcionalidad pequeña y real de tu proyecto (o: «Crea una función que convierta filas CSV a JSON») y haz que la IA primero planifique y después construya.
- Escribe: «Primero crea un plan de 3 a 5 pasos. Todavía sin código.»
- Lee el plan con ojo crítico. Elimina un paso demasiado grande o hazlo más preciso.
- Solo entonces: «Implementa el paso 1.» — y avanza por el plan paso a paso.
✅ AUTOEVALUACIÓN
- ☐ ¿La IA de verdad NO escribió código en el primer paso? (Si lo hizo: afina tu prompt)
- ☐ ¿Al menos un paso del plan necesitó corrección? (Casi siempre — para eso existe el plan)
- ☐ ¿El resultado surgió en piezas más pequeñas y comprobables que de costumbre?
QUIZ RÁPIDO
¿Por qué vale la pena un paso de planificación antes de programar?
FUENTES
- Anthropic: Claude Code Best Practices ↗ www.anthropic.com
- Documentación de Anthropic: Flujos de trabajo de Claude Code ↗ docs.anthropic.com
- Documentación de Anthropic: Resumen de prompt engineering ↗ docs.anthropic.com