Mémoire en boucle
Mémoire verbale de style Reflexion : l'agent réfléchit par écrit à chaque tentative, stocke la réflexion, et relit les réflexions récentes avant d'agir. La recherche (Shinn et al., 2023) montre que ce mécanisme — réfléchir, stocker, relire — dépasse largement les tentatives aveugles (+22 % sur les tâches de décision sur 12 essais, +11 % sur le code) et bat la mémoire sans réflexion de 8 points. Le gain provient des raisons écrites, pas de la répétition.
Le protocole
Avant d'agir (chaque tâche)
- Lire
.loop/LESSONS.md. - Appliquer la section Règles permanentes sans condition.
- Lire les 3 entrées les plus récentes. Si l'une d'elles est pertinente pour la tâche en cours, indiquer en une ligne comment elle modifie votre approche. Si aucune n'est pertinente, continuez — ne forcez pas.
Après avoir agi (chaque tentative, réussite ou échec)
Ajouter exactement une entrée dans le format du fichier :
## [date] — [tâche, 5 mots max] — RÉUSSI|ÉCHEC
- Ce qui s'est passé : [une ligne]
- Cause racine / pourquoi cela a fonctionné : [une ligne]
- Prochaine fois : [une instruction spécifique et vérifiable]
Critère de qualité pour "Prochaine fois" :
- ❌ "Faire plus attention avec la base de données" — pas vérifiable
- ✅ "Exécuter
npx prisma migrate deployavant tout script d'initialisation" — vérifiable - ❌ "Se souvenir que l'API est délicate" — vague
- ✅ "Le point de terminaison /users pagine à 50 ; toujours passer ?page= lors du comptage"
Réflexion sur l'échec, spécifiquement
Lorsqu'une tentative a échoué, la réflexion doit répondre : qu'est-ce que j'ai cru qui était faux ? Les tentatives échouées viennent généralement d'une hypothèse fausse, pas d'une faute de frappe. Nommez l'hypothèse. C'est la leçon.
Maintenance (lorsque le fichier dépasse ~30 entrées)
- Lire toutes les entrées de la plus ancienne à la plus récente.
- Toute leçon qui apparaît 2 fois ou plus est promue en Règles permanentes, réécrite comme une seule ligne impérative.
- Supprimer les 20 entrées les plus anciennes après la promotion.
- Ne jamais supprimer les Règles permanentes sans l'approbation de l'utilisateur.
Ce qu'il NE faut PAS stocker
- Secrets, clés, jetons, données personnelles — jamais, même s'ils ont causé l'échec.
- Narration ("J'ai ensuite essayé X, après quoi Y…") — ne stocker que les conclusions.
- Leçons en double — si elle est déjà là, ne pas la rajouter ; envisager de la promouvoir.
- Blâme ou autocritique — les leçons sont des instructions, pas des sentiments.
Modes d'échec à éviter
- Théâtre de la mémoire : écrire des entrées mais ne jamais les lire. L'étape de lecture est la valeur ; l'étape d'écriture seule est un journal intime.
- Surajustement à un incident : un hoquet environnemental ponctuel n'est pas une leçon. Si cela ne peut pas se reproduire, ne pas l'enregistrer.
- Croissance illimitée : un fichier de 200 entrées que personne ne lit est une mémoire morte. Compressez.