Guide des fichiers de conventions pour agents IA
Présentation
Ce guide répertorie et explique les fichiers de conventions que les agents IA (tels que Claude Code, Cursor, Codex) lisent, écrivent et utilisent pour adapter leur comportement à un projet. Il couvre les formats suivants :
- AGENTS.md – Instructions globales pour l'agent.
- CLAUDE.md – Instructions spécifiques pour Claude Code.
- SKILL.md – Définition des compétences de l'agent.
- llms.txt – Fichier de contexte pour les grands modèles de langage.
- MCP configs – Fichiers de configuration pour le Model Context Protocol.
- Règles – Fichiers de règles pour des outils comme Cursor.
Fichiers principaux
AGENTS.md
Fichier placé à la racine du projet contenant des instructions générales pour tout agent IA. Il peut inclure :
- Les lignes directrices du projet.
- Les conventions de code.
- Les informations de configuration de l'environnement.
CLAUDE.md
Fichier spécifique à Claude Code (et parfois Cursor) qui définit :
- Les outils autorisés (lecture, écriture, exécution de commandes).
- Les permissions d'accès aux fichiers.
- Le comportement attendu de l'agent.
SKILL.md
Fichier décrivant une compétence d'agent. Il peut être utilisé pour :
- Ajouter une fonctionnalité spécialisée.
- Configurer des bibliothèques et des dépendances.
- Fournir des instructions détaillées pour une tâche spécifique.
llms.txt
Fichier de contexte standardisé pour les LLM, souvent utilisé pour :
- Fournir un résumé du projet.
- Donner des instructions générales ou des liens vers la documentation.
- Structurer les informations importantes pour l'agent.
MCP configs
Fichiers de configuration pour le Model Context Protocol (MCP), permettant :
- De connecter l'agent à des services externes.
- De définir des outils et des ressources supplémentaires.
- De personnaliser l'environnement d'exécution.
Règles (Cursor, etc.)
Fichiers de règles pour des outils comme Cursor, qui définissent :
- Les comportements à suivre ou à éviter.
- Les contraintes de style de code.
- Les préférences pour les suggestions de l'IA.
Utilisation recommandée
- Placez AGENTS.md à la racine pour définir des instructions générales.
- Utilisez CLAUDE.md pour les projets utilisant Claude Code ou Cursor.
- Créez des fichiers SKILL.md pour chaque compétence spécialisée.
- Ajoutez un fichier llms.txt pour fournir un contexte standardisé.
- Configurez les fichiers MCP selon les besoins de connexion externe.
Exemples
Exemple de AGENTS.md
# Instructions générales pour l'agent
- Lisez d'abord le fichier README.md.
- Ne modifiez pas les fichiers dans le dossier `src/legacy/` sans autorisation explicite.
- Utilisez des tests unitaires avant chaque commit.
Exemple de CLAUDE.md
# Configuration pour Claude Code
- Outils autorisés : lecture, écriture, exécution de commandes (npm, git).
- Interdit : modification des fichiers dans `node_modules/`.
- Style : suivre ESLint configuré.
Ressources supplémentaires
Licence
Ce guide est fourni à titre d'information. Les fichiers de conventions spécifiques peuvent avoir leurs propres licences.