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

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

project-memory (Claude Skill) — インストール & ライブデモ

なぜ使うのか

主な機能

4 つのファイルのカノン: bugs.md、decisions.md、key_facts.md、issues.md
クロードはアーキテクチャの変更を提案する前にそれらを読みます
Skillz (pip) またはプレーンコピー経由でインストール可能
データベースなし - Markdown だけで差分とレビューが可能

ライブデモ

実際の動作

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

0/0

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

実用的な使い方： project-memory

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

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

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

前提条件

Skillz インストーラー用 Python 3.10+ — pyenv またはシステム Python

フロー

プロジェクトスコープでインストールする

pip install skillz && skillz install SpillwaveSolutions_project-memory/project-memory --scope プロジェクト✓ コピーしました

→ .claude/skills/project-memory/SKILL.mdが表示されます
ブートストラップコマンドを実行する

/project-memory — このリポジトリの 4 つのファイルを初期化します。✓ コピーしました

→ docs/project_notes/ 4 つの正規ファイルで作成
2 ～ 3 つの既知の選択肢を含むシード決定.md

ORM の選択、エラー処理規約、CI ランナーに ADR を追加します。✓ コピーしました

→ 3 つのきちんとした ADR エントリ

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

注意点

シークレットを使用して key_facts.md をコミットする — このスキルは key_facts.md に「非機密」として明示的にフラグを立てます。そこに資格情報を決して置かないでください。

組み合わせ： memory-bank-mcp

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

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

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

フロー

クロードに録音してもらう

これを bugs.md に追加します。エラーは billing.retry の NoneType でした。根本原因: 冪等性キーキャッシュが古い。防止: キャッシュ上の TTL。✓ コピーしました

→ 根本原因と予防策を含む新しい bugs.md エントリ

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

注意点

原因ではなく症状を書く — エントリに「修正した内容」だけでなく「根本原因」と「予防策」セクションを強制的に含める

組み合わせ： github

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

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

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

フロー

決定が Decisions.md にあることを確認してください。

レコード: 'アクティブレコードではなく、リポジトリパターンを使用します。根拠: <x>。✓ コピーしました

→ Decision.md で ADR をクリアする
リファクタリングを依頼する

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 に保管してください。

データ送信先： ローカルファイル。スキル自体からのネットワークアクティビティはありません

docs/project_notes/ をパブリックリポジトリにコミットする場合は、Claude が内部の詳細を記録している可能性があることを覚えておいてください。プッシュする前に確認してください。
エージェントが確認せずに自動的に Decisions.md に追加することを許可しないでください。そこは、古いコンテキストや間違ったコンテキストがシステム全体を腐食させる場所です。

トラブルシューティング

よくあるエラーと対処法

クロードは決定を無視する.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を見る