メモリ
エージェントがセッションやプロジェクトをまたいで呼び出す、長寿命の事実、好み、決定事項。
メモリは MadoHub のエージェントがセッション間で覚えておくための仕組みです。これがないと、新しいターミナルを開くたびにエージェントはあなたの規約、スタック、コーディングスタイル、先週の決定をゼロから学び直します。メモリはセッションとプロジェクトをまたいで存続するため、エージェントは前のエージェントが終わったところから引き継げます。
メモリはセッションのチャット履歴とは別物です。チャット履歴は今あなたが行っている会話であり、メモリはエージェントが引き出す永続的な背景です。何を記憶するかはあなたが制御します — エージェントが何を残す価値があるか推測したものはまずレビュー待ちキューに入り、あなたが承認するまで長期メモリには入りません。
できること
- 6 種類の事柄を保存 — preferences、facts、decisions、patterns、postmortems、events。各エントリは種類でタグ付けされ、Memory Dashboard がきれいにフィルタ・ラベル付けできます。
- 名前空間で整理 — ペルソナ固有のメモリをプロジェクト固有のメモリと分離します。プロジェクトの規約を呼び出すエージェントが、すべてのペルソナの個人的好みを引き込むことはありません。
- 定着前にレビュー — すべての候補メモリは承認待ちの保留キューに入ります。文言を編集する、種類を変える、拒否する、そのまま承認するができます。
- 関連メモリを自動注入 — 自動呼び出しをオンにすると、一致するエントリが新しい会話の先頭に付加され、エージェントに尋ねさせずに関連する好みや決定を浮かび上がらせます。
- 手動で検索 — エージェントは特定の何かが必要なときに全文クエリで明示的に呼び出しできます。
使い方
- 設定 → Memory を開き Memory Dashboard にアクセスします。
- Pending review タブで候補をレビューします。各候補に対して:
- そのまま 承認
- 内容や種類を 編集 してから承認
- 拒否
- 元になった会話ターンへジャンプ
- Approved タブで承認済みエントリを名前空間ごとに閲覧・管理します。ここから編集、削除、手動で新しいメモリを追加できます。
- 自動呼び出し注入 を切り替えて、一致するメモリを新しい会話に自動付加するか、エージェントが明示的に呼び出したときだけ表示するかを選びます。
- オプションで Advanced セクションで、十分な回数と高い信頼度で見られた候補を自動承認するようなポリシーを有効化できます。
よくあるユースケース
- 「pnpm を使う、npm は使わない」 — エージェントが最初に失敗して発見する代わりに、毎回の新しいセッションで呼び出せる好み。
- 「認証はモノリスに保つと決めた、切り出さない」 — 未来のエージェントが再協議しないよう、再浮上し続ける決定。
- 「
payments.specの不安定なテストはモッククロックの競合が原因」 — 次に誰かがそのファイルを触るときに覚えておきたい事後検証。 - 「このプロジェクトの API レスポンスは camelCase JSON」 — エージェントがそのワークスペースで API コードを生成・編集するときにいつも引き込む事実。
ヒントとベストプラクティス
- 保留キューを定期的にレビューしましょう。間違った、あるいは古い
decisionやpostmortemは、欠けているものより悪いです — 今後の呼び出しで再浮上し続けるため。 - 名前空間を意識的に使いましょう — プロジェクトの規約は
workspace:名前空間にスコープし、他のプロジェクトに漏れないようにします。 - 自動で上書きされたくないエントリはピン留めしましょう。ピン留めされたエントリは呼び出し時に先頭に浮上します。
- メモリが騒がしく感じられてきたら、自動注入をオフにし、エージェントが必要なときだけ明示的に呼び出すようにしましょう。
関連機能
制限事項
- 呼び出しクエリは 3 文字以上が必要です — それより短いクエリは拒否され、エージェントは何も返らないのではなく言い換えるべきだとわかります。
- 候補は 30 日間活動がないと自動アーカイブされるため、キューを永遠に放置しないようにしましょう。
- メモリはチャット履歴を置き換えるものではありません — それは精選された、小さな永続的事実のレイヤーです。