Une mémoire de 100 fiches pour mon agent IA

La mémoire de mon agent tient dans un dossier de fichiers Markdown : une fiche par fait, quatre types, et un index d’une ligne par fiche, chargé à chaque session. Elle compte aujourd’hui 101 fiches, et c’est ce qui m’évite d’expliquer deux fois la même chose.

Le problème

Un agent IA oublie tout d’une conversation à l’autre. Au bout de quelques semaines, je répétais les mêmes consignes : ne pas explorer mon site en rafale, citer le texte exact d’un modèle, vérifier un chiffre à la source. Chaque correction que je faisais disparaissait avec la session.

Le principe

Claude Code propose une mémoire de fichiers. Chaque fiche est un fichier Markdown, avec un petit en-tête qui la décrit :

---
name: citer-le-texte-reel-du-template
description: Dans un prompt de variable, citer la phrase exacte du modèle
metadata:
  type: feedback
---

Le prompt disait « après la préposition de », alors que cette préposition
n'est écrite nulle part dans le modèle. La valeur est insérée telle quelle.

**Why:** la consigne inventée a fait produire une phrase fausse.
**How to apply:** citer le texte réel autour de la variable avant d'écrire le prompt.

Un fichier d’index, MEMORY.md, liste toutes les fiches avec une seule ligne chacune : un titre, un lien, un résumé court. C’est lui qui est chargé au début de chaque session ; l’agent ouvre une fiche complète quand le sujet revient.

Les quatre types

Mes 101 fiches se répartissent ainsi :

Type	Nombre	Ce qu’on y met
`project`	45	L’état d’un chantier, avec des dates absolues
`feedback`	34	Une consigne que j’ai donnée, avec le pourquoi, et aussi ce que j’ai validé
`reference`	21	Où se trouve une ressource, les pièges d’une API
`user`	1	Qui je suis et comment je travaille

Les fiches feedback sont les plus rentables : chacune est une erreur qui ne se reproduit pas. Ne pas explorer son propre site avec un agent, vérifier un pic de données avant de l’interpréter, ne jamais présenter un écran inventé comme une capture : à chaque fois, une correction faite une fois et gardée.

Les règles que je m’impose

Un fait par fichier. Une fiche qui en contient trois est impossible à mettre à jour proprement.
Chercher avant d’écrire. Si une fiche couvre déjà le sujet, on la met à jour au lieu d’en créer une deuxième.
L’index n’est qu’un index. Une ligne par fiche, jamais le contenu : il est lu à chaque session, donc il coûte du contexte.
Le pourquoi toujours écrit. Sans « Why », une règle devient un dogme que l’agent applique à côté de la plaque ; avec lui, il sait quand elle ne s’applique pas.
Des dates absolues. « Jeudi » ne veut rien dire dans trois semaines.
Relier les fiches entre elles avec un lien [[nom]], pour retrouver le contexte d’une règle.
Ne pas stocker ce que le code, l’historique ou la documentation disent déjà. La mémoire garde ce qui n’est écrit nulle part ailleurs.

Ce qui se périme

Une fiche décrit le monde tel qu’il était le jour où elle a été écrite. Un jour, l’agent ne retrouvait plus des outils que la fiche disait installés : quelqu’un les avait retirés du serveur. Claude Code rappelle d’ailleurs l’âge d’une fiche quand il la lit, et la consigne est de vérifier avant d’affirmer : un nom de fonction, un fichier ou un réglage cités dans une fiche doivent être contrôlés dans l’état actuel.

Les limites

L’index grossit. À une centaine de lignes, il pèse sur chaque session : les résumés doivent rester courts, et un nettoyage régulier (fusionner les doublons, retirer ce qui est faux) est nécessaire.
Elle contient des données internes. Une mémoire utile est une mémoire précise : elle ne se publie pas, et elle se relit avant d’être partagée.
Elle ne remplace pas le jugement. Une règle ancienne peut être mauvaise aujourd’hui. Quand elle l’est, je supprime la fiche plutôt que de la contourner.

À retenir

Écrivez la correction au moment où vous la faites : une fiche courte, un type, un pourquoi, une ligne dans l’index. Cent fiches plus tard, l’agent se comporte comme quelqu’un qui connaît votre métier, vos outils et vos manies, parce qu’on le lui a dit une seule fois.