Instructions du projet : AGENTS.md

Un fichier AGENTS.md est un simple fichier texte, placé à la racine du dossier de travail, qui décrit les règles du projet : ce que l'agent a le droit de modifier, les commandes à lancer pour vérifier son travail, et les précautions à prendre. L'agent le lit au début de chaque conversation, avant de proposer une action.

Le nom exact est AGENTS.md, en majuscules, avec l'extension .md. C'est ce nom que l'application crée avec la commande /init et qu'elle affiche dans Paramètres → Projet. L'agent reçoit aussi la consigne de lire un fichier de ce nom présent dans un sous-dossier, ou un fichier CLAUDE.md hérité d'autres outils.

Dans le composeur, tapez /init puis Entrée : l'agent analyse le dossier et crée AGENTS.md s'il n'existe pas encore. Vous pouvez aussi ouvrir Paramètres → Projet : la section AGENTS.md montre le contenu du fichier, avec un bouton pour recharger et un autre pour enregistrer vos modifications.

Dans cette même section, « Analyse locale du projet » prépare un brouillon d'instructions à partir de ce que l'application observe dans le dossier. Rien n'est écrit sans votre accord, sauf si vous cochez « Accepter automatiquement les instructions générées », décochée par défaut.

Un bon fichier tient en quelques lignes. Chaque règle doit être courte et vérifiable par l'agent. Voici un exemple que vous pouvez copier dans un projet simple, puis adapter :

Une règle écrite dans AGENTS.md est une consigne au modèle, pas une protection technique : elle peut être mal comprise ou oubliée dans une longue conversation. Les vraies barrières sont le mode d'exécution, la liste blanche, la politique d'outils et les commandes interdites, réglés dans les Paramètres.

N'y écrivez jamais de mot de passe, de clé ou de donnée personnelle : le fichier est lu par l'agent comme n'importe quel autre fichier du dossier. Un fichier AGENTS.local, s'il existe, est signalé par l'application mais jamais écrit par elle.

Une procédure répétable (préparer un type de document, lancer une série de vérifications) ne va pas dans AGENTS.md mais dans une skill : la page Skills explique comment la créer et l'appeler. La délégation d'un sous-travail à un sous-agent, et la relecture de son résultat, sont décrites dans la page Concepts de l'agent.

Toujours dans Paramètres → Projet, les « Mémoires projet » enregistrent une décision ou une convention durable en une phrase (« les dates sont au format jour/mois/année », par exemple) ; elles sont transmises à l'agent avec les instructions. La section « Variables .env » permet de consulter et modifier, valeur masquée, les variables d'environnement du projet.

Pour les utilisateurs avancés : un fichier SOUVER.md à la racine est également reconnu et transmis tel quel à l'agent, dans la limite de 12 000 caractères. Pour un projet ordinaire, AGENTS.md suffit.