project-memory MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Vier-Dateien-Kanon: bugs.md, Decisions.md, key_facts.md, issues.md
Claude liest sie, bevor er architektonische Änderungen vorschlägt
Drei Installationsbereiche: global (~/.claude/skills), Projekt (.claude/skills), Arbeitsbereich
Installierbar über Skilz (Pip) oder einfache Kopie
Keine Datenbank – nur Markdown, den Sie vergleichen und überprüfen können

Live-Demo

In der Praxis

project-memory-skill.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren 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
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.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 nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die 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
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "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
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

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

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: project-memory

Bootstrap-Projektspeicher auf einer vorhandenen Codebasis

👤 Teams sind es leid, ihrem Agenten immer wieder denselben Kontext zu erklären ⏱ ~15 min beginner

Wann einsetzen: Sie haben Claude Code in diesem Repo verwendet, aber der Kontext setzt jede Sitzung zurück.

Voraussetzungen

Python 3.10+ für das Skilz-Installationsprogramm — pyenv oder System-Python

Ablauf

Im Projektumfang installieren

pip install skilz && skilz install SpillwaveSolutions_project-memory/project-memory --scope Projekt✓ Kopiert

→ .claude/skills/project-memory/SKILL.md erscheint
Führen Sie den Bootstrap-Befehl aus

/project-memory – initialisiert die vier Dateien für dieses Repo.✓ Kopiert

→ docs/project_notes/ erstellt mit den vier kanonischen Dateien
Seed-entscheidungen.md mit 2–3 bekannten Auswahlmöglichkeiten

Fügen Sie ADRs für unsere ORM-Auswahl, unsere Fehlerbehandlungskonvention und unseren CI-Runner hinzu.✓ Kopiert

→ Drei ordentliche ADR-Einträge

Ergebnis: Claude verfügt nun über ein beständiges, überprüfbares Gehirn für dieses Repo.

Fallstricke

key_facts.md mit Geheimnissen begehen — Der Skill kennzeichnet key_facts.md explizit als „nicht sensibel“ – geben Sie dort niemals Anmeldeinformationen ein

Kombinieren mit: memory-bank-mcp

Erfassen Sie die Grundursache eines Fehlers, damit dieser nie wieder auftritt

👤 Bereitschaftsdienstkräfte löschen einen Brand ⏱ ~5 min beginner

Wann einsetzen: Sie haben gerade etwas Kniffliges behoben und möchten, dass die Lektion dauerhaft bleibt.

Ablauf

Bitten Sie Claude, es aufzunehmen

Fügen Sie dies zu bugs.md hinzu – Fehler war NoneType in billing.retry; Grundursache: veralteter Idempotenzschlüssel-Cache; Prävention: TTL im Cache.✓ Kopiert

→ Neuer bugs.md-Eintrag mit Grundursache + Prävention

Ergebnis: Ein Fehlerkatalog, der sich beim nächsten Auftreten eines ähnlichen Symptoms auszahlt.

Fallstricke

Schreiben Sie das Symptom statt die Ursache — Erzwingen Sie, dass der Eintrag einen Abschnitt „Ursache“ und „Prävention“ enthält – nicht nur „Was ich behoben habe“.

Kombinieren mit: github

Lassen Sie Claude Decisions.md konsultieren, bevor Sie eine Umgestaltung vorschlagen

👤 Teams, die es hassen, entschiedene Entscheidungen erneut mit ihrem Agenten zu verhandeln ⏱ ~10 min beginner

Wann einsetzen: Ihr Agent schlägt ständig Frameworks/Muster vor, zu denen das Team bereits Nein gesagt hat.

Ablauf

Stellen Sie sicher, dass die Entscheidung in „entscheidungen.md“ enthalten ist

Datensatz: „Wir verwenden das Repository-Muster, nicht den aktiven Datensatz.“ Begründung: <x>.'✓ Kopiert

→ ADR in „entscheidungen.md“ löschen
Fragen Sie nach dem Refactor

Schlagen Sie eine Umgestaltung von src/billing/ vor – respektieren Sie unsere Entscheidungen.md.✓ Kopiert

→ Der Vorschlag verweist auf die Repository-Entscheidung und schlägt keinen aktiven Datensatz vor

Ergebnis: Weniger Sackgassenvorschläge, die bei der Prüfung abgelehnt werden.

Kombinieren mit: git

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

project-memory-skill + memory-bank-mcp

Verwenden Sie „project-memory“ für die kuratierten kanonischen vier Dateien, „memory-bank-mcp“ für projektübergreifenden Arbeitsspeicher in freier Form

Schreiben Sie strukturierte ADRs in „entscheidungen.md“; Legen Sie rohe Sitzungsnotizen in der Speicherbank ab.✓ Kopiert

project-memory-skill + github

Aktualisieren Sie nach dem Zusammenführen einer PR die Dateien „entscheidungen.md“ und „issues.md“ als Teil der PR-Beschreibung

Öffnen Sie die PR und fügen Sie den Decisions.md-Diff in die Beschreibung ein.✓ Kopiert

project-memory-skill + git

Überprüfen Sie die Unterschiede im Gedächtnis, bevor Sie sich dazu verpflichten, sie ehrlich zu halten

git diff docs/project_notes/ – vor dem Festschreiben lesen; Korrigieren Sie alles, was irreführend ist.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
/project-memory	subcommand: init\|add-bug\|add-decision\|add-fact\|log-issue	Laden Sie die Dateien hoch und zeichnen Sie neue Einträge auf	0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Keiner
Tokens pro Aufruf: Hängt davon ab, wie viele der vier Dateien Claude lädt; Halten Sie die Einträge kurz
Kosten in €: Frei
Tipp: Bevorzugen Sie kurze, veraltete Einträge gegenüber langen Erzählungen – Claude scannt sie in jeder Sitzung, daher kommt es auf die Größe an.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Ausdrücklich: key_facts.md ist nur für nicht sensible Konfigurationen vorgesehen. Bewahren Sie Geheimnisse in einer Umgebung oder einem Tresor auf, nicht hier.

Datenabfluss: Lokale Dateien; Keine Netzwerkaktivität vom Skill selbst

Wenn Sie docs/project_notes/ in ein öffentliches Repository übertragen, denken Sie daran, dass Claude möglicherweise interne Details aufgezeichnet hat – überprüfen Sie diese, bevor Sie sie veröffentlichen.
Lassen Sie nicht zu, dass Agenten ohne Überprüfung automatisch an „entscheidungen.md“ anhängen. Hier korrodiert veralteter oder falscher Kontext das gesamte System.

Fehlerbehebung

Häufige Fehler und Lösungen

/project-memory-Befehl nicht erkannt

Der Skill wurde nicht im erwarteten Umfang installiert. Mit skilz neu installieren und Claude neu starten.

Prüfen: ls ~/.claude/skills/project-memory/ or .claude/skills/project-memory/

Claude ignoriert Entscheidungen.md

Stellen Sie sicher, dass „entscheidungen.md“ über klare Einträge im ADR-Stil mit den Überschriften „Decision“ und „Rationale“ verfügt. vage Aufzählungspunkte werden überflogen.

Prüfen: head docs/project_notes/decisions.md

Die Dateien wachsen ständig

Vierteljährlich archivieren – alte Einträge nach docs/project_notes/archive/ verschieben, damit die aktiven Dateien weiterhin gescannt werden können.

Prüfen: wc -l docs/project_notes/*.md

Alternativen

project-memory vs. andere

Alternative	Wann stattdessen	Kompromiss
memory-bank-mcp	Sie möchten projektübergreifenden Speicher, auf den über ein Tool und nicht über Dateien zugegriffen werden kann	Mehr Flexibilität, weniger sichtbar in PR-Bewertungen
codebase-memory	Sie möchten ein Symboldiagramm des Codes, keine narrativen Notizen	Andere Speicherschicht
marm-systems	Sie möchten ein ausgefeilteres Speicher-Framework	Schwereres Setup

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen