Fichier d’instructions

Le contrat d’entrée du projet pour un agent : le contexte permanent qu’il lit au début de chaque session. CLAUDE.md, AGENTS.md, le nom varie, la pratique est la même.

Ce qu’il contient de mieux, ce sont des faits vérifiables. L’architecture réelle, les conventions qui vous tiennent à cœur, les commandes qui valident le travail. Ce qu’il contient de pire, ce sont des adjectifs : « écrire du code propre », « être rigoureux ».

C’est aussi le seul endroit où une correction survit. Reprendre l’agent dix fois dans une session ne laisse aucune trace ; écrire la règle dans le fichier, si.

Il coûte de la place à chaque session. Ce qui y figure doit servir presque à chaque fois ; le reste appartient à une procédure rechargeable.

À éviter

En faire un manifeste. Et y accumuler des règles au fil des agacements sans jamais en retirer : un fichier de trois cents lignes finit lu comme un bruit de fond.