Cursor en un proyecto grande: cómo no perder el control

Para usar Cursor o Claude Code en un proyecto grande sin perder el control, dale al agente un mapa escrito del proyecto, haz que planifique antes de editar, limita cada tarea a una zona concreta y mantén cada cambio lo bastante pequeño como para revisarlo y probarlo antes de pasar al siguiente. El agente solo puede leer una parte de un proyecto grande a la vez, así que la mayoría de los errores vienen de lo que supone sobre las partes que no vio.

Aquí te explicamos por qué los agentes se desvían en proyectos grandes y qué hacer en cada etapa: preparar el proyecto, acotar una tarea, dejar fuera los archivos que estorban, revisar los cambios y saber cuándo empezar una sesión desde cero.

¿Por qué los agentes de IA pierden el control en un proyecto grande?

Un agente trabaja dentro de una ventana de contexto: las instrucciones, archivos y conversación que puede tener presentes al mismo tiempo. En una app pequeña puede leer casi todo. En un proyecto con cientos de archivos busca, lee una muestra y completa el resto con suposiciones. De ahí salen problemas conocidos:

• Escribe una función nueva porque nunca encontró la que ya existía.
• Cambia una función compartida pensando en una pantalla y rompe otras tres que ni abrió.
• Copia el patrón de un módulo viejo que tú querías jubilar.
• En una conversación larga, los detalles del principio se resumen o se pierden, y repite errores que ya le corregiste.

Nada de esto significa que la herramienta no sirva para proyectos grandes. Significa que el agente necesita el contexto que necesitaría una persona nueva en el equipo, y los límites que le pondrías a esa persona.

¿Cómo le doy al agente un mapa del proyecto?

Escribe un archivo de instrucciones corto en la raíz, que se cargue al empezar cada sesión: CLAUDE.md en Claude Code, .cursor/rules o AGENTS.md en Cursor. Incluye:

• Qué hace el producto, en dos frases.
• Un mapa de carpetas: dónde están el frontend, la API, las migraciones, los tipos compartidos y las pruebas.
• Cómo se ejecuta, se prueba y se compila.
• Qué módulos son heredados y no deben copiarse.
• Las pocas reglas que, si se rompen, causan daño real.

Que sea liviano. La documentación de memoria de Claude Code sugiere apuntar a menos de 200 líneas por CLAUDE.md y mover lo que solo aplica a una parte del código a reglas por ruta en .claude/rules/, que se cargan solo cuando Claude trabaja con esos archivos. En Cursor logras lo mismo con reglas que se aplican a ciertos patrones de archivos, y ambas herramientas aceptan otros AGENTS.md en subcarpetas para notas de cada zona. En Claude Code, /init genera un primer archivo que luego puedes recortar.

Para escribir reglas que el agente sí respete tenemos una guía aparte.

¿Cómo acoto una tarea?

Lo que más cambia el resultado es pedir menos cada vez, y pedir un plan primero.

Empieza en modo plan

Las dos herramientas tienen un modo que investiga y propone sin tocar tus archivos. En Cursor, Plan Mode hace preguntas, lee el código y arma un plan que puedes editar antes de que empiece a construir; se activa con Shift+Tab desde el campo del chat. En Claude Code, el modo plan (Shift+Tab, o /plan antes del mensaje) lee archivos y escribe un plan, y no edita nada hasta que lo apruebas. Lee el plan. Si menciona archivos que no esperabas, pregunta por qué antes de aprobarlo.

Señala el lugar exacto

Nombra los archivos o carpetas con menciones @ en lugar de dejar que el agente busque. Compara:

• Vago: "Agrega exportar a CSV en los reportes."
• Acotado: "Agrega un botón para exportar a CSV en @src/pages/reports/MonthlyReport.tsx. Usa la función downloadFile que ya existe en @src/lib/files.ts. No cambies la consulta del reporte. Muéstrame el plan primero."

Un tema por sesión

Corregir un error, reorganizar código y crear una función nueva son tres sesiones, no una. Las peticiones mezcladas producen cambios mezclados, difíciles de revisar y más difíciles de deshacer.

¿Cómo dejo fuera los archivos que estorban?

Los repositorios grandes cargan ruido: carpetas de compilación, archivos generados, código de terceros copiado, datos de ejemplo enormes. En Cursor, ponlos en .cursorignore para que el agente, Tab y las menciones @ no los usen. La documentación de Cursor aclara que no es una barrera de seguridad: la terminal y las herramientas MCP del agente siguen pudiendo llegar a esos archivos. En Claude Code, bloquea la lectura de archivos sensibles con una regla de permisos como Read(./.env) en .claude/settings.json.

Y deja los secretos fuera del repositorio. Un archivo de exclusión es una comodidad, no una caja fuerte.

¿Cómo reviso cambios a esta escala?

Ponte un límite y detente cuando un cambio lo supere.

1. Una rama por tarea. Todo lo que hace el agente cae en una rama que puedes descartar.
2. Lee primero la lista de archivos. Si un arreglo pequeño tocó una migración, el módulo de autenticación y package.json, pregunta por qué antes de leer línea por línea.
3. Limita el tamaño. Una regla práctica: si no puedes revisarlo en quince minutos, debió ser dos tareas.
4. Corre tú las verificaciones. Chequeo de tipos, pruebas y un recorrido rápido por las pantallas afectadas. No te fíes del "todas las pruebas pasan" del resumen.
5. Haz commit de cada paso que funciona. Los commits pequeños te dicen qué paso rompió algo.

En nuestra guía sobre cómo revisar código generado por IA tienes una lista completa, y en pruebas para código generado con IA verás la red de seguridad que hace posibles los cambios grandes.

¿Cuándo conviene empezar una sesión nueva?

Empieza de cero cuando termines una tarea, cuando el agente repita un error que ya le corregiste o cuando la conversación haya saltado entre varios temas. En Claude Code, /clear empieza limpio, y /compact o las opciones de resumen de /rewind achican una sesión larga sin perder lo importante. En Cursor, abre un chat nuevo.

Antes de hacerlo, pídele al agente un resumen de cinco líneas con lo que se decidió y lo que falta, y pégalo en la sesión nueva. Conservas las decisiones y te deshaces del ruido.

¿Puedo tener varios agentes trabajando a la vez?

Sí, y ambas herramientas lo permiten, desde los subagentes y sesiones en segundo plano de Claude Code hasta los agentes en la nube de Cursor. Funciona cuando las tareas tocan partes distintas del código. Dos agentes editando los mismos archivos en paralelo generan conflictos que después tienes que resolver a mano. Usa ramas separadas o worktrees de git, y fusiona una cosa a la vez.

Respuestas rápidas

¿Qué va mejor en un proyecto grande, Cursor o Claude Code? Los dos pueden con él si sigues estas prácticas. La diferencia grande está en cómo acotas y revisas el trabajo, no en la herramienta.

¿Dejo que el agente reorganice todo el proyecto de una vez? No. Hazlo módulo por módulo, con pruebas alrededor primero, y fusiona cada paso por separado.

¿Por qué el agente sigue creando funciones duplicadas? Porque no encontró la que ya existe. Menciónala por su ruta y lista las funciones compartidas en tu archivo de instrucciones.

¿Cuánto debe durar una sesión? Lo que dure una tarea. Cuando cambies de tema, empieza de nuevo.

¿Necesitas ayuda para ordenar un proyecto grande?

Cuando meses de cambios con IA dejan un código difícil de manejar, la solución suele ser estructura: un mapa, pruebas en las partes delicadas y una limpieza de duplicados. En nuestra página de ayuda con proyectos de Cursor te contamos cómo lo encaramos, y si el problema de fondo es la deuda técnica del vibe coding, esa guía te ayuda a medirla. También puedes escribirnos con una descripción breve del proyecto.