Rédiger des mémoires

Une mémoire est une courte note Markdown que votre équipe consigne pour que l'assistant puisse la lire plus tard. Les mémoires sont rattachées à un chemin de l'espace de travail et n'apparaissent que lorsque l'assistant travaille sous ce chemin. C'est le type de contenu le plus courant dans Pathrule, et le plus simple pour commencer.

Cette page explique quand rédiger une mémoire, comment la structurer, et comment fonctionnent la portée et le versionnement.

Quand rédiger une mémoire

Pensez à une mémoire dès que vous détenez une connaissance qui ne ressort pas du code et qui a de bonnes chances de resservir.

• Décisions. « Dans ce dépôt, nous utilisons Postgres sur Supabase pour tout. N'introduisez pas d'ORM. Utilisez directement le client supabase-js. »
• Pièges. « Si vous modifiez l'enum orders.status, vous devez lancer la migration de données avant la migration de schéma. L'ordre est inversé par rapport au reste du schéma. »
• Postmortems. « Le 2026-04-12, nous avons livré un gestionnaire de webhook qui débitait les clients deux fois, faute d'avoir vérifié la clé d'idempotence Stripe. Transmettez-la toujours désormais. »
• Conventions. « Les tests se trouvent à côté du fichier qu'ils testent, et non dans un répertoire __tests__ parallèle. »
• Savoir tacite. « Une seule personne se souvient de la raison d'être de ce flag. Il reste nécessaire à cause d'une particularité d'exécution en amont. »

Évitez les mémoires pour ce que le code dit déjà clairement, ce qui change chaque semaine ou ce qui relève purement de la préférence personnelle.

Structure

Chaque mémoire a un titre et un corps en Markdown. Gardez les deux courts.

• Titre : bref, affirmatif, tient dans une barre latérale. « Postgres uniquement. Pas d'ORM. » vaut mieux que « Notes sur les patterns d'accès à la base de données ».
• Corps : le minimum de Markdown nécessaire pour faire passer le message. Les puces sont généralement plus claires que des paragraphes. Ajoutez un exemple si cela aide.

Aucun modèle n'est imposé, mais voici un point de départ utile :

The constraint or fact in one sentence.

Why:
- The reason this matters or the incident that prompted it.

How to apply:
- The concrete thing the assistant should do when the topic comes up.

Portée par chemin

Le chemin compte pour moitié dans une mémoire : c'est lui qui détermine où elle apparaît.

• Une mémoire placée sur /apps/api/payments apparaît pour tout travail sous apps/api/payments.
• Une mémoire placée sur /apps/api apparaît pour l'ensemble du répertoire api.
• Une mémoire placée sur / apparaît partout dans l'espace de travail.

Choisissez le chemin le plus précis qui couvre encore les cas visés. Une mémoire sur les paiements placée au niveau de l'espace de travail ajoute du bruit partout ; mieux vaut la placer dans le dossier des paiements.

Versionnement et modifications simultanées

Chaque enregistrement est comparé à la version dont vous êtes parti. Si quelqu'un d'autre a enregistré entre-temps, votre enregistrement est refusé au lieu d'écraser le sien. Votre équipe est ainsi protégée contre deux personnes, ou une personne et un agent, qui s'écraseraient mutuellement sans le savoir.

• Dans Pathrule pour VS Code, une mémoire s'ouvre dans un onglet Markdown. Un enregistrement qui écraserait une modification plus récente d'un collègue propose Reload, Copy My Version & Reload (votre texte est d'abord copié dans le presse-papiers) ou Keep Mine (Overwrite).
• Via MCP, l'assistant peut transmettre la dernière version qu'il a lue. En cas de divergence, il reçoit un conflit accompagné de la version actuelle, relit la mémoire et fusionne au lieu d'écraser.

La suppression est elle aussi réversible. Dans VS Code, une suppression propose immédiatement Undo, et dans un espace de travail Pathrule Cloud, une mémoire supprimée reste dans l'archive de l'espace de travail jusqu'à sa suppression définitive ; un propriétaire ou un administrateur peut la restaurer depuis les paramètres de la console web (Workspace, Archive) ou la supprimer pour de bon. En pratique, les conflits sont rares, car les mémoires sont en général courtes et ciblées, mais ce filet de sécurité est toujours actif.

Qui les rédige

• Les personnes, dans Pathrule pour VS Code (New Memory… ou Save Selection as Memory) ou avec le CLI.
• L'assistant, via l'outil MCP pathrule_write_memory lorsque vous lui demandez d'enregistrer quelque chose. Lors de la configuration, il propose des mémoires, des règles et des skills pour le projet, et n'écrit que les éléments que vous approuvez.

Depuis le terminal, une mémoire tient en une commande. Sans --body, le CLI ouvre votre éditeur pour saisir le corps ; vous pouvez aussi passer --body ou envoyer le texte par un pipe. pathrule memory list et pathrule memory read "Exact title" --print permettent de relire les mémoires.

pathrule memory add --path /apps/api/payments --title "Always pass the Stripe idempotency key"

Les deux sources aboutissent au même endroit. L'assistant lit ce qu'une personne a écrit, et une personne lit ce que l'assistant a écrit. Chaque enregistrement conserve son auteur, l'auteur de la dernière modification et sa source, ce qu'affiche l'action Info dans VS Code ; les mémoires rédigées par l'IA sont donc faciles à repérer.

Comment la qualité des mémoires reste vérifiable

Pathrule maintient chaque mémoire ciblée et inspectable grâce à plusieurs contrôles indépendants :

• La documentation générale est proposée pendant la configuration plutôt qu'importée automatiquement. Les fichiers d'instructions actifs, leur chaîne d'import, les règles des outils et les enregistrements de décisions apportent une preuve plus solide qu'il s'agit de connaissances en vigueur.
• Un agent doit proposer une connaissance durable avant de l'enregistrer. Tout ce qu'il enregistre est attribué, versionné et visible dans l'espace de travail comme n'importe quel autre élément : vous pouvez donc l'ouvrir, le modifier ou le supprimer.
• La portée par chemin limite les endroits où une entrée peut apparaître, et une entrée située hors du chemin courant doit tout de même franchir le seuil de pertinence.
• L'utilisation mesurée peut réordonner les entrées qui se qualifient, mais elle ne peut pas faire passer une mémoire sans rapport au-dessus de ce seuil.
• Un agent qui remarque qu'une mémoire s'est écartée du code peut la signaler comme tâche d'actualisation, qu'un assistant reprendra ensuite pour la corriger sous votre contrôle. Voir Suggestions et auto-audit. Les modifications sont versionnées et la suppression est réversible.
• Une nouvelle mémoire dont le titre correspond à une mémoire existante sur le même chemin est refusée par défaut au lieu d'être enregistrée en double ; une même décision n'est ainsi ni transmise deux fois, ni laissée diverger. Vous pouvez passer outre délibérément (--allow-duplicate dans le CLI) après avoir vérifié l'entrée existante.

Le modèle de fonctionnement qui en résulte est un petit ensemble de décisions et de pièges ciblés et vérifiables, et non une vaste archive copiée dans l'espace de travail. Consultez Comment Pathrule démontre ses affirmations les plus exigeantes pour le contrat technique complet.

Lire ou citer

Les mémoires les plus pertinentes arrivent avec leur corps complet, sur lequel l'assistant peut agir directement. Les candidates moins sûres arrivent sous forme de titres accompagnés d'identifiants ; l'assistant en lit une en entier avec pathrule_read_memory avant de s'y fier. Les éléments incertains restent ainsi hors du contenu transmis par défaut, sans que les correspondances solides ne coûtent d'allers-retours supplémentaires.

Dans VS Code, Browse Knowledge Here… montre ce que reçoit une session IA sur un chemin donné, y compris ce qu'elle hérite des chemins parents.

Pièges à éviter

• Une seule mémoire géante « toutes mes notes ». Découpez par sujet et par portée. Court et lié à un chemin l'emporte toujours sur long et global.
• Des mémoires qui répètent le code. L'assistant sait lire le code. Réservez les mémoires au pourquoi et aux pièges.
• Des mémoires obsolètes. Mettez-les à jour ou supprimez-les lorsque la décision sous-jacente change. Un assistant peut signaler une mémoire dépassée comme tâche d'actualisation, mais un œil humain va plus vite.

Rédaction en local et dans le Cloud

Les exemples add en terminal de cette page concernent un espace de travail Cloud. En mode local, créez et modifiez les entrées dans Local Console, dans VS Code ou via le MCP local ; les commandes de connaissances du CLI permettent de les lister, de les lire et de les rechercher.

Pour aller plus loin

• Rédiger des règles pour les contraintes avec priorité.
• Rédiger des skills pour les procédures réutilisables.
• Concepts clés pour l'arborescence de l'espace de travail à laquelle ces éléments se rattachent.