Qu'est-ce que Auto Dream dans Claude Code ?
TL;DR : Auto Dream est un sub-agent de Claude Code qui consolide automatiquement les fichiers mémoire toutes les 24h (après 5+ sessions). Il dédoublonne les entrées, supprime les notes obsolètes, convertit les dates relatives en absolues et maintient MEMORY.md sous 200 lignes. Fonctionnalité en cours de déploiement (mars 2026).
Auto Dream est un mécanisme de consolidation automatique de la mémoire dans Claude Code. Il fonctionne comme un sub-agent en arrière-plan qui nettoie, organise et met à jour les fichiers mémoire accumulés par Auto Memory au fil des sessions.
Le nom s'inspire des neurosciences : pendant le sommeil paradoxal (REM), le cerveau rejoue les événements de la journée, renforce les connexions utiles et élimine le superflu. Auto Dream fait la même chose avec les notes de Claude Code.
Le problème : la mémoire qui pourrit
Auto Memory est une fonctionnalité puissante. Claude prend ses propres notes pendant qu'il travaille : commandes de build, décisions d'architecture, préférences de style, bugs résolus. Ces notes vivent dans ~/.claude/projects/ et sont rechargées à chaque session.
Le problème apparaît après 20, 50 ou 100 sessions. Les notes s'accumulent sans maintenance :
- Dates relatives périmées : "Hier on a décidé d'utiliser Redis" perd tout sens trois semaines plus tard
- Entrées contradictoires : une note dit "API en Express", une autre dit "migration vers Fastify terminée"
- Doublons : trois sessions différentes ont noté la même commande de build
- Notes obsolètes : des solutions de debug pour des fichiers qui n'existent plus
- MEMORY.md surchargé : l'index dépasse 200 lignes, et tout ce qui dépasse n'est pas chargé au démarrage
Le résultat : Claude commence à halluciner sur la base d'informations périmées, ou perd des instructions importantes noyées dans le bruit.
Comment fonctionne Auto Dream ?
Auto Dream s'exécute en quatre phases, inspirées du processus de consolidation mémorielle du sommeil.
Phase 1 : Orientation
Claude scanne le répertoire mémoire et lit MEMORY.md pour comprendre l'état actuel. Il établit une carte de ce qui existe.
Phase 2 : Collecte de signal
Le sub-agent parcourt les transcripts de sessions récentes (fichiers JSONL) pour identifier les patterns à forte valeur : corrections utilisateur, sauvegardes explicites, thèmes récurrents, décisions importantes. Il ne lit pas tout exhaustivement, il cherche des patterns spécifiques.
Phase 3 : Consolidation
C'est le travail principal :
- Conversion des dates : "hier" devient "le 2026-03-24". Les dates absolues restent lisibles dans le temps.
- Suppression des contradictions : si vous avez migré d'Express à Fastify, l'entrée "API en Express" disparaît
- Fusion des doublons : trois notes sur la même commande de build deviennent une seule entrée propre
- Nettoyage des notes obsolètes : les solutions de debug pour des fichiers supprimés sont retirées
Phase 4 : Élagage et indexation
MEMORY.md est mis à jour : pointeurs obsolètes retirés, nouveaux fichiers référencés, contradictions résolues. L'index est maintenu sous 200 lignes (seuil de chargement au démarrage).
Conditions de déclenchement
Auto Dream ne s'exécute pas à chaque session. Deux conditions doivent être réunies :
| Condition | Seuil | Raison |
|---|---|---|
| Temps écoulé | 24 heures minimum depuis la dernière consolidation | Éviter les exécutions inutiles |
| Sessions accumulées | 5 sessions minimum depuis la dernière consolidation | Garantir assez de matière à consolider |
Cette double porte empêche les exécutions sur des projets inactifs tout en assurant un nettoyage régulier sur les projets actifs. Un cas observé a consolidé l'équivalent de 913 sessions en 8 à 9 minutes.
Garanties de sécurité
Auto Dream opère avec des contraintes strictes :
- Mode lecture seule sur le code : le sub-agent ne peut modifier que les fichiers mémoire, jamais le code source
- Fichier de verrou : empêche deux consolidations concurrentes sur le même projet
- Exécution en arrière-plan : ne bloque jamais la session active
Déclenchement manuel
Vous pouvez forcer une consolidation à tout moment en le demandant dans la conversation :
dreamconsolidate my memory filesauto dreamClaude lancera le processus de consolidation immédiatement, sans attendre les seuils de 24h et 5 sessions.
Les quatre systèmes de mémoire de Claude Code
Auto Dream s'inscrit dans un écosystème de quatre mécanismes de mémoire complémentaires :
| Système | Rôle | Déclencheur | Qui l'écrit |
|---|---|---|---|
| CLAUDE.md | Instructions persistantes du projet | Manuel | Vous |
| Auto Memory | Capture des apprentissages en session | Continu | Claude |
| Session Memory | Continuité de conversation entre sessions | Automatique | Claude |
| Auto Dream | Consolidation et maintenance | Toutes les 24h + 5 sessions | Claude |
CLAUDE.md donne les règles. Auto Memory prend les notes. Session Memory maintient le fil de la conversation. Auto Dream fait le ménage.
Impact concret
Avant consolidation : un répertoire mémoire avec un MEMORY.md de 280+ lignes, des entrées contradictoires, des références à des fichiers supprimés, des doublons répartis sur plusieurs fichiers.
Après consolidation : MEMORY.md retombe à ~142 lignes (sous le seuil de 200 lignes chargées au démarrage), les contradictions sont résolues, toutes les dates sont absolues, les entrées redondantes sont fusionnées.
Le ratio signal/bruit s'améliore, et Claude travaille plus efficacement sur les projets au long cours.
Disponibilité
Auto Dream est en cours de déploiement progressif (mars 2026). La fonctionnalité est contrôlée par un feature flag côté serveur. Elle apparaît dans le menu /memory mais ne peut pas encore être activée manuellement par tous les utilisateurs.
Les paramètres de configuration révèlent l'approche :
{
"minHours": 24,
"minSessions": 5,
"enabled": false
}Le paramètre enabled est géré côté serveur. Les settings locaux ne peuvent pas le surcharger.
Fondement théorique
Le design d'Auto Dream s'appuie sur le papier de recherche "Sleep-time Compute: Beyond Inference Scaling at Test-time" (avril 2025). Cette recherche a démontré que le prétraitement du contexte pendant les périodes d'inactivité peut réduire les coûts d'inférence d'un facteur 5.
En consolidant la mémoire entre les sessions plutôt que pendant le travail actif, Auto Dream applique ce principe : le temps de "sommeil" de l'agent est du compute utile.
Pour aller plus loin
La gestion de la mémoire n'est qu'un aspect de Claude Code. Notre formation Claude Code d'une journée couvre les fichiers CLAUDE.md, le Plan Mode, les sub-agents, les hooks et la création de skills personnalisés.
