CLAUDE.md / AGENTS.md : mémoire et règles pour ton agent

Le problème sans mémoire

Un agent IA repart de zéro à chaque nouvelle session. Il ne sait pas quelles règles de code ton équipe suit, quelles commandes lancent les tests, ou que vous ne poussez jamais directement sur la branche main – sauf si tu le lui redis à chaque fois.

La solution : un fichier de règles

CLAUDE.md (appelé AGENTS.md dans certains outils) est un simple fichier markdown à la racine de ton projet. L'agent le lit automatiquement au début de chaque session et traite son contenu comme des instructions fixes – comme une mémoire qui persiste au-delà de chaque conversation.

Qu'est-ce qui va dedans ?

• Le contexte du projet (« C'est un frontend React avec un backend Express »)
• Les commandes (« Les tests se lancent avec npm test »)
• Les règles (« Ne jamais pousser directement sur main », « Toujours lancer les tests avant un commit »)
• Les préférences de style de code
• Les pièges connus du projet

Pourquoi ça marche

Sans ce fichier, tu dois répéter les mêmes règles à chaque nouvelle session. Avec lui, les règles de base sont toujours présentes – l'agent se comporte de façon plus cohérente et fait moins d'erreurs évitables.