AGENTS.md : un fichier d’instructions pour agents IA
AGENTS.md est un format Markdown simple pour expliquer à un agent IA comment travailler dans un projet : setup, tests, style, sécurité et contribution.
Un README pour agents
Comme un README aide les humains, AGENTS.md aide les agents IA à éviter les suppositions. Il peut contenir commandes de setup, conventions, chemins importants et règles à respecter.
Setup et environnement
Le fichier explique comment installer les dépendances, lancer le projet et préparer l’environnement local. Plus la procédure est explicite, moins l’agent risque d’inventer une commande.
Tests et validation
Une section dédiée aux tests indique les commandes à exécuter, les suites prioritaires et les cas où une validation manuelle est nécessaire.
# AGENTS.md
## Setup
npm install
## Tests
npm test
## Style
Respecter les conventions existantes.
## Sécurité
Ne jamais lire ni afficher de secrets.
Style, sécurité et pull requests
AGENTS.md peut rappeler le style de commit, les règles de nommage, les restrictions sur les dépendances et les informations à inclure dans une PR. Dans un monorepo, il peut préciser les règles par dossier.
Pour aller plus loin : agents IA, outils, skills.sh et comprendre le Vibe Coding.
Mettre vos agents dans de bonnes conditions
Un bon fichier d’instructions réduit les ambiguïtés et améliore la qualité des changements.
