feat: initial public release (MAESTRO)

2026-06-03 05:08:00 +00:00
commit f5c7666f6b
823 changed files with 184150 additions and 0 deletions
@@ -0,0 +1,81 @@
+---
+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 の有無に関わらず確実に注入される。
+
+> メモリが増えすぎてインデックスが肥大化したら、不要なエントリは削除する。注入トークンの節約になる。