Memlayer

MemLayer プラグイン

タスクの実行をまたいで学習内容を保持できる、Claude Code、Gemini CLI、およびCodex CLI向けの自己学習型メモリシステムです。 MemLayerと併用する必要があります。

概要

MemLayer は AI エージェントにエピソード記憶機能を提供し、次のことを可能にします。

• タスクの実行を記録し、結果、エラー、コンテキストをエピソードとして保存する
• 過去の経験、特に失敗からパターンを抽出する
• 実証済みの戦略を再利用可能なスキルに昇格させる
• 新しいタスクを開始する前に、関連するコンテキストを取得する
• 同じ間違いを繰り返さないよう、失敗から学習する

インストール

ワンコマンドインストーラー（curl）

対象プロジェクトのディレクトリで実行してください。

Gemini CLI

curl -fsSL https://raw.githubusercontent.com/shafty023/MemLayer-Plugin/main/install-gemini.sh | bash

Gemini プラグインをインストールし、.gemini/settings.jsonでmemlayer MCP を設定します。
続いて Gemini で/mcp auth memlayerを実行し、MCP のログインを完了してください。 デフォルトでは、インストーラーのチェックアウト参照先はmainです（MEMLAYER_REPO_REFで変更できます）。

Claude Code

curl -fsSL https://raw.githubusercontent.com/shafty023/MemLayer-Plugin/main/install-claude.sh | bash

プラグインマーケットプレイスを追加し、memory@ProcIQをインストールして、Claude でmemlayer MCP サーバーを設定します。

Codex CLI

curl -fsSL https://raw.githubusercontent.com/shafty023/MemLayer-Plugin/main/install-codex.sh | bash

memory-usageスキルを${CODEX_HOME:-~/.codex}/skillsにインストールし、現在のリポジトリのAGENTS.mdを更新して、MCP を設定します。また、明示的に実行するためのcodex mcp login memlayerの手順を表示します。 デフォルトでは、インストーラーのチェックアウト参照先はmainです（MEMLAYER_REPO_REFで変更できます）。

Claude Code

1. Claude Code にマーケットプレイスを追加します。

   /plugin marketplace add shafty023/MemLayer-Plugin
   

2. メモリプラグインをインストールします。

   /plugin install memory@ProcIQ
   

3. API キーを使って prociq MCP サーバーを設定します（設定方法はprociq.aiをご覧ください）。

プラグインのインストールについて詳しくは、公式ドキュメントをご覧ください。

Gemini CLI

インストールと設定の手順については、Gemini プラグインのドキュメントをご覧ください。

Codex CLI

インストールと設定の手順については、Codex プラグインのドキュメントをご覧ください。

プロジェクト構成

MemLayer-Plugin/
├── .claude-plugin/           # Claude marketplace registration
├── codex/                    # Codex CLI installer and policy template
│   ├── setup.sh
│   └── templates/
├── gemini/                   # Gemini CLI installer and manifest
│   ├── manifest.json
│   └── setup.sh
└── plugins/
    └── memory/               # Claude Code plugin and shared skill source
        ├── .claude-plugin/
        │   └── plugin.json   # Plugin manifest
        ├── commands/         # CLI commands
        │   ├── audit.md      # /memory:audit - inspect memory state
        │   ├── teach.md      # /memory:teach - inject knowledge manually
        │   └── forget.md     # /memory:forget - remove episodes
        ├── hooks/            # Integration hooks
        │   ├── hooks.json
        │   └── scripts/
        │       ├── session-start.sh
        │       └── user-prompt.sh
        └── skills/
            └── memory-usage/
                └── SKILL.md  # Canonical memory system usage guide

コマンド

/memory:audit [episodes|patterns|skills]

メモリシステムの現在の状態を確認します。統計情報、最近のエピソード、信頼度の高いパターン、スキルの一覧を表示します。

/memory:teach <lesson>

タスクを実行せずに、知識をメモリシステムに手動で追加します。

/memory:teach When using Detox with animations, always add explicit waitFor timeouts of at least 5000ms

/memory:forget <episode-id|query>

指定したエピソードをメモリから削除します。クエリで検索するか、ID を指定して削除できます。

中核となる概念

エピソード

タスクの実行を記録したもので、次の内容が含まれます。

• タスクの目標と実施したアプローチ
• 結果（成功／一部成功／失敗）
• 該当する場合はエラーの詳細
• 使用したツールと関連するファイルのパターン
• 重要度スコア（0.0～1.0）

パターン

複数のエピソードから抽出した学習内容です。

• 根本原因の分析
• 推奨される戦略
• トリガー条件（エラー、キーワード、ツール）

スキル

成熟度と信頼度の高いパターンを、関連するタスクが発生した際に提示される再利用可能な知識へと昇格させたものです。

ノート

エピソードとは異なり、時間が経っても劣化しない、永続的な自由形式の知識エントリーです。

• 忘れられるべきではない重要な発見を記録する
• プロジェクト固有の知識を文書化する
• /memory:teachコマンドで手動で教える
• 常に見つけられるようにしておくべき参考資料

統合

次の処理を自動的に行います。

• 類似するエピソードをクラスタリングする
• 失敗からパターンを抽出する
• 古いエピソードや価値の低いエピソードの重要度を下げる
• パターンをスキルに昇格させる

メモリツール（MCP）

エピソードツール

ツール	目的
prociq_log_episode	タスクの実行を記録します（非同期、ノンブロッキング）
prociq_retrieve_context	タスクの前に、関連する過去の経験を取得します
prociq_search_episodes	フィルター（outcome、error_type、project）を使って検索します
prociq_get_episode	ID を指定してエピソード全体を取得します
prociq_search_episodes_full	エピソード全体を返すセマンティック検索を行います
prociq_forget_episodes	エピソードを完全に削除します
prociq_archive_episode	エピソードをソフト削除します（元に戻せます）

ノートツール

ツール	目的
prociq_log_note	自由形式の永続的なナレッジを保存します
prociq_update_note	既存のノートを変更します
prociq_get_note	ID を指定してノートを取得します
prociq_search_notes	内容またはタグでノートを検索します
prociq_delete_note	ストレージからノートを削除します

パターン・スキルツール

ツール	目的
prociq_search_patterns	フィルターを使ってパターンを検索します
prociq_list_skills	利用可能なすべてのスキルを一覧表示します
prociq_get_skill_content	ID を指定してスキルの Markdown を取得します

システムツール

ツール	目的
prociq_get_memory_stats	メモリの健全性と統計を確認します
prociq_trigger_consolidation	メモリのメンテナンスを手動で実行します

ベストプラクティス

記録するタイミング

記録するもの:

• 失敗（再試行する前に必ず記録します）
• 調査が必要な、すぐにはわからない解決策
• 初めて取り組む種類のタスク
• 繰り返し発生する問題のカテゴリ（設定、デバッグ、統合）

記録しないもの:

• 些細な修正（誤字、インポート漏れ）
• 定型的な CRUD 操作
• 調査・探索のみを目的とするタスク

重要度スコア

シナリオ	スコア
通常の成功	0.2–0.3
初めて取り組む種類のタスク	0.5–0.6
新しいことを学んだ	0.7–0.8
重大な発見・失敗	0.9–1.0

重要なルール：失敗を先に記録する

再試行する前に、必ず失敗を記録してください。これにより、再試行に成功した後では失われてしまう正確なエラーのコンテキストを保存できます。

フックの仕組み

1. SessionStart — 利用可能なメモリツールについて Claude に通知します
2. UserPromptSubmit — メモリのワークフローを TodoWrite に挿入します（最初にメモリを確認し、最後に結果を記録します）
3. Stop — Claude に失敗の記録を促し、振り返りを提案します

ライセンス

MIT License — 詳細は LICENSE を参照してください。

作者

Daniel Ochoa (@shafty023)

リンク

• prociq.ai — メモリシステムのバックエンド
• Claude Code ドキュメント
• Gemini CLI ドキュメント
• Codex CLI ドキュメント