shared-memory

shared-memory

Une mémoire d'équipe partagée par projet, pour Claude Code. Ce que tu apprends à Claude ne reste plus prisonnier de ta machine : toute l'équipe — devs et vibe coders — partage une seule source de vérité par projet, sans application séparée.

---

Le problème

La mémoire native de Claude Code vit dans ~/.claude/projects/<slug>/memory/ : locale à chaque machine, hors du dépôt, jamais synchronisée. Chaque Claude construit son savoir en silo. Les décisions, conventions et chantiers découverts ne circulent pas dans l'équipe.

shared-memory branche cette mémoire native, par un simple symlink, sur un vault git privé (un par équipe). Dès lors, lire et écrire de la mémoire passe par une source commune, gouvernée par revue de branche git — le tout dans Claude Code, que tout le monde a déjà.

Comment ça marche

flowchart LR
  PLUGIN["Plugin shared-memory<br/>(public, aucun secret)"] -. installé une fois .-> CC
  subgraph poste["Poste de chaque membre"]
    CC["Claude Code<br/>skills /memory-*"] --> MEM["~/.claude/projects/&lt;slug&gt;/memory"]
    MEM -. symlink .-> CLONE["clone local du vault"]
  end
  CLONE <-->|git pull / push validé| VAULT[("Vault git privé<br/>un par projet — privé à l'équipe")]

Repo	Contenu	Visibilité
plugin (ce repo)	l'outil : skills, viewer, scripts	public (aucun secret)
vault (un par équipe)	la mémoire : MEMORY.md + faits .md	privé à l'équipe

La mémoire reste de simples fichiers .md (frontmatter + corps + liens [[wikilink]]) — c'est ce qui rend le partage possible : git fait la synchro, l'historique et les conflits ; on ne réécrit aucun outil de sync.

Ce qui est automatique (zéro effort au quotidien)

L'outil est conçu pour ne pas être chronophage : tu écris la mémoire, le reste se déclenche tout seul.

• Rappel au démarrage (digest) — à l'ouverture d'une session, Claude reçoit un résumé d'une ligne par fait (groupé par domaine). Il sait ce que l'équipe a appris et relit le fait quand le sujet arrive, sans que tu aies à le lui demander. Borné : sur un gros vault, le digest retombe sur la carte des domaines + la recherche.
• Synchro au démarrage — le vault est mis à jour (git pull) automatiquement ; tu repars toujours du savoir le plus récent de l'équipe.
• Rappel de promotion — en fin de session (et au démarrage), Claude te signale les faits locaux non encore partagés, pour lancer /memory-promote au bon moment.
• Fraîcheur signalée — les faits trop vieux (≥ 90 j) sont marqués ⚠ : la confiance ne s'érode pas en silence.

Véracité préservée : le digest et la recherche aiguillent ; Claude relit toujours le fait (la source) avant d'affirmer. Le gain de temps ne se paie pas en approximations.

Et côté tokens ?

Tout ce coût est payé une fois au démarrage, jamais par message — et il est borné. Mesure réelle sur un vault de 9 faits / 5 domaines (tokenizer cl100k en proxy, ordre de grandeur représentatif) :

Artefact injecté au démarrage	tokens
Digest des faits (~30–60 / fait selon la verbosité des descriptions)	~520
Schéma de l'outil search_memory (MCP, fixe)	~185
Rappels hook (synchro / promotion)	~55
Carte MEMORY.md	~375 (déjà chargée nativement)
Surcoût réel vs mémoire native (digest + MCP + hook)	~760
Coût par message	0

Le plafond (max_lines = 120 faits) garde le démarrage borné : au-delà, le digest bascule en mode dégradé (domaines + comptes + renvoi vers la recherche), et MEMORY.md ne liste que des domaines — le coût ne croît pas avec la taille du vault. Les corps de faits ne sont jamais chargés en masse : Claude lit un fait (~100–500 tokens) seulement quand le sujet tombe.

En face, ce surcoût remplace des dépenses récurrentes et bien plus lourdes : ré-expliquer le contexte à chaque session, faire re-découvrir à Claude ce que l'équipe sait déjà, corriger des affirmations sans source. Le rapport est favorable dès qu'une session réutilise un seul fait.

Astuce coût : des descriptions d'une ligne (≈ 15 mots) gardent le digest léger. La description est l'aiguillage — pas un résumé du fait.

La boucle de gouvernance (deux étages)

Rien ne devient « officiel » sans une revue par un référent — la garantie qualité, surtout avec des contributeurs nombreux.