English

Index Your Codebase First

Le hiciste a Cursor una pregunta sobre todo tu proyecto — «¿dónde debería vivir este componente?», «¿qué archivos tocan el carrito?» — y respondió como si nunca hubiera abierto tu repositorio. Seguramente no lo había abierto. Cursor indexa tu código, y hasta que ese índice existe, una indicación escrita en el contexto de todo tu proyecto no tiene a qué agarrarse.

Para qué sirve el índice

Cuando abres un proyecto, Cursor empieza a indexarlo. Ese índice es lo que le permite conectar las palabras de tu indicación con los archivos reales en disco. Sin él, el modelo igual responde: solo que responde a partir del código que pegaste, del archivo que tienes abierto y de conocimiento general de programación. No tiene un mapa de tu repositorio.

Ese es el mecanismo detrás de la falla que la gente reporta como «la IA no conoce mi proyecto». No es un problema de razonamiento, es un problema de recuperación: todavía no hay nada de dónde recuperar.

En general, los asistentes de código construyen este tipo de índice troceando tus archivos fuente y guardando una representación buscable de cada trozo, para que una frase en lenguaje natural como «el total del checkout» pueda emparejarse con código que nunca usa esas palabras exactas. La implementación concreta varía según la herramienta y cambia con el tiempo; lo que importa para tu flujo de trabajo es simplemente que el índice se construye a partir de tus archivos, que tarda en construirse y que nada que dependa de él funciona antes de que termine.

La regla

Hasta que tu código esté indexado, Cursor no puede entender tu base de código completa ni mapearla a tu indicación. Si dices algo en el contexto de todo el proyecto antes de que termine el indexado, no podrá entenderlo. Solo después del indexado puedes preguntar a esa escala y esperar una respuesta fundamentada.

Vale la pena interiorizarlo porque la falla es silenciosa. Un Cursor sin indexar no dice «todavía no tengo tu repositorio». Produce una respuesta segura, genérica y plausible: un componente ubicado en un directorio que no existe, una ruta de importación inventada por convención en lugar de leída de tu árbol de archivos. Te enteras después, en la revisión o en tiempo de ejecución.

Cómo revisarlo

1. Abre Settings.
2. Entra en Features.
3. Busca Codebase Indexing.

Ahí confirmas el estado del índice, y ahí puedes dispararlo tú mismo en lugar de esperar a notar que ocurre por su cuenta. Que sea lo primero que revises al abrir un repositorio desconocido en Cursor, y lo primero que revises cuando una respuesta vuelve sospechosamente genérica.

Qué desbloquea el índice

Una vez indexado el código, el agente puede buscar directamente en tu repositorio. Ante una tarea como «agrega estas imágenes de productos a la sección de ropa de hombre», buscará en el repositorio, encontrará dónde están las imágenes y dónde deben ir, y aplicará el cambio en el lugar correcto, en vez de pedirte que nombres cada archivo o adivinar una estructura.

Index the codebase  →  Agent searches it  →  Edits land in the right files

Rompe cualquiera de ellos y los dos siguientes no valen nada. Sin índice, no hay búsqueda. Sin búsqueda, no hay idea de qué archivo editar.

Cuándo importa más

• Preguntas de proyecto completo. «¿Dónde va esto?», «¿qué archivos lo tocan?», «¿qué patrón usamos aquí para X?»: todas son preguntas sobre el repositorio, no sobre un fragmento.
• Un código que no escribiste tú. El índice hace el trabajo de orientación que si no harías a mano con el árbol de archivos y grep.
• Cambios que abarcan varios archivos. Una tarea repartida entre varios archivos depende de que el agente los localice todos, y no puede localizar lo que no ha indexado.
• Cualquier proyecto recién abierto o recién clonado. Es el momento en que el índice todavía no existe, y también el momento en que es más probable que hagas una pregunta amplia de orientación.

Errores comunes

• No juzgues a Cursor por su primera respuesta en un proyecto nuevo. Puedes estar juzgando a una herramienta sin indexar. Revisa el índice y vuelve a preguntar.
• No asumas que terminó solo porque pasó tiempo. Mira Settings → Features → Codebase Indexing en lugar de adivinar.
• No compenses un índice faltante pegando más archivos. Eso trata el síntoma. Deja que el índice termine y obtén búsqueda en todo el repositorio en lugar de un portapapeles más grande.

Conclusión

Sin índice, no hay panorama completo. Cursor indexa tu código, y el comportamiento más valioso de la herramienta —buscar en tu repositorio, encontrar dónde vive cada cosa, aplicar los cambios en los archivos correctos— se apoya por completo en ese índice. Revisa Settings → Features → Codebase Indexing, deja que termine y luego pregunta.