La mémoireMemoryLa memoria
Parcours : Construire un agent de code, le harnais · OpérationnelCourse: Building a Coding Agent: the Harness · PractitionerCurso: Construir un agente de código: el harness · Operativo

≈ 9 min
Le problème
Le problème : chaque demande repart de zéro, et l’utilisateur doit redire ses préférences et les faits du projet à chaque session.
Au programme de ce moduleIn this moduleEn el programa de este módulo
- 01Le problème≈ 9 min
- 02L’intuition≈ 8 min
- 03Le mécanisme≈ 9 min
- 04Le code, pas à pas≈ 10 min
- 05Pièges & pratiques≈ 10 min
- 06Exercice≈ 6 min
- 07Quiz≈ 5 min
Objectifs d’apprentissage
À la fin de ce module, vous saurez donner à votre agent une mémoire qui survit d’une session à l’autre, sélective, datée et sous contrôle. Voici les acquis visés.
- Distinguer la mémoire de l’historique et de la compaction : quelques faits choisis, gardés hors de la conversation ;
- Stocker un souvenir par fichier, avec un en-tête (nom, description, type, date) et un index d’une ligne par souvenir ;
- Rappeler l’index au début de chaque demande, comme un contexte et non comme une consigne, et laisser l’agent lire le détail à la demande ;
- Éviter les souvenirs nuisibles : consigne du jour, secret, information périmée ou souvenir glissé par un texte malveillant.
Sources
Curriculum open-source shareAI-lab/learn-claude-code, chapitre s09 (Memory), publié sous licence MIT, © shareAI-lab, adaptation Getul. La notice de licence est reproduite sur la page Sources et références. Documentation publique de Claude Code (Anthropic) sur la mémoire (CLAUDE.md et mémoire automatique) et sur les hooks, citée pour comparer avec un outil en production. Le motif présenté est indépendant du fournisseur : il vaut pour toute API offrant l’appel d’outils.
L’agent qui oublie tout
Lundi, vous expliquez à votre agent que vous indentez avec des tabulations, que les tests se lancent avec make test, et que le module de paiement ne doit pas être modifié sans revue. Mardi, nouvelle session : il indente avec des espaces, cherche comment lancer les tests, et propose de modifier le paiement.
Rien d’anormal : agent_loop crée une liste messages neuve à chaque demande, et tout disparaît quand le programme s’arrête. La compaction du module 8 ne change rien à cela : elle gère la place dans la session en cours, elle ne garde rien pour la suivante.
Garder tout l’historique de toutes les sessions et le renvoyer au modèle ne marcherait pas : c’est le problème du module 7, en pire. Il faut choisir quelques faits utiles, les ranger hors de la conversation, et ne rappeler que l’essentiel.
Pour comprendre : le carnet du consultant
Un bon consultant ne relit pas tous ses échanges avec un client avant chaque rendez-vous. Il tient un carnet : le client préfère les synthèses courtes, la direction financière valide les budgets, le dossier contrats est sur tel serveur. Une ligne par fait, datée, mise à jour quand elle change. Le carnet suffit à reprendre le fil sans tout redemander.
Vérifiez votre compréhensionCheck your understandingVerifique su comprensión
Pourquoi la compaction du module 8 ne suffit-elle pas à faire « se souvenir » l’agent d’une session à l’autre ?
À retenir
Sans mémoire, chaque session repart de zéro. La mémoire n’est ni l’historique complet ni la compaction : quelques faits choisis, rangés hors de la conversation, et rappelés au bon moment.