Notion · Dialoguer avec un modèle
Fichier de consignes (CLAUDE.md, AGENTS.md)
Un fichier texte lu automatiquement par l’assistant au démarrage, qui contient vos règles permanentes : conventions, interdits, façon de travailler. On l’écrit une fois, il s’applique à chaque session.
Comment ça marche
Chaque session avec un agent de code commence de zéro : il ne sait rien de vos habitudes, de vos dossiers ni de vos interdits. Le fichier de consignes règle ça. C’est un simple fichier texte, en Markdown, placé là où l’agent le trouve, et qu’il lit automatiquement avant de commencer. Tout ce qui y est écrit vaut pour la session entière.
On y met les règles qu’on ne veut plus répéter. Comment les fichiers sont organisés et nommés. Ce qu’il ne faut jamais faire sans demander. Comment on veut que l’agent travaille : proposer avant d’agir, lire tel fichier d’abord, rendre compte en fin de tâche. Les outils et les commandes du projet. Et parfois des connaissances sur le métier que l’agent ne peut pas deviner. Le fichier grandit avec l’expérience : chaque erreur de l’agent qu’on ne veut pas revoir devient une ligne.
Un exemple concret
Organisation. Un dossier par client dans clients/, nommé NOM-CLIENT. Les documents reçus vont dans recus/, les documents produits dans produits/, avec la date en tête : 2026-10-21-nom.
Interdits. Ne jamais supprimer ni déplacer un fichier sans me le demander. Ne jamais modifier un fichier dans recus/. Ne jamais envoyer d’e-mail.
Façon de travailler. Avant toute tâche sur un dossier client, lis clients/NOM-CLIENT/README.md. Pour une tâche de plus de trois étapes, propose un plan et attends mon accord. Si une information manque, écris À COMPLÉTER au lieu d’inventer.
Fin de tâche. Liste les fichiers créés ou modifiés, et signale ce que tu n’as pas pu faire.
Métier. Les montants sont toujours en euros hors taxes sauf mention contraire. L’exercice comptable de la plupart des clients se termine au 31 décembre ; vérifie dans le README du client.
Vingt lignes, relues et complétées tous les mois. Chaque ligne est née d’une session où l’agent avait fait autrement.
Ce que ça change pour une équipe
- L’agent devient prévisible. Mêmes règles à chaque session, pour chaque collaborateur. Les résultats se ressemblent.
- Le savoir-faire se capitalise. Les conventions de l’équipe, autrefois orales, sont écrites, versionnées et appliquées.
- Les erreurs ne se répètent pas. Une erreur, une ligne de plus. Le fichier est la mémoire des leçons apprises.
- L’onboarding s’accélère. Un nouveau collaborateur qui lance l’agent dans un projet hérite immédiatement des règles de l’équipe. Et le fichier lui apprend, à lui aussi, comment on travaille.
Les limites et les erreurs fréquentes
- Le fichier fleuve. Deux cents lignes que l’agent relit à chaque session : coût, lenteur, et consignes contradictoires que l’agent suit mal. Garder l’essentiel, déplacer le reste dans des skills ou des fichiers lus à la demande.
- Les consignes vagues. « Sois prudent » ne sert à rien. « Ne supprime jamais un fichier sans demander » sert.
- Le fichier jamais mis à jour. Il décrit une organisation qui n’existe plus. Relecture mensuelle, et une ligne ajoutée à chaque leçon.
- Y mettre des secrets. Jamais de mot de passe ni de clé dans un fichier de consignes : il est lu, copié, versionné.
Pour aller plus loin
Claude Code lit CLAUDE.md (global ou par projet), d’autres outils lisent AGENTS.md ou des fichiers de règles. Ces consignes entrent dans le contexte à chaque session : les garder courtes et précises, et les versionner avec le projet.
Où ça se situe chez Opora
Programme 04 · Construire des agentsIngénierie agentique pour les équipes techniques
Écrire le fichier de consignes de votre équipe, le tester et le faire vivre, c’est l’un des premiers livrables du programme Construire des agents.
Questions fréquentes
CLAUDE.md, AGENTS.md, quelle différence ?
Le même principe sous des noms différents. CLAUDE.md est le fichier lu par Claude Code ; AGENTS.md est un format que plusieurs autres outils lisent, dont Codex. D’autres éditeurs ont leurs propres fichiers de règles. Le contenu est le même : vos consignes permanentes, en texte.
Que doit-il contenir ?
Ce que vous répéteriez sinon à chaque session : l’organisation des dossiers, les conventions de nommage, les interdits (ne jamais supprimer sans demander, ne jamais toucher à tel dossier), la façon de rendre compte, les outils à utiliser. Court et précis : chaque ligne est relue à chaque session.
Où le placer ?
Un fichier global, dans votre dossier personnel, pour les règles valables partout. Un fichier par projet, à la racine du dossier, pour les règles propres au projet. L’agent lit les deux et les combine.