Documents

Installé mais apparemment inutilisé ? Lorsqu’une plateforme prend en charge les hooks, la mémoire est poussée vers votre agent et rien n’a besoin d’être enseigné. Lorsque ce n’est pas le cas, l’installation écrit une section mémoire dans le fichier de contexte propre à la plateforme, afin que l’agent sache aller la chercher. Si la mémoire semble connectée mais que l’agent n’y recours jamais, ce fichier est la première chose à vérifier.

Ce qu’il écrit dans Claude Code

Dans Claude Code, l’installation pip (brethof-brain install-hooks) conserve un bloc géré dans votre CLAUDE.md, réécrit à chaque début de session. Il s’agit d’un pointeur, et non d’une copie de l’enseignement — il indique à votre agent que la mémoire est Brain, comment y accéder, et que lorsque vous dites « mémorise ceci », cela va dans Brain, et non dans les fichiers de mémoire propres à Claude Code sur une seule machine. Le véritable enseignement arrive au début de la session. Il ne touche jamais rien en dehors du bloc : vos propres conventions restent les vôtres. Pour le désactiver, définissez BRETHOF_BRAIN_NO_CLAUDE_MD=1. Le plugin ne l’écrit jamais : avec une installation par plugin, collez le bloc du README du plugin dans ~/.claude/CLAUDE.md, ou demandez-le à votre agent.

Commandes et versions

Le plugin Claude Code fournit trois commandes : /recall (rechercher maintenant), /onboard (la première minute d’un projet) et /curate (clôturer une session). Il n’y a rien à exécuter à la main — la mémoire organise et range au fil de l’arrivée des enregistrements.

Ce qui change, c’est la façon dont vous parlez à votre agent. Vous pouvez maintenant dire des choses comme Qu’avons-nous décidé concernant les tentatives de paiement ? or N’oubliez pas que la boîte d’emballage est celle qui contient l’ancien certificat. — En termes simples, au cours d’une conversation. Votre agent choisit l’outil approprié ; vous n’en mentionnez jamais un.

Ce à quoi votre agent peut accéder

Vous n’avez pas besoin de cette liste. Elle est là pour que vous sachiez ce qui est possible lorsque vous demandez quelque chose de spécifique.

• Trouver des éléments — Consultez votre mémoire organisée, ou l’historique complet des conversations, lorsque vous avez besoin des mots exacts d’une session antérieure.
• Se souvenir des choses — Enregistrer un fait dans un projet, ou dans la couche partagée qui les englobe tous.
• Apprendre des choses — Sauvegardez une règle, ou commencez un projet avec une phrase décrivant ce qui est important en lui.
• Inspecter les éléments — lister vos projets, lister ce que sait un projet, lister ses règles, ou lire un enregistrement.
• Supprimer des éléments — supprime un seul enregistrement. La rédaction d’une phrase exacte ou la suppression d’un projet entier se fait dans le panneau de compte.
• Consulter le registre — voir la pile d’intentions non tranchées d’un projet, retirer les lignes au fur et à mesure que vous les tranchez.
• Conserver les manuels de jeu — Enregistrer une procédure une fois, pour l’ensemble du compte ; la récupérer et l’exécuter depuis n’importe quel projet ; lister ce qui existe ; supprimer ce qui est inactif.

Une chose que l’agent ne peut délibérément pas faire : Supprimer un projet entier. Cet acte atteint l’archive brute, ce qui fait qu’il reste dans votre panneau de compte, où une personne tape le nom.

Les règles permettent d’éviter de se répéter — les conventions, les contraintes et les corrections acquises au prix d’efforts que vos agents ne doivent jamais oublier. Les bonnes règles ressemblent à des lois : « jamais déployer un vendredi », « ce projet utilise des tabulations, pas des espaces », « le nom du client s’écrit Brethof, jamais Brefoth ». Courtes, absolues, et toujours valables le mois prochain.

Demandez à votre agent d’enregistrer une règle et il vous pose une seule question : est-ce pour tout ce que vous faites, ou seulement pour ce projet ?

Cette troisième option est la plus importante, et elle est choisie plus souvent que les deux autres. Une règle est coûteuse : elle occupe de l’espace à chaque session pour toujours, et elle indique au curateur ce qui est important. En classant des connaissances ordinaires comme des règles, c’est exactement comme si la mémoire se remplissait de sédiments jusqu’à ce que rien ne se distingue plus.

Les règles enseignent au curateur, et non seulement à l’agent.

Un projet avec quelques règles pointues se souvient nettement mieux qu’un projet sans aucune — parce que les règles disent à son curateur ce qui compte là. En enregistrez une et, en quelques minutes, la mémoire de ce projet a réappris ce qu’il est.

Les garder tranchants

Une règle doit être assez courte pour que vous puissiez encore la dire à voix haute — si elle ne tient pas, c’est probablement de la connaissance déguisée en règle. Fusionnez les doublons en un seul et supprimez les règles devenues obsolètes ; rien ne les élaguerait à votre place, car rien d’autre ne devrait avoir le droit de décider quelles sont vos lois. Une douzaine de règles en lesquelles vous croyez valent mieux que cinquante que vous ne lisez plus.

Projets en pratique

La seule décision réelle concerne la manière de les organiser : un par base de code, client ou projet est le modèle qui fonctionne. Trop peu d’éléments non liés entre eux entraînent une confusion ; trop nombreux, et le contexte se perd. Commencer un projet en définissant en une phrase son objectif – ce qu’il est et ce qui doit être retenu – constitue la minute la plus précieuse que l’on puisse consacrer. Cela permet au responsable de comprendre vos intentions dès le premier jour, au lieu de devoir les deviner à partir de fragments d’informations.

Trois choses différentes sont mesurées différemment, et il est utile de savoir laquelle est laquelle. Enregistrement Il est limité par l’espace de stockage. Apprendre il est limité par votre allocation mensuelle. Rappeler n’est limité par rien — la recherche, les informations de session et le rappel sur demande continuent de fonctionner tant que votre mémoire est présente sur nos systèmes en ligne.

Si l’abonnement expire

Le Brain s'interrompt immédiatement — il n'y a pas de période de grâce. Votre mémoire est archivée après le jour 7, vous êtes averti vers le jour 23, et elle est supprimée le jour 30. Un compte payant et actif n'est jamais touché. Le calendrier complet, et les e-mails qui l'accompagnent, figurent dans la Politique de confidentialité.

L’écart laissé par une limite, et pourquoi nous ne le comblons jamais

Bien que la limite soit contraignante, aucune nouvelle mémoire n’est formée. Cela crée un vide dans votre mémoire pour cette période, et Nous ne revenons pas pour le remplir ensuite.. C’est une loi de conception délibérée, et vous devriez la connaître.

Un souvenir n’est créé que à partir d’une conversation. Comme par hasard. Un rapport rédigé plus tard, à partir de documents déjà vieux de plusieurs semaines, écraserait ce qui est vrai depuis lors – et votre mémoire commencerait à affirmer avec assurance des choses qui ont cessé d’être vraies. Nous préférons laisser un vide plutôt que de créer un mensonge affirmé avec certitude.

Donc, clairement : le trou est permanent en tant que mémoire. Votre historique brut de conversations de cette période est toujours là et toujours consultable, donc rien n'est perdu — seule la couche distillée présente un trou. Plus une limite dure, plus votre mémoire s'écarte du travail que vous faites réellement. Et elle ne se répare pas d'elle-même à la reprise : votre agent corrige les souvenirs obsolètes en les rencontrant, et la mémoire rapproche les nouveaux enregistrements des anciens à leur arrivée, retirant ceux que vos souvenirs plus récents contredisent. Ces deux processus avancent, jamais en arrière.

Personne n’est exclu en silence. Vous recevez un e-mail lorsque vous vous approchez d’une limite, un autre lorsque celle-ci est atteinte, une notification dans la session de votre agent au démarrage, ainsi qu’une courte indication à chaque demande tant que la limite est active.