~$ cat ./dossiers/claude-code-agents-memory-skills.md
Claude Code : agents.md, memory.md, skills.md — comment ils marchent ensemble
Claude Code repose sur trois fichiers Markdown qui transforment le modèle en agent structuré. Ces fichiers permettent de séparer les instructions permanentes, la mémoire persistante et les compétences réutilisables.
Comprendre leur rôle individuel et leur interaction est indispensable pour construire des workflows robustes en production.
agents.md : instructions projet
Le fichier agents.md (ou CLAUDE.md) contient les règles, le contexte métier et les contraintes spécifiques au projet. Il est lu à chaque session et agit comme un prompt système permanent.
Tu y places la stack technique, les conventions de nommage, les interdictions et les objectifs globaux. Cela évite de répéter ces informations à chaque conversation.
memory.md : persistance entre sessions
memory.md stocke l’état courant : décisions prises, variables importantes, historique de tâches et contexte utilisateur. Claude peut le lire et le mettre à jour automatiquement.
Cette couche résout le problème de la fenêtre de contexte limitée et permet de reprendre un projet plusieurs jours plus tard sans tout réexpliquer.
skills.md : capacités réutilisables
skills.md (ou SKILL.md) décrit des compétences modulaires déclenchables par un mot-clé ou une commande. Chaque skill est une procédure documentée que Claude peut invoquer à la demande.
Tu y ranges les workflows récurrents : déploiement, revue de code, génération de tests, migration de données, etc.
Comment les trois couches interagissent
agents.md fournit le cadre, memory.md l’état et skills.md les outils. Claude consulte d’abord agents.md, charge le contexte mémoire, puis déclenche les skills nécessaires selon la tâche.
Cette séparation permet de modifier une compétence sans toucher aux règles projet ni perdre l’historique.
Bonnes pratiques de structuration
Garde agents.md concis et stable. Versionne memory.md avec soin et nettoie régulièrement les entrées obsolètes. Documente chaque skill avec ses entrées, sorties et prérequis.
Utilise des sections claires et des exemples concrets dans chaque fichier pour que Claude les interprète sans ambiguïté.
à retenir
- agents.md pose les règles permanentes du projet.
- memory.md conserve l’état entre les sessions.
- skills.md expose des procédures réutilisables à la demande.
- Les trois fichiers se lisent dans un ordre précis : règles → mémoire → compétences.
- Une bonne structuration évite la redondance et facilite la maintenance.
questions fréquentes
Faut-il versionner memory.md ?
Oui, mais en ignorant les données sensibles. Le fichier contient souvent des décisions et des variables utiles pour la reprise de contexte.
Comment déclencher une skill ?
Tu appelles simplement le nom de la skill dans ta requête. Claude consulte skills.md et exécute la procédure documentée.
agents.md peut-il contenir du code ?
Non, il contient uniquement des instructions textuelles. Le code source reste dans le dépôt, agents.md décrit seulement les conventions.
Quelle est la taille idéale de memory.md ?
Quelques centaines de lignes maximum. Au-delà, il faut archiver les anciennes entrées et conserver uniquement l’état actif.
