Rules et AGENTS.md
AGENTS.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.
- rules
- agents.md
- claude.md
- conventions
- instructions projet
Syntaxe
AGENTS.md à la racine du dépôt (format ouvert lu par plusieurs agents de code) - Stack et versions - Où se trouve quoi - Commandes : build, lint, tests - Conventions non couvertes par le linter (langue de l'interface, nommage) - Interdits (secrets, commit sans demande)Claude Code : CLAUDE.md contenant « @AGENTS.md » · Cursor : AGENTS.md ou .cursor/rules/*.mdcExemple
# AGENTS.md- Next.js 16 : lire node_modules/next/dist/docs/ ; params est une Promise- Prisma : importer depuis @/generated/prisma/client- Vérifier avec : npx tsc --noEmit && npm run lint- Interface en français- Interdit : lire .env*, committer ou pousser sans demande expliciteRésultat attendu : un nouvel arrivant, humain ou agent, lance les bonnes commandessans avoir à poser la question.À retenir
- Mettez le fichier à jour dans la même PR que le changement de stack ou de commande, sinon l'agent suit des consignes périmées.
- Renvoyez vers la documentation interne plutôt que de la recopier : le fichier reste court et à jour.
- AGENTS.md décrit le projet en permanence ; une procédure ponctuelle et détaillée va dans un skill.
- Piège : compter sur ce fichier pour empêcher un comportement dangereux. C'est un conseil que le modèle peut ignorer ; les interdits critiques se doublent d'une règle deny ou d'un hook (fiche « Consultatif ou déterministe »).
Voir aussi
- Un AGENTS.md courtPlus 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.
- 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.
- Consultatif ou déterministeUne consigne en Markdown est un conseil que le modèle peut ignorer ; une permission deny ou un hook est une règle appliquée par l'outil. Tout ce qui est irréversible relève de la seconde catégorie.
- Skill (SKILL.md)Un skill est un dossier d'instructions spécialisées que l'agent ne charge que si la tâche le demande. Il capitalise une procédure répétée, là où AGENTS.md décrit le projet en permanence.