project-memory MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Canon à quatre fichiers : bugs.md, décisions.md, key_facts.md, issues.md
Claude les lit avant de proposer des modifications architecturales
Trois étendues d'installation : globale (~/.claude/skills), projet (.claude/skills), espace de travail
Installable via Skilz (pip) ou copie simple
Pas de base de données - juste Markdown, vous pouvez comparer et réviser

Démo en direct

Aperçu en pratique

project-memory-skill.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "project-memory-skill",
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "project-memory-skill": {
      "command": {
        "path": "pip",
        "args": [
          "install",
          "skilz",
          "&&",
          "skilz",
          "install",
          "SpillwaveSolutions_project-memory/project-memory"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add project-memory-skill -- pip install skilz && skilz install SpillwaveSolutions_project-memory/project-memory

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : project-memory

Amorcer la mémoire du projet sur une base de code existante

👤 Les équipes fatiguées de réexpliquer le même contexte à leur agent ⏱ ~15 min beginner

Quand l'utiliser : Vous avez utilisé Claude Code sur ce dépôt mais le contexte est réinitialisé à chaque session.

Prérequis

Python 3.10+ pour l'installateur Skilz — pyenv ou système Python

Déroulement

Installer à la portée du projet

pip install Skilz && Skilz install SpillwaveSolutions_project-memory/project-memory --scope project✓ Copié

→ .claude/skills/project-memory/SKILL.md apparaît
Exécutez la commande bootstrap

/project-memory — initialise les quatre fichiers de ce dépôt.✓ Copié

→ docs/project_notes/ créé avec les quatre fichiers canoniques
Seed Decisions.md avec 2 à 3 choix connus

Ajoutez des ADR pour notre choix ORM, notre convention de gestion des erreurs et notre exécuteur CI.✓ Copié

→ Trois entrées ADR bien rangées

Résultat : Claude dispose désormais d'un cerveau persistant et révisable pour ce dépôt.

Pièges

Valider key_facts.md avec des secrets — La compétence marque explicitement key_facts.md comme « non sensible » – n'y mettez jamais d'informations d'identification.

Combiner avec : memory-bank-mcp

Capturez la cause première d'un bug pour qu'il ne revienne jamais

👤 Des ingénieurs de garde éteignent un incendie ⏱ ~5 min beginner

Quand l'utiliser : Vous venez de réparer quelque chose de délicat et vous voulez que la leçon dure.

Déroulement

Demandez à Claude de l'enregistrer

Ajoutez ceci à bugs.md - l'erreur était NoneType dans billing.retry ; cause première : cache de clé d'idempotence obsolète ; prévention : TTL sur le cache.✓ Copié

→ Nouvelle entrée bugs.md avec cause première + prévention

Résultat : Un catalogue de bogues qui rapporte des dividendes la prochaine fois qu'un symptôme similaire apparaît.

Pièges

Écrire le symptôme plutôt que la cause — Forcer l'entrée à avoir une section « Cause première » et « Prévention » - pas seulement « ce que j'ai corrigé »

Combiner avec : github

Laisser Claude consulter Decisions.md avant de suggérer un refactor

👤 Les équipes qui détestent remettre en cause des choix réglés avec leur agent ⏱ ~10 min beginner

Quand l'utiliser : Votre agent continue de proposer des cadres/modèles auxquels l'équipe a déjà dit non.

Déroulement

Assurez-vous que la décision est dans Decisions.md

Record : « Nous utilisons le modèle Repository, pas Active Record. Justification : <x>.'✓ Copié

→ Effacer l'ADR dans les décisions.md
Demandez le refactor

Proposer un refactor de src/billing/ — respecter nos décisions.md.✓ Copié

→ La proposition fait référence à la décision relative au référentiel et ne suggère pas d'enregistrement actif

Résultat : Moins de propositions sans issue qui sont rejetées lors de l'examen.

Combiner avec : git

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

project-memory-skill + memory-bank-mcp

Utilisez la mémoire de projet pour les quatre fichiers canoniques sélectionnés, la banque de mémoire-mcp pour la mémoire de travail de forme libre dans tous les projets

Écrire des ADR structurés dans Decisions.md ; vider les notes brutes de la session dans la banque de mémoire.✓ Copié

project-memory-skill + github

Après avoir fusionné un PR, mettez à jour Decisions.md et Issues.md dans le cadre de la description du PR.

Ouvrez le PR et incluez le diff décisions.md dans la description.✓ Copié

project-memory-skill + git

Examinez les différences de mémoire avant de vous engager à les garder honnêtes

git diff docs/project_notes/ — à lire avant de s'engager ; corrigez tout ce qui est trompeur.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
/project-memory	subcommand: init\|add-bug\|add-decision\|add-fact\|log-issue	Démarrez les fichiers et enregistrez de nouvelles entrées	0

Coût et limites

Coût d'exécution

Quota d'API: Aucune
Tokens par appel: Cela dépend de la quantité de quatre fichiers que Claude charge ; garder les entrées courtes
Monétaire: Gratuite
Astuce: Préférez les entrées courtes et datées aux longs récits – Claude les scanne à chaque session, donc la taille compte.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Explicitement : key_facts.md est uniquement destiné aux configurations non sensibles. Gardez les secrets dans un environnement ou un coffre-fort, pas ici.

Sortie de données : Fichiers locaux ; aucune activité réseau de la compétence elle-même

Si vous validez docs/project_notes/ dans un dépôt public, n'oubliez pas que Claude a peut-être enregistré des détails internes – vérifiez-les avant de les publier.
Ne laissez pas les agents s'ajouter automatiquement à Decisions.md sans examen ; c’est là que le contexte obsolète ou erroné ronge l’ensemble du système.

Dépannage

Erreurs courantes et correctifs

/commande project-memory non reconnue

Compétence non installée à la portée attendue. Réinstallez avec Skilz et redémarrez Claude.

Vérifier : ls ~/.claude/skills/project-memory/ or .claude/skills/project-memory/

Claude ignore les décisions.md

Assurez-vous que le fichier Decisions.md comporte des entrées claires de style ADR avec les en-têtes « Décision » et « Justification » ; de vagues puces sont survolées.

Vérifier : head docs/project_notes/decisions.md

Les fichiers continuent de croître

Archivez tous les trimestres : déplacez les anciennes entrées vers docs/project_notes/archive/ afin que les fichiers actifs restent analysables.

Vérifier : wc -l docs/project_notes/*.md

Alternatives

project-memory vs autres

Alternative	Quand l'utiliser	Compromis
memory-bank-mcp	Vous voulez une mémoire inter-projets accessible par outil, pas par fichiers	Plus de flexibilité, moins visible dans les revues de relations publiques
codebase-memory	Vous voulez un graphique de symboles du code, pas des notes narratives	Différente couche de mémoire
marm-systems	Vous voulez un cadre de mémoire plus élaboré	Configuration plus lourde

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills