Réduction du contexte (@file, @folder, @codebase)
Mécanisme de gestion précise du contexte dans les éditeurs IA modernes (Cursor, Windsurf). Permet d'attacher rapidement à la requête des fichiers spécifiques (@file), des dossiers entiers (@folder), de la documentation (@docs) ou l'ensemble du projet (@codebase) via le symbole @.
1. Vue d'ensemble du concept et de son utilité
Lorsque vous travaillez sur un projet volumineux comptant une centaine de fichiers et que vous écrivez dans le chat : « Répare le bouton d'authentification », le modèle se retrouve souvent perdu. Dans lequel des dix fichiers ce bouton est-il situé ? Quel style utilise-t-il ? Où les mots de passe sont-ils stockés ?
Les mentions de contexte (symbole @) constituent l'outil chirurgical indispensable au vibe coding. Tout comme vous mentionnez des amis dans Telegram ou Instagram via le signe @, dans les éditeurs Cursor et Windsurf, vous pouvez taguer directement les ressources de votre projet.
En appuyant sur @, vous ouvrez une liste de suggestions et indiquez clairement au modèle : « Regarde @Header.tsx et utilise les couleurs définies dans @theme.ts ».
Analogie pratique : c'est la compétence clé qui prévient les hallucinations et réduit le temps de réponse par trois.
2. Liste complète des mentions et leur fonction
┌─────────────────────────────────────────────────────────────┐
│ MENUS DE RÉFÉRENCES DANS LES ÉDITEURS DE CODE │
├─────────────────────────────────────────────────────────────┤
│ 📄 @Files: │
│ Attache un fichier précis : par exemple `@Button.tsx` │
│ (Meilleure précision, minimum de tokens superflus) │
├─────────────────────────────────────────────────────────────┤
│ 📁 @Folders: │
│ Attache tout un dossier : par exemple `@src/components` │
│ (Lorsqu'il est nécessaire d'examiner tous les composants│
│ adjacents ensemble) │
├─────────────────────────────────────────────────────────────┤
│ 🌐 @Codebase: │
│ Analyse l'ensemble du projet via une recherche vectorielle│
│ (Idéal pour des questions telles que : « Où le traitement│
│ API est-il géré dans le projet ? ») │
├─────────────────────────────────────────────────────────────┤
│ 📚 @Docs: │
│ Connecte la documentation officielle récente des │
│ frameworks │
├─────────────────────────────────────────────────────────────┤
│ 💻 @Terminal: │
│ Transmet au chat le texte de la dernière erreur │
│ affichée dans la console │
└─────────────────────────────────────────────────────────────┘
3. Comment utiliser correctement les mentions (Exemples)
01. Correction d'un composant spécifique
Évitez les formulations vagues. Privilégiez plutôt :
« Examine
@LoginForm.tsx. Fais en sorte qu'une alerte rouge s'affiche sous le champ de saisie lorsque le mot de passe est incorrect. »
02. Création de nouveau code basé sur un modèle existant
Si vous souhaitez créer une nouvelle page suivant le même style qu'une page existante :
« Crée une nouvelle page
@src/app/about/page.tsxen respectant exactement la structure et les styles utilisés dans@src/app/contact/page.tsx. »
03. Analyse d'une erreur issue du terminal
Si un texte rouge indiquant une erreur apparaît dans la console, écrivez dans le chat :
« Voici l'erreur provenant de
@Terminal. Explique dans quel fichier le dysfonctionnement a eu lieu et comment le corriger. »
4. Pourquoi un contexte ciblé est supérieur à @codebase complet
Plus vous transmettez de fichiers superflus au modèle, plus son attention reste pure. Si la tâche concerne un seul bouton, la référence explicite à @Button.tsx produira un résultat dix fois meilleur qu'une recherche effectuée sur l'intégralité du dépôt de code.
FAQ: Réduction du contexte (@file, @folder, @codebase)
Termes associés
Curation du contexte et hygiène des règles
Pratique d'ingénierie consistant à concevoir, auditer régulièrement et nettoyer les fichiers de configuration du comportement de l'agent (.cursorrules, .clinerules, AGENTS.md) pour prévenir la dégradation de l'attention du modèle.
Cursor Composer (Édition agentique multi-fichiers)
Mode d'édition agentique phare de l'éditeur de code Cursor (Ctrl+I / Cmd+I). Permet à l'intelligence artificielle de créer, modifier et relier simultanément des dizaines de fichiers du projet, d'exécuter des commandes dans le terminal et de vérifier les erreurs.
Taille de la fenêtre contextuelle (Mémoire de la conversation en cours)
Volume maximal de texte (en jetons) qu'un modèle linguistique peut conserver simultanément en mémoire lors d'une conversation en cours. Détermine la longueur des documents pouvant être téléchargés en une seule fois sans perte de contenu.