Mémoire

La mémoire est la façon dont les agents MadoHub retiennent les choses entre les sessions. Sans elle, chaque nouveau terminal signifie qu'un agent réapprend vos conventions, votre stack, votre style de code et les décisions que vous avez prises la semaine dernière. La mémoire survit entre les sessions et les projets, donc un agent reprend là où le précédent s'était arrêté au lieu de repartir de zéro.

La mémoire est séparée de l'historique de chat d'une session. L'historique de chat est la conversation que vous avez en ce moment ; la mémoire est l'arrière-plan durable sur lequel l'agent s'appuie. Vous gardez le contrôle de ce qui est retenu : la supposition d'un agent sur ce qui vaut la peine d'être conservé va d'abord dans une file de revue, et vous l'approuvez avant qu'elle n'atterrisse dans la mémoire à long terme.

Ce que vous pouvez faire

• Stocker six types de choses — préférences, faits, décisions, motifs, postmortems et événements. Chaque entrée est étiquetée avec son type afin que le tableau de bord de la mémoire puisse filtrer et libeller proprement.
• Organiser par namespace — séparez la mémoire propre à un persona de la mémoire propre à un projet. Un agent rappelant une convention de projet ne tirera pas toutes les préférences personnelles de chaque persona.
• Revoir avant de figer — chaque candidat de mémoire siège dans une file en attente de votre approbation. Modifiez la formulation, changez le type, rejetez-le, ou approuvez-le tel quel.
• Injecter automatiquement la mémoire pertinente — activez le recall automatique et les entrées correspondantes sont prépendées à chaque nouvelle conversation, afin que les préférences et décisions pertinentes apparaissent sans que l'agent ait à demander.
• Rechercher manuellement — les agents peuvent appeler recall explicitement avec une requête en texte intégral lorsqu'ils ont besoin de quelque chose de spécifique.

Comment l'utiliser

1. Ouvrez Paramètres → Mémoire pour atteindre le tableau de bord de la mémoire.
2. Examinez les candidats dans l'onglet Pending review. Pour chacun, vous pouvez :
   • Approuver tel quel
   • Éditer le contenu ou le type, puis approuver
   • Rejeter
   • Revenir au tour de conversation original qui l'a produit
3. Parcourez et gérez les entrées approuvées dans l'onglet Approved, groupées par namespace. Éditez, supprimez, ou ajoutez manuellement de nouvelles entrées de mémoire depuis ici.
4. Basculez l'injection de recall automatique pour choisir si la mémoire correspondante est auto-prépendue aux nouvelles conversations, ou seulement exposée lorsqu'un agent appelle recall explicitement.
5. Optionnel : dans la section Advanced, activez des politiques comme l'auto-approbation des candidats vus suffisamment de fois à une confiance suffisamment élevée.

Cas d'usage courants

• « On utilise pnpm, jamais npm. » — une préférence qu'un agent peut rappeler à chaque nouvelle session au lieu de la découvrir en échouant d'abord.
• « On a décidé de garder l'auth dans le monolithe, pas de l'extraire. » — une décision qui doit continuer à réapparaître afin que les futurs agents ne la remettent pas en cause.
• « Le test flaky dans payments.spec est causé par une race dans l'horloge mock. » — un postmortem qui vaut la peine d'être retenu la prochaine fois que quelqu'un touche ce fichier.
• « Les réponses API de ce projet sont du JSON camelCase. » — un fait que l'agent amène dès qu'il génère ou édite du code d'API dans cet espace de travail.

Conseils et bonnes pratiques

• Revoyez régulièrement la file en attente. Une decision ou un postmortem erroné ou périmé est pire qu'une absence, parce qu'il continuera de réapparaître aux futurs recalls.
• Utilisez les namespaces délibérément — restreignez les conventions de projet au namespace workspace: afin qu'elles ne fuitent pas vers d'autres projets.
• Épinglez les entrées que vous ne voulez jamais voir auto-surclassées ; les entrées épinglées apparaissent en premier au recall.
• Si la mémoire devient bruyante, désactivez l'injection automatique et laissez les agents appeler recall explicitement uniquement lorsqu'ils en ont besoin.

Fonctionnalités associées

• MadoAgent — le panneau où les agents utilisent le plus souvent la mémoire.
• Paramètres — où vivent le tableau de bord de la mémoire et ses politiques.

Limitations

• Les requêtes de recall nécessitent au moins 3 caractères — les requêtes plus courtes sont rejetées afin que l'agent sache qu'il doit reformuler plutôt que de ne rien obtenir silencieusement.
• Les candidats s'auto-archivent après 30 jours d'inactivité, ne laissez donc pas la file indéfiniment.
• La mémoire ne remplace pas l'historique de chat ; c'est une couche plus petite et curatée de faits durables.