Un AGENTS.md court
Plus le fichier d'instructions est long, moins chaque consigne est suivie. Un bon AGENTS.md tient en quelques dizaines de lignes de puces et renvoie vers la documentation au lieu de la copier.
- agents.md
- claude.md
- longueur
- puces
- concision
Syntaxe
Moins de 60 lignes visées, 100 au maximumDes puces courtes, une consigne vérifiable par ligneDes renvois vers les fichiers (« voir docs/… ») plutôt que des copiesUn seul fichier de référence : AGENTS.md ; CLAUDE.md se contente de l'importer (@AGENTS.md)Exemple
# AGENTS.md- Next.js 16 : lire node_modules/next/dist/docs/ ; await params- Prisma : @/generated/prisma/client, jamais @prisma/client- Vérifier : npx tsc --noEmit && npm run lint- Interdit : commit ou push sans demande ; lire .env* ; --no-verify# CLAUDE.md@AGENTS.mdRésultat attendu : quatre consignes lues en entier à chaque session,et aucune divergence possible entre les deux fichiers.À retenir
- Ne répétez pas ce que le linter et le formateur imposent déjà : chaque ligne inutile dilue les autres.
- Préférez des faits vérifiables (« les imports Prisma viennent de @/generated/prisma/client ») à des injonctions d'attitude (« tu es un développeur senior »), qui ne changent rien au code produit.
- Relisez le fichier quand l'agent répète une erreur : soit la consigne manque, soit elle est noyée.
- Piège : maintenir deux fichiers complets, AGENTS.md et CLAUDE.md. Ils divergent en quelques semaines ; l'un doit simplement importer l'autre.
Voir aussi
- Rules et AGENTS.mdAGENTS.md et les rules sont des instructions lues à chaque session : stack, arborescence, commandes, conventions et interdits. Ils évitent de réexpliquer le projet à chaque nouvelle demande.
- Les quatre couches d'instructionsLes consignes d'un agent viennent de quatre couches : vos règles personnelles, le fichier du projet, les rules ciblées par chemin et les skills chargés à la demande. Chaque consigne a sa place.
- Rules Cursor (.mdc)Propre à Cursor : une rule est un fichier .mdc de .cursor/rules/ qui porte les consignes d'un domaine. Son en-tête dit quand la charger : toujours, selon le chemin ou selon sa description.