
MadoHub に永続記憶(Memory)を持たせる:設計思想と人間による検証ゲート
MadoHub の長期メモリシステムの内部構造を解剖します:6 つの厳格なメモリ種別、ペルソナとワークスペースによる名前空間分離、そして「人間が承認しない限り、記憶は決して永続化されない」という防衛ライン。
従来の AI エージェントセッションは、そのほとんどが白紙の状態で始まります。月曜日に Claude Code へ「このプロジェクトでは npm ではなく pnpm を厳格に使用する」と伝えたとしても、木曜日に新しいセッションを開いたときにはその重要な取り決めは失われています。毎回同じ指示を手動で再入力するか、何らかの基盤が代わりに記憶を保持してくれない限り。
その「基盤」こそが、私たちが MadoHub に実装した単一のチャット履歴を超えて生き続ける長期メモリ(Memory)システムです。この仕組みによって、エージェントは過去の経験を蓄積し、セッションやプロジェクトをまたいで正しく引き継ぐことが可能になります。
本稿では、このメモリシステムの設計思想と、その中心にある最も重要な判断について解説します。すなわち、**「モデルが自動抽出した記憶の候補は、人間が明示的に承認するまで、決して本物の永続記憶にはならない」**という鉄則です。
MadoHub の設計アプローチ
1. 6 つの厳密なメモリ種別(Kind)
自由形式の曖昧なタグによるデータの劣化を防ぐため、MadoHub のメモリエントリは以下の 6 種類に厳格に分類されます。
| 種別 (Kind) | 役割と位置づけ | 典型例 |
|---|---|---|
preference | 確認済みのユーザーの好み・作業スタイル | 「コード中心の簡潔な回答を好む」 |
fact | プロジェクトに関する客観的かつ検証可能な事実 | 「バックエンドは Node 22 環境で動作する」 |
decision | 決定された技術選定とその理由 | 「バンドルサイズとパフォーマンスの観点から Electron ではなく Tauri を採用」 |
pattern | プロジェクト内で繰り返し適用すべきコード様式 | 「非同期リクエストはすべて apiClient ミドルウェアで包む」 |
postmortem | トラブルの振り返りと再発防止ルール | 「境界値アクセス修正後は特定のリグレッションテストを実行する」 |
event | 記録しておく価値のある重要マイルストーン | 「6 月にコアアーキテクチャの刷新を完了」 |
7 つ目の曖昧な選択肢や自由記述の種別は存在しません。これは意図的な制約です。Memory Dashboard はこの種別に基づいてフィルタリングやタグ付けを行うため、未定義の種別が紛れ込むと将来の検索精度が著しく損なわれるからです。
2. ペルソナとワークスペースによる二重の名前空間分離
記憶には明確な適用範囲が必要です。
persona:名前空間:開発者個人の作業習慣や対話の好みをペルソナに紐付けます。workspace:名前空間:特定のプロジェクトやリポジトリ固有のルールをその開発環境に限定します。
エージェントが名前空間を指定せずに記憶を書き込むと、現在アクティブなペルソナに紐付きます。また記憶を呼び出す際も特定のプロジェクト名前空間に絞り込めるため、プロジェクト A の固有ルールがプロジェクト B の文脈に混ざり込んで混乱を引き起こすことはありません。
3. 記憶候補が生まれる 4 つの経路
開発者が手動で登録する経路に加え、MadoHub はバックグラウンドで対話の流れを静かに見守っています。
- 明示的な記憶(Explicit Remember): エージェント自身が対話の中で「これは残す価値がある」と判断し、記録を提案する。
- ターンごとの自動スキャン(Post-turn Pass): 各ターンのやり取りが終わるたびに、軽量モデルが直前の会話を素早くスキャンする。有益な知見の多くは、意識的な宣言ではなく日常的な指示やフィードバックの中に現れるためです。
- コンテキスト圧縮前の救出(Pre-compaction Rescue): 長大な会話ウィンドウがトークン節約のために要約される直前に、破棄されようとしているログから知見を抽出する。圧縮は不可逆であるため、この段階で拾い上げなければ知見は永久に失われます。
- ダッシュボードからの手動登録: 開発者が 設定 → Memory から直接登録した信頼度の高い事実。
4. なぜ自動保存ではなく「人間のレビュー」を挟むのか?
これがシステム全体を支える最も重要な防衛線です。上記のいかなる経路から生成された候補も、エージェントが検索する正規メモリへ直接書き込まれることはありません。
すべての候補はまず「保留中(Pending)」のキューに格納されます。人間が目視で確認し、承認(Approved)したものだけが正式な記憶として昇格します。30 日間放置された候補は自動的にアーカイブされます。
「これでは作業の手間が増えるのではないか」と思われるかもしれません。しかし、これはハルシネーション(幻覚)の固定化を防ぐための意図的なブレーキです。もしモデルの独断で「重要だと思ったこと」を長期ストレージに書き込ませてしまえば、一度の誤った推測が以後のすべての会話で繰り返し呼び出され、誤謬が複利的に拡大していくことになります。
特に重み付けの大きい decision や postmortem においては、誤った記憶がもたらす害は「記憶がないこと」よりもはるかに深刻です。人間の承認こそが、AI の一時的な誤りをシステムの恒久知識にしない唯一の防波堤です。
実践的なアドバイス
- Memory Dashboard をプロジェクトのナレッジ精製所に: 定期的に保留キューを確認し、妥当なルールをワンクリックで承認してください。
- 自動承認ポリシー(上級者向け): 同一の事実が高い信頼度で複数回独立して観測された場合にのみ自動昇格させるオプションもありますが、完全な制御性を担保するためデフォルトではオフになっています。
- 自然に対話する: 記憶させるために特別なプロンプトを意識する必要はありません。普段通りに開発を進めるだけで、MadoHub が裏側で知見を整理してレビュー対象として提示します。