Quand un fichier de notes suffit
Beaucoup de développeurs disent qu'un simple fichier de notes est toute la mémoire dont une IA a besoin, et pour certaines tâches ils ont raison. Un fichier est gratuit, vous pouvez en lire chaque mot, il vit dans le projet avec le code, et il ne s'y passe rien que vous n'ayez écrit.
Un fichier est le bon outil quand :
- Vous utilisez une seule application d'IA, surtout dans un seul projet.
- Ce qu'elle doit savoir concerne le projet : comment le compiler, comment le tester, ce qu'il faut éviter.
- Vous le gardez court et à jour vous-même.
Claude Code lit CLAUDE.md, Cursor lit ses règles, et Claude Code, Cursor et Codex savent tous les trois lire un AGENTS.md. Pour les règles du projet, un seul AGENTS.md versionné avec le code est difficile à battre.
Là où un fichier ne suffit plus
- Chaque application lit un fichier différent, ou aucun. Les applications de conversation ChatGPT et Claude ne lisent pas les fichiers de notes de vos outils de code ; leur propre mémoire vit dans le compte de chaque entreprise.
- Les informations sur vous n'appartiennent pas à un seul projet. La façon dont vous aimez les réponses, les outils que vous préférez, ce sur quoi vous travaillez ce mois-ci : mettez-les dans le fichier d'un dépôt et le projet suivant ne les a pas.
- Quelqu'un doit l'écrire. Un fichier ne sait que ce que vous, ou l'application, avez pensé à y ajouter, et tenir à jour les fichiers de trois applications est une corvée qu'on finit par négliger.
- Seule une partie est lue au démarrage. Anthropic conseille de garder chaque CLAUDE.md sous les 200 lignes, et ne charge que les 200 premières lignes ou les 25 Ko premiers de l'index de mémoire de Claude Code au démarrage d'une session (documentation d'Anthropic). Au-delà, un fichier plus long coûte plus cher et il est moins bien suivi.
Nos propres fichiers, après cinq mois
Nous développons Zaaheen avec Claude Code et tenons les deux types de notes, alors nous avons compté les nôtres :
| Option | Lignes |
|---|---|
| Notre CLAUDE.md | 147 lignes |
| Notre index de mémoire | 155 lignes |
| Le repère d'Anthropic | 200 lignes |
Les deux sont proches de la limite, et ils ne restent en dessous que parce que nous les élaguons : une ligne par souvenir, les détails déplacés dans des fichiers séparés, les anciennes entrées fusionnées ou supprimées. Un fichier de notes fonctionne, et il demande de l'entretien.
Utiliser les deux, pour des choses différentes
La vraie question n'est pas fichier ou outil. Gardez les règles du projet dans un fichier, avec le code. Gardez ce qui est vrai à votre sujet dans une mémoire que toutes les applications d'IA peuvent atteindre : cela reste hors de vos fichiers de projet et vous ne l'écrivez jamais trois fois.
Zaaheen est une mémoire de ce type, pour Windows et Mac : vos applications d'IA enregistrent ce qu'elles apprennent sur vous au fil de l'eau et le retrouvent quand c'est utile, tandis que vos souvenirs restent chiffrés sur votre propre ordinateur. Vous voyez chaque souvenir dans l'application, et vous pouvez oublier celui que vous voulez.