Chargeur de Contexte Agent
Présentation
Découverte et chargement automatiques des fichiers AGENTS.md dans toute la hiérarchie du projet pour les agents d'IA de codage. Cette compétence scanne l'espace de travail actuel et ses répertoires parents pour localiser les fichiers d'instructions d'agent, puis affiche leur contenu afin que la session active de l'agent dispose du contexte opérationnel complet.
Prérequis
- Un espace de travail de projet contenant un ou plusieurs fichiers
AGENTS.mdà n'importe quelle profondeur de répertoire - Permissions de lecture et Glob pour parcourir l'arborescence des répertoires
- Accès à Grep pour rechercher le contenu des fichiers lorsque plusieurs candidats existent
Instructions
- Scannez le répertoire de travail actuel et tous les répertoires ancêtres (jusqu'à la racine du système de fichiers ou la racine du dépôt) pour trouver les fichiers nommés
AGENTS.mdouagents.md. - Recherchez dans les sous-répertoires de l'espace de travail actuel des fichiers
AGENTS.mdsupplémentaires pouvant s'appliquer aux sous-projets ou modules. - Déterminez l'ordre de chargement : les fichiers les plus proches de la racine du dépôt sont chargés en premier (contexte global), les fichiers dans les répertoires plus profonds sont chargés plus tard (remplacement ou complément).
- Lisez chaque fichier
AGENTS.mddécouvert et extrayez ses blocs d'instructions, définitions de flux de travail et déclarations de contraintes. - Fusionnez les instructions en un contexte unifié, en notant les éventuels conflits entre les niveaux (par exemple, un agent de sous-répertoire remplaçant une règle de niveau racine).
- Présentez le contexte chargé sous forme de résumé structuré : chemin du fichier source, nombre d'instructions et tout conflit détecté.
- Mettez en cache les résultats de la découverte pour la session en cours afin d'éviter des analyses redondantes du système de fichiers lors des activations suivantes.
Sortie
- Liste ordonnée des chemins des fichiers
AGENTS.mddécouverts avec leur profondeur de répertoire - Ensemble d'instructions fusionné combinant tous les contextes d'agent découverts
- Rapport de conflit mettant en évidence toute directive contradictoire entre les niveaux
- Statut du cache de session indiquant si les résultats sont nouveaux ou réutilisés
Gestion des Erreurs
| Erreur | Cause | Solution |
|---|---|---|
Aucun fichier AGENTS.md trouvé | L'espace de travail ne contient pas de fichiers d'instructions d'agent | Confirmez le répertoire de travail correct ; créez un fichier AGENTS.md à la racine du projet si nécessaire |
| Permission refusée lors du parcours de répertoire | Répertoires parents restreints au-dessus de l'espace de travail | Limitez la profondeur d'analyse à la racine du dépôt (détectée par la présence de .git/) |
| Lien symbolique circulaire détecté | Des répertoires liés symboliquement créent une boucle de parcours infinie | Ignorez les répertoires liés symboliquement lors de l'analyse ; enregistrez un avertissement avec le chemin du lien symbolique |
| Instructions conflictuelles entre niveaux | Un fichier AGENTS.md de sous-répertoire contredit le fichier de niveau racine | Signalez le conflit dans la sortie ; appliquez par défaut l'instruction la plus spécifique (plus profonde) |
| Erreur d'encodage de fichier | Le fichier AGENTS.md utilise un encodage non UTF-8 | Essayez le repli en latin-1 ; signalez le chemin du fichier et le problème d'encodage |
Exemples
Exemple 1 : Monorepo avec instructions d'agent par package
- Structure : Le fichier
AGENTS.mdracine définit les conventions globales ;packages/api/AGENTS.mdajoute des règles d'outillage spécifiques à l'API. - Résultat : Les deux fichiers sont chargés dans l'ordre. Les règles spécifiques à l'API complètent le contexte global sans conflit.
Exemple 2 : Espace de travail imbriqué avec politiques de commit conflictuelles
- Structure : Le fichier
AGENTS.mdracine indique "toujours signer les commits" ;services/legacy/AGENTS.mdindique "ignorer la signature des commits". - Résultat : Conflit détecté et signalé. La directive la plus profonde (legacy) est appliquée avec un avertissement notant le remplacement.
Exemple 3 : Première configuration sans fichiers d'agent
- Structure : Un dépôt fraîchement cloné sans fichier
AGENTS.mdnulle part. - Résultat : L'analyse se termine sans trouver de fichiers. La sortie inclut une suggestion de créer un fichier
AGENTS.mdà la racine du dépôt avec un modèle minimal.
Ressources
- Spécification AGENTS.md de Claude Code : https://docs.anthropic.com/en/docs/agents
- Modèles d'espace de travail Monorepo pour la configuration d'agent : https://docs.anthropic.com/en/docs/claude-code
- Bonnes pratiques de découverte de fichiers pour le chargement hiérarchique de configuration