Étape 7 · À tout moment

`/pulse:memory`

Créer, actualiser, enrichir ou compacter la mémoire du projet (choix, mots du métier, pièges), chargée par l'IA à chaque session.

Description

L'IA oublie tout d'une conversation à l'autre. La mémoire du projet lui rappelle, à chaque session, vos choix, les mots de votre métier et les pièges déjà rencontrés. Elle se compose de quelques fichiers courts, rangés dans votre projet et enregistrés avec lui.

Cette commande s'occupe de cette mémoire. Elle la crée à partir de vos documents et de votre code, l'actualise quand le projet a changé, y retient une leçon ou une décision, et la compacte quand elle devient trop longue.

Pulse vous montre chaque ajout avant de l'écrire. La mémoire est écrite en français, avec des mots que vous pouvez relire.

À chaque nouvelle session, l'IA a tout oublié : elle relit d'abord la mémoire du projet (vos choix, les mots du métier, les pièges), puis se met au travail sans tout redécouvrir. Vous y ajoutez une leçon avec retenir. Quand la mémoire est presque pleine (190 lignes sur 200), compacter la resserre autour de 140 lignes.

Pourquoi l'utiliser

Vous ne répétez plus les mêmes choses. Une règle dite une fois (« les prix s'affichent toujours TTC ») est rappelée à l'IA à chaque session.
L'IA parle votre langue. Le glossaire fixe les mots de votre métier : « prestation » plutôt que « service », par exemple.
Les erreurs ne reviennent pas. Un piège déjà rencontré est noté, et l'IA l'évite la fois suivante.
Vous gardez le contrôle. Chaque ligne vous est montrée avant d'être écrite.

Quand l'utiliser

1 Démarrer
2 Décrire
3 Préparer
4 Construire
5 Mettre en ligne
6 Être trouvé
7 À tout moment

Vous ajoutez Pulse à un projet qui a déjà du code : après /pulse:tech, qui décrit les outils du projet, creer note dans la mémoire les habitudes d'écriture et les pièges propres à votre code.
Vous voulez que l'IA se souvienne de quelque chose la prochaine fois : retenir.
Le projet a beaucoup changé depuis des semaines : actualiser repère ce qui est devenu faux.
Pulse vous dit que la mémoire est presque pleine : compacter.

Comment la lancer

/pulse:memory [creer | actualiser | compacter | retenir "leçon ou décision"]

Entre crochets [ ] : facultatif. Entre chevrons < > : à remplacer par votre valeur. La barre | sépare les choix possibles.

creer : la mémoire est absente, incomplète ou encore vide. Pulse lit vos documents, votre code et l'historique, crée les fichiers qui manquent et remplit ceux qui sont encore vides avec ce qu'il a appris. L'existant est gardé tel quel.
actualiser : Pulse compare la mémoire au projet réel et liste ce qui est faux, manquant ou en double. Vous choisissez les corrections à appliquer.
retenir suivi d'une phrase entre guillemets : une leçon, une habitude, un mot du métier ou une décision. Pulse choisit le bon fichier et vous montre la ligne exacte. Pour une habitude qu'on peut vérifier dans le code (« les montants s'écrivent en centimes »), Pulse peut lui ajouter un contrôle : un enregistrement qui ne la respecte pas est alors refusé, avec la règle citée. Une règle peut aussi prévoir une exception (« sauf dans ce fichier »). Les mêmes règles sont contrôlées quand un assistant rend la main, avant même l'enregistrement.
compacter : la mémoire approche de sa limite de 200 lignes. Un assistant la resserre autour de 140 lignes et la remet à jour.
Rien : sans mémoire, Pulse la crée. Sinon, il vous demande ce que vous voulez faire.

/pulse:memory retenir "un rendez-vous dure 30 minutes par défaut"

/pulse:memory actualiser

/pulse:memory compacter

Ce qu'elle produit

La mémoire vit dans le dossier aidd_docs/memory/ de votre projet :

Fichier ou dossier	À quoi il sert
`project.md`	Ce que fait l'appli, pour qui, ce qu'elle contient, et les décisions importantes. Relu à chaque session.
`technical.md`	Les outils choisis, les habitudes d'écriture du code, les pièges et leçons. Relu à chaque session.
`glossary.md`	Les mots de votre métier et leur définition commune. Relu à chaque session.
`README.md`	La présentation de la mémoire.
`internal/`, `external/`	Le détail rarement utile et les documents extérieurs, lus seulement quand une tâche en a besoin. Une décision difficile à défaire y a son propre fichier, dans `internal/decisions/`.

À la fin de chaque action, Pulse vérifie aussi que CLAUDE.md contient le bloc qui charge la mémoire, et l'ajoute s'il manque. À la prochaine session, l'IA chargera automatiquement ces fichiers.

Risques et précautions

Rien n'est écrit sans votre accord. Chaque ajout ou correction vous est montré, avec sa destination.
Vos secrets restent hors de la mémoire. Une clé, un mot de passe, le nom ou l'e-mail d'un vrai client ne s'y écrivent pas ; s'il en reste un, Pulse propose de le retirer en priorité.
Le compactage est réversible. Pulse vous montre les lignes avant et après, puis vous propose de garder la mémoire compactée ou de revenir à la version d'avant.

Problèmes et solutions

Pulse me dit que la mémoire est presque pleine

Elle approche de 200 lignes, et l'alerte arrive à 190. Lancez /pulse:memory compacter : le détail rare part dans des fichiers lus seulement au besoin, et l'essentiel reste chargé.

Le compactage refuse de démarrer

Des changements de la mémoire ne sont pas encore enregistrés. Lancez /pulse:commit, puis relancez /pulse:memory compacter.

Pulse refuse de retenir ce que je lui donne

La mémoire garde ce que le code ne montre pas : un choix et son pourquoi, une habitude, un piège. Une préférence passagère, une note de travail, une chose déjà visible dans le code ou un secret n'y ont pas leur place. Pulse vous explique pourquoi en une phrase.

Pulse me propose /pulse:init

Le fichier CLAUDE.md manque : c'est lui qui charge la mémoire. Lancez /pulse:init d'abord, puis revenez.

Ma nouvelle règle contredit une ancienne

Pulse le repère et propose de remplacer l'ancienne ligne. La mémoire décrit seulement l'état actuel du projet.

Exemples

/pulse:memory retenir "un rendez-vous dure 30 minutes par défaut"

C'est une règle de l'appli qui ne change pas : elle va dans la mémoire du projet, fichier project.md. Ligne proposée : « Un rendez-vous dure 30 minutes par défaut (2026-10-10). » → Ajouter (Recommandé) → Modifier → Abandonner

Ajouter

pulse-aidd memoire

C'est noté. À la prochaine session, l'IA chargera automatiquement ces fichiers. ➡️ Prochaine étape : la commande où vous en étiez (/pulse:status pour la retrouver).

/pulse:memory compacter

pulse-aidd agent memory-compactor

Mémoire : 192 lignes → 138 lignes. Retiré : 2 notes sur des tâches terminées. Déplacé : la procédure d'envoi des rappels, vers un fichier lu seulement au besoin. Resserré : la description des écrans. → Garder la mémoire compactée (Recommandé) → Voir le détail d'abord → Revenir à la version d'avant

Garder la mémoire compactée

➡️ Prochaine étape : /pulse:commit pour enregistrer la mémoire compactée.

Commandes liées

/pulse:init : crée la mémoire au démarrage du projet.
/pulse:fix : propose de noter un piège après une correction.
/pulse:commit : enregistrer la mémoire, avant et après un compactage.
/pulse:status : voir si la mémoire est branchée, et retrouver où vous en étiez.