La guía completa del Modo Plan de Cursor | Deja de hacer que la IA escriba a lo loco y empieza a diseñar tus cambios de desarrollo

Si has usado alguna vez una herramienta de desarrollo con IA durante un tiempo, seguro que te suena alguna de estas situaciones:

• Le pediste a la IA en modo Agente que «añadiera esta función» y lo que devolvió no tenía nada que ver con lo que realmente querías.
• Cada corrección que le diste empeoró las cosas, hasta el punto de que empezar de cero habría sido más rápido.
• El código generado funciona bien, pero la arquitectura interna es un lío imposible de desenredar más adelante.

Los tres problemas tienen la misma causa raíz: empezar a implementar antes de que el diseño estuviera realmente claro. El Modo Plan de Cursor se diseñó desde cero para resolver exactamente esto.

¿Qué es el Modo Plan? Usar la IA sin que escriba código

El Modo Plan es una función dedicada a la planificación de implementaciones que Cursor introdujo en octubre de 2025. En pocas palabras: es un mecanismo para fijar el diseño junto con la IA antes de que se escriba una sola línea de código.

Mientras que el modo Agente normal se lanza directamente a editar archivos, el Modo Plan sigue este proceso previo:

1. Preguntas aclaratorias: el agente consulta cualquier aspecto ambiguo de tus requisitos.
2. Investigación de la base de código: explora automáticamente los archivos relacionados y las implementaciones existentes.
3. Generación del plan: escribe un plan detallado en Markdown, completo con rutas de archivos y referencias de código.
4. Revisión y edición: un humano revisa y ajusta el plan antes de aprobar su ejecución.
5. Compilación (ejecución): una vez aprobado, al hacer clic en «Build» se pasa a la implementación real.

La clave está en el paso 4, la revisión. En lugar de que la IA implemente algo de forma unilateral, un humano comprueba y ajusta el plan antes de dar luz verde. Ese único paso adicional cambia sustancialmente la calidad del código resultante.

Cómo activar el Modo Plan

Solo tienes que pulsar Shift + Tab en la casilla de entrada del chat. También puedes seleccionar «Plan» en el menú desplegable de modos.

Además, Cursor a veces te sugerirá cambiar al Modo Plan automáticamente si detecta palabras clave que indican una tarea compleja.

Cuándo brilla realmente el Modo Plan

Según la documentación oficial, resulta especialmente eficaz en las siguientes situaciones:

Funciones complejas con más de un enfoque viable: Por ejemplo, añadir autenticación (JWT, sesiones, OAuth), ya que existen varias rutas posibles. Fijar el enfoque primero en el Modo Plan evita que la implementación se desvíe a mitad del proceso.

Tareas que abarcan muchos archivos o sistemas: Refactorizaciones grandes o una función que toca varios módulos. Visualizar el radio de impacto de antemano reduce los despistes y el trabajo repetido.

Cuando los requisitos son vagos y quieres acotar el alcance primero: Incluso una instrucción imprecisa del tipo «quiero algo como esto» se convierte en requisitos claros gracias a las preguntas aclaratorias de la IA.

Cuando quieres revisar decisiones de arquitectura antes de escribir nada: «¿En qué capa debería vivir esta lógica?», «¿Qué biblioteca deberíamos usar?»; puedes aprobar decisiones como estas antes de que exista código.

Por el contrario, para cambios pequeños o tareas rutinarias que haces todo el tiempo, no pasa nada por saltar directamente al modo Agente. El Modo Plan no sirve para todo; el truco está en recurrir a él específicamente cuando notas que la complejidad o la ambigüedad empiezan a asomar.

Guardar y reutilizar planes

Por defecto, el plan generado por el Modo Plan se crea como un archivo temporal en tu directorio principal. Haz clic en «Save to workspace» y se guardará en la carpeta .cursor/plans/ en su lugar.

Con esto consigues:

• Compartir en equipo: los compañeros pueden ver la intención de diseño detrás del trabajo.
• Documentación: un registro de por qué se eligió una determinada implementación.
• Retomar el trabajo: recuperar un plan fácilmente si te interrumpen a mitad de camino.
• Contexto para futuros agentes: un punto de partida para el siguiente agente que continúe el trabajo en la misma función.

Como el plan es simplemente un archivo Markdown, es muy fácil de editar directamente: puedes recortar un paso que no necesites o añadir contexto que la IA se haya dejado.

Plan → Agente: un ejemplo práctico del patrón que funciona

❌ El error en el que suele caer la gente

[In Agent mode]
"Add user authentication"

→ Obtienes código en el que la lógica de autenticación, la gestión de sesiones y el manejo de errores están completamente mezclados. Desenredarlo después lleva una eternidad.

✅ Usar el Modo Plan en su lugar

Paso 1: Acotar los requisitos en el Modo Plan

[Switch to Plan Mode with Shift+Tab]
"I want to add user authentication.
 Requirements: email + password login, session management,
 error handling, test coverage"

La IA responde con preguntas aclaratorias (por ejemplo: «¿Existe alguna base de autenticación previa?», «¿Dónde deben almacenarse las sesiones?»). Respóndelas y obtendrás un plan como este:

## Implementation Plan: User Authentication

### Step 1: Build the auth controller
- POST /login endpoint
- POST /logout endpoint

### Step 2: Build the auth service
- Password hash verification logic (kept separate from the controller)

### Step 3: Implement session-management middleware
- Session creation, validation, and teardown

### Step 4: Error handling
- Exception handling for failed auth and expired sessions

### Step 5: Write test coverage
- Unit tests for each endpoint

Paso 2: Revisar y ajustar el plan

Edita el plan desde tu propia perspectiva (por ejemplo: «añade un paso de validación de entradas antes del paso 4»).

Paso 3: Pulsa Build para implementar (modo Agente)

Una vez que estés satisfecho con el plan, haz clic en «Build». Con una hoja de ruta clara en la mano, el Agente implementa el código sin desviarse del rumbo.

Un consejo práctico más: en lugar de ejecutar todos los pasos de golpe, ejecuta uno o dos pasos a la vez y comprueba que todo funciona sobre la marcha. Esto permite detectar problemas antes y profundiza tu propia comprensión del código a lo largo del proceso.

Cuando algo sale mal: vuelve al plan

Si el Agente empieza a implementar algo que no coincide con tu intención, intentar reconducirlo con más instrucciones (prompts) suele ser una mala idea.

Lo correcto es:

1. Haz clic en Stop para detener lo que está haciendo.
2. Deshaz los cambios.
3. Vuelve al Modo Plan y añade condiciones más específicas.
4. Vuelve a ejecutar Build.

Esto puede parecer el camino más largo, pero de forma sistemática te lleva a un resultado más rápido y limpio que «corregir a un Agente en plena ejecución con instrucciones de seguimiento».

Cuanto mayor sea el cambio, más rentable será dedicar tiempo real a obtener un plan preciso y bien acotado. Lo difícil es determinar qué construir. Una vez que tus instrucciones son correctas, puedes confiar en el Agente para saber cómo hacerlo.

Los cuatro modos de Cursor y cuándo usar cada uno

Para sacarle más partido al Modo Plan, ayuda tener claros los cuatro modos en la cabeza.

La pregunta que debes hacerte es: «¿Esta tarea cabe en un archivo? ¿El diseño ya está claro?». Si la respuesta a cualquiera de las dos es no, empezar en el Modo Plan es la opción más segura.

Rara vez le pido al modo Agente que haga una corrección directamente desde el principio hoy en día. Predeterminar el uso del Modo Plan me obliga prácticamente a organizar mis pensamientos sobre el trabajo al mismo tiempo; así que tener la perspectiva global primero en el Modo Plan, antes de avanzar, significa tener que repetir muchas menos cosas.

Errores comunes y cómo evitarlos

Confiar demasiado en el plan

Un plan no deja de ser una hipótesis. Si te das cuenta a mitad de la implementación de que «el paso 5 en realidad tiene que ocurrir antes del paso 3», modifica el plan antes de continuar. Seguir un plan de forma rígida a costa de una implementación ineficiente arruina su propósito.

Hacer el plan demasiado detallado

Si escribes un plan hasta el nivel de «coloca esto en la línea X de este archivo», pierdes toda la flexibilidad de implementación. El nivel de detalle adecuado es aproximadamente «componente o función», dejando los detalles de ejecución en manos del Agente.

Usarlo en tareas demasiado simples que no lo necesitan

Utilizar el Modo Plan para renombrar una variable o corregir una sola línea es, en realidad, menos eficiente. También importa saber reconocer cuándo una tarea es lo suficientemente sencilla como para enviarla directamente al modo Agente.

Omitir el modo Ask y saltar directamente al Plan

Lo ideal es comprender la base de código existente a través del modo Ask primero y, a continuación, diseñar en el Modo Plan. Planificar sin entender antes lo que ya hay tiende a producir implementaciones duplicadas e incoherencias.

Últimas novedades: el Modo Plan y la elección de modelo en 2026

A fecha de febrero de 2026, el modelo que utilices para el Modo Plan se ha convertido en una decisión importante por derecho propio.

• Planificación diaria: Composer 1.5 / Auto (rápido, de bajo coste y optimizado específicamente para Cursor).
• Diseño arquitectónico complejo: Claude Opus 4.6 (clasificado en el puesto número 1 en SWE-rebench, compatible con una ventana de contexto de 1 millón de tokens).

El propio Composer 1.5 de Cursor está entrenado directamente dentro de las herramientas de Cursor —el editor de archivos, la terminal y la búsqueda—, lo que lo convierte en una opción especialmente adecuada para el trabajo diario de planificación e implementación.

Conclusión: piensa en «diseñar, luego escribir»

La idea central detrás del Modo Plan es sencilla: deja de hacer que la IA «escriba a lo loco» sobre la marcha.

• No dejes que implemente basándose en requisitos que todavía son vagos.
• No confíes ciegamente en el criterio de la IA; introduce un paso de revisión.
• Cuando algo salga mal, no corras detrás de la implementación: vuelve al plan.

Tener clara esta mentalidad cambia sustancialmente la calidad y la eficiencia de la programación asistida por IA. Si has tenido la sensación de que «el Agente se ha descontrolado» o que «tienes que estar rehaciendo las cosas continuamente», dale una oportunidad al Modo Plan.

Para activar el Modo Plan: Shift + Tab en la casilla de entrada del chat