---
id: memory
title: メモリと学習
category: advanced
order: 120
keywords: [メモリ, memory, MEMORY.md, 学習, Memory & Learning]
---

# メモリと学習

エージェントは、ユーザーごとの **メモリ** を保持します。あなたの好み・役割・プロジェクトの文脈・参照資料を覚えておくことで、毎回ゼロから説明しなくても「あなたを理解した」状態で動けます。

## メモリの構造

メモリは `data/users/{userId}/memory/` 配下に置かれ、2 つの要素で構成されます。

### MEMORY.md（インデックス）

エントリの一覧（description 行のリンク集）です。**タスク起動時に system prompt へ自動注入**されます（注入サイズには上限あり）。エージェントは、まず一覧で「何を覚えているか」を把握します。

### 個別エントリ（{name}.md）

1 ファイル = 1 エントリ。frontmatter（name / type / description）+ 本文の構造です。本文はインデックスには載らず、エージェントが必要に応じて `ReadUserMemory` で読み込みます。

## メモリの 4 タイプ

| type | 用途 |
|---|---|
| user | あなた固有の好み・役割 |
| feedback | 過去のフィードバック・教訓 |
| project | プロジェクト別の文脈 |
| reference | 参照資料・外部情報 |

## どう使われるか

エージェントは毎セッションで MEMORY.md のインデックスを参照し、関連しそうなエントリを `ReadUserMemory` で開いて作業に反映します。書き込みは `UpdateUserMemory` ツールで行われ、「これは覚えておくべき」と判断した内容を自動で記録します。

手動で書いたメモリは Reflection が動いていなくても確実に注入されるため、「いつも忘れられる」と感じる指示はメモリに 1 件書くのが確実です。

## メモリの閲覧・編集（Settings → Memory & Learning）

Settings → **メモリと学習** で管理します。2 つのパネルが縦に並びます。

### メモリエントリ

- 既存エントリの一覧（name・type バッジ・概要・本文プレビュー）
- **+ 新しいエントリ** で追加。編集モーダルで以下を入力:
  - **名前**（新規時のみ。英数字・ハイフン・アンダースコア）
  - **概要**（一覧に出る 1 行説明）
  - **タイプ**（user / feedback / project / reference）
  - **本文**（Markdown またはプレーンテキスト）
- 各行の **編集** / **削除** ボタンで更新

メモリは User Folder の memory/ タブからは閲覧のみで、編集はこの画面で行います（→「[User Folder](09-userfolder.md)」）。

### Reflection タイムライン

自動学習（Reflection）の実行履歴です。各行を展開すると、推論・変更前後の差分・revert コントロールを確認できます。

- バッジ: `N mem`（メモリ変更数）/ `piece`（piece 編集あり）/ 結果（適用済み・一部適用・学習なし・却下・失敗）
- **revert**: 気に入らない変更はスナップショット単位で変更前に戻せる
- 下部に 30 日間のサマリ（合計実行回数・適用率・学習なし率・Tokens・Piece 編集数）

## Reflection との関係

メモリエントリは、手動だけでなく **Reflection（自動学習）** によっても追加・更新されます。タスク完了後に専用ワーカーが振り返り、メモリ更新を提案します。完全自動 apply はデフォルト OFF です。

仕組み・有効化・rejection の詳細は「[自動学習（Reflection）](18-reflection.md)」を参照してください。

## メモリと AGENTS.md の使い分け

User Folder の AGENTS.md（→「[User Folder](09-userfolder.md)」）は全文が毎回注入される固定の恒久指示、メモリはインデックスのみ注入し本文は必要時に読む構造です。

- **AGENTS.md**: 短く要約された必須ルール・トーン・出力フォーマットの好み
- **メモリ**: 個別の人物・プロジェクト・経験的に得た知見（数を増やせる）

## TIP

> 「いつも忘れられる」と感じたら、その情報を 1 件メモリに書いて 2〜3 回タスクを回す。手動メモリは Reflection の有無に関わらず確実に注入される。

> メモリが増えすぎてインデックスが肥大化したら、不要なエントリは削除する。注入トークンの節約になる。
