/ ディレクトリ / プレイグラウンド / project-memory
● コミュニティ SpillwaveSolutions ⚡ 即起動

project-memory

作者 SpillwaveSolutions · SpillwaveSolutions/project-memory

人間が読める 4 つのファイル (bugs.md、decisions.md、key_facts.md、issues.md) は、クロードが変更を提案する前に読みます。 データベースのないプロジェクトのメモリ。

project-memory は、docs/project_notes/ に 4 つの軽量ノートをインストールし、アーキテクチャを変更する前にそれらを参照するようにクロードに教えるクロード コードのスキルです。 メモリ バンク MCP とは異なり、PR で確認するのはプレーン ファイルです。bugs.md は予防戦略を備えたエラー パターンをキャプチャし、decisions.md は ADR ログ、key_facts.md は機密性のない設定を保持し、issues.md は作業ログです。 グローバル、プロジェクトごと、またはワークスペースごとにインストール可能。

なぜ使うのか

主な機能

ライブデモ

実際の動作

project-memory-skill.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/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
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.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 は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"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
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

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

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "project-memory-skill": {
      "command": {
        "path": "pip",
        "args": [
          "install",
          "skilz",
          "&&",
          "skilz",
          "install",
          "SpillwaveSolutions_project-memory/project-memory"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

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

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: project-memory

既存のコードベースでプロジェクト メモリをブートストラップする

👤 チームはエージェントに同じ内容を再度説明することにうんざりしている ⏱ ~15 min beginner

使うタイミング: このリポジトリでは Claude Code を使用していますが、セッションごとにコンテキストがリセットされます。

前提条件
  • Skillz インストーラー用 Python 3.10+ — pyenv またはシステム Python
フロー
  1. プロジェクトスコープでインストールする
    pip install skillz && skillz install SpillwaveSolutions_project-memory/project-memory --scope プロジェクト✓ コピーしました
    → .claude/skills/project-memory/SKILL.mdが表示されます
  2. ブートストラップコマンドを実行する
    /project-memory — このリポジトリの 4 つのファイルを初期化します。✓ コピーしました
    → docs/project_notes/ 4 つの正規ファイルで作成
  3. 2 ~ 3 つの既知の選択肢を含むシード決定.md
    ORM の選択、エラー処理規約、CI ランナーに ADR を追加します。✓ コピーしました
    → 3 つのきちんとした ADR エントリ

結果: クロードは現在、このリポジトリに対して永続的でレビュー可能な頭脳を持っています。

注意点
  • シークレットを使用して key_facts.md をコミットする — このスキルは key_facts.md に「非機密」として明示的にフラグを立てます。そこに資格情報を決して置かないでください。
組み合わせ: memory-bank-mcp

バグの根本原因を捕らえてバグが再発しないようにする

👤 オンコールエンジニアが火災を鎮火 ⏱ ~5 min beginner

使うタイミング: 難しい問題を修正したばかりで、レッスンを永続的にしたいと考えています。

フロー
  1. クロードに録音してもらう
    これを bugs.md に追加します。エラーは billing.retry の NoneType でした。 根本原因: 冪等性キー キャッシュが古い。 防止: キャッシュ上の TTL。✓ コピーしました
    → 根本原因と予防策を含む新しい bugs.md エントリ

結果: 次回同様の症状が現れたときに役立つバグ カタログ。

注意点
  • 原因ではなく症状を書く — エントリに「修正した内容」だけでなく「根本原因」と「予防策」セクションを強制的に含める
組み合わせ: github

リファクタリングを提案する前に、Claude に Decisions.md を参照してもらいます。

👤 解決済みの選択をエージェントと再度訴訟することを嫌うチーム ⏱ ~10 min beginner

使うタイミング: エージェントは、チームがすでにノーと言っていたフレームワークやパターンを提案し続けます。

フロー
  1. 決定が Decisions.md にあることを確認してください。
    レコード: 'アクティブ レコードではなく、リポジトリ パターンを使用します。 根拠: <x>。✓ コピーしました
    → Decision.md で ADR をクリアする
  2. リファクタリングを依頼する
    src/billing/ のリファクタリングを提案します — 私たちの決定を尊重します.md。✓ コピーしました
    → 提案はリポジトリの決定を参照しており、アクティブ レコードを提案していません。

結果: レビューで拒否される行き止まりの提案が少なくなります。

組み合わせ: git

組み合わせ

他のMCPと組み合わせて10倍の力を

project-memory-skill + memory-bank-mcp

厳選された正規の 4 つのファイルには project-memory を使用し、プロジェクト全体にわたる自由形式の作業メモリにはmemory-bank-mcp を使用します。

構造化された ADR を Decision.md に書き込みます。 生のセッションノートをメモリバンクにダンプします。✓ コピーしました
project-memory-skill + github

PR をマージした後、PR の説明の一部として Decision.md と issues.md を更新します。

PR を開き、説明に Decision.md diff を含めます。✓ コピーしました
project-memory-skill + git

正直さを保つためにコミットする前にメモリの差分を確認してください

git diff docs/project_notes/ — コミットする前に読んでください。 誤解を招くものは修正してください。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
/project-memory subcommand: init|add-bug|add-decision|add-fact|log-issue ファイルをブートストラップして新しいエントリを記録する 0

コストと制限

運用コスト

APIクォータ
なし
呼び出しあたりのトークン
クロードがロードする 4 つのファイルの量によって異なります。 エントリを短くする
金額
無料
ヒント
長い物語よりも、日付が記載された短いエントリを好みます。クロードはセッションごとにエントリに目を通すため、サイズが重要です。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: 明示的に: key_facts.md は非機密構成専用です。 シークレットはここではなく、env または Vault に保管してください。
データ送信先: ローカルファイル。 スキル自体からのネットワークアクティビティはありません

トラブルシューティング

よくあるエラーと対処法

/project-memory コマンドが認識されません

スキルが予期されたスコープにインストールされていません。 skillz で再インストールし、Claude を再起動します。

確認: ls ~/.claude/skills/project-memory/ or .claude/skills/project-memory/
クロードは決定を無視する.md

Decision.md に「Decision」ヘッダーと「Rationale」ヘッダーを持つ明確な ADR スタイルのエントリがあることを確認します。 曖昧な箇条書きは流し読みされます。

確認: head docs/project_notes/decisions.md
ファイルは増え続ける

四半期ごとにアーカイブする — 古いエントリを docs/project_notes/archive/ に移動して、アクティブなファイルをスキャン可能な状態に保ちます。

確認: wc -l docs/project_notes/*.md

代替案

project-memory 他との比較

代替案代わりに使う場面トレードオフ
memory-bank-mcpファイルではなくツールからプロジェクト間メモリにアクセスできるようにしたい柔軟性が向上し、PR レビューでは目立たなくなります
codebase-memory説明的なメモではなく、コードのシンボルグラフが必要です記憶の異なる層
marm-systemsより精巧なメモリ フレームワークが必要な場合より重いセットアップ

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る