AGENTS.md

Les fichiers AGENTS.md (et leurs équivalents comme les Cursor Rules) sont des documents versionnés dans le dépôt qui décrivent les conventions, les pratiques et les contraintes d'un projet à destination des agents IA. Ils servent de guide pour que l'agent respecte les choix techniques, le style de code, l'architecture et les workflows spécifiques au projet.

Les approches :

• AGENTS.md : un fichier unique à la racine du projet, lu automatiquement par les agents compatibles (Claude Code, Codex). Il décrit les conventions générales du projet en un seul document.
• Cursor Rules : des fichiers de règles dans .cursor/rules/, chacun associé à un glob pattern spécifique. Seules les règles pertinentes sont chargées selon les fichiers sur lesquels l'agent travaille.
• Cursor Skills : des fichiers de compétences dans .cursor/skills/ qui décrivent des workflows réutilisables activés à la demande.
• Contenu type : stack technique, conventions de nommage, patterns d'architecture, commandes de build/test, structure du projet, contraintes métier.

Formaliser les manières de faire sur nos projets est devenu essentiel pour tirer le meilleur des agents IA. Chez Dernier Cri, nous préférons les fichiers de rules Cursor aux véritables AGENTS.md : ils permettent de s'activer sur certains glob patterns (par exemple *.vue, api/**) et donc d'éviter de polluer le contexte de l'agent avec des informations non pertinentes. C'est une approche plus fine et plus efficace que le fichier unique.