Sur mon-premier-site, avec un seul petit fichier, vous n'avez sans doute rien remarqué. Mais sur un projet plus grand, ouvrir un dossier dans Cursor déclenche une opération en arrière-plan qui mérite d'être comprise avant d'aller plus loin : l'indexation.

Pourquoi Cursor analyse un projet ouvert

Quand vous ouvrez un dossier, Cursor peut construire une représentation de son contenu, pensée pour que la recherche et l'Agent retrouvent plus facilement les parties pertinentes d'un projet, même volumineux. Sans cette étape, une IA qui devrait relire l'intégralité de tous les fichiers à chaque question deviendrait très vite lente et peu pratique, dès qu'un projet dépasse quelques fichiers.

Cette opération se déroule en arrière-plan, généralement signalée par un indicateur discret quelque part dans l'interface, souvent près du nom du projet ou dans un panneau de réglages dédié, nommé « Indexing & Docs » selon les versions. Vous n'avez rien à déclencher manuellement : elle démarre automatiquement à l'ouverture du dossier.

Combien de temps ça prend

La durée dépend directement de la taille du projet ouvert : de quelques secondes pour un petit dossier comme mon-premier-site, à plusieurs minutes pour un projet volumineux avec de nombreux fichiers. Ce n'est pas un signe de dysfonctionnement si la barre de progression met du temps à se terminer sur un gros projet : c'est simplement proportionnel à ce qu'il y a à analyser.

Que faire pendant ce temps

Rien ne vous empêche de commencer à travailler avant la fin de l'indexation, mais évitez d'ouvrir directement avec une très grande demande qui porterait sur l'ensemble du projet. Sur un projet en cours d'indexation, commencez plutôt par une question localisée sur un seul fichier déjà ouvert, comme vous le ferez au guide 6 de ce parcours : ce type de demande dépend beaucoup moins d'un contexte global déjà complètement construit.

L'indexation aide, elle ne garantit rien

Une meilleure indexation permet à l'Agent de retrouver plus facilement les fichiers pertinents pour répondre à une question large sur le projet. Elle n'est en revanche pas une garantie d'exactitude : une réponse peut rester incomplète ou incorrecte malgré une indexation terminée, exactement pour les mêmes raisons évoquées au premier guide de ce parcours.

Pourquoi mon-premier-site ne pose aucun souci ici

Avec un unique fichier, comme c'est le cas pour votre projet de pratique à ce stade du parcours, l'indexation est quasiment instantanée. C'est précisément l'intérêt d'un projet volontairement minuscule pour apprendre : vous pouvez vous concentrer sur l'Agent lui-même, sans jamais être ralenti par cette étape.

Vérifiez que vous avez compris

Vous venez d'ouvrir un très gros projet, avec des milliers de fichiers, et l'indicateur d'indexation affiche encore une progression en cours. Une question posée à l'Agent sur ce projet peut-elle échouer si vous ne patientez pas la fin complète de l'indexation ?

Elle ne va pas nécessairement échouer, mais sa pertinence peut être réduite tant que l'indexation n'est pas terminée : l'Agent dispose d'une vue potentiellement encore incomplète du projet. Pour une question localisée sur un seul fichier déjà ouvert, ce n'est généralement pas un problème ; pour une question large sur l'ensemble du projet, mieux vaut attendre la fin de l'indexation avant de la poser.

Chapitre terminé