memory-system

メモリーシステム — セッションをまたいで保持される永続メモリー

エージェントがセッションをまたいで情報を記憶できるようにします。すでに得た知識を再発見する必要はありません。

概要

メモリーシステムは、セッションをまたいで保持される永続的で検索可能なメモリーを提供します。好み、慣習、過去の決定を毎回説明し直す代わりに、エージェントは構造化された MEMORY.md インデックスとトピックファイルを読み込みます。

**トークンへの影響：**インデックスの読み込みに +1,000 トークンかかりますが、再発見が不要になるため 3,000〜10,000 トークンを節約できます。

---

アーキテクチャ

.agents/memory/
├── MEMORY.md              ← Lightweight index (max 200 lines)
├── user-preferences.md    ← Topic file: user role, style, tools
├── project-conventions.md ← Topic file: coding standards, patterns
├── tech-decisions.md      ← Topic file: past architectural decisions
├── feedback-history.md    ← Topic file: what user liked/disliked
└── [topic-name].md        ← Additional topic files as needed

---

MEMORY.md インデックス形式

インデックスは軽量な参照ファイルです。詳細を記載したトピックファイルへの短い項目を並べます。

ルール：

• 合計 200 行まで
• 各項目：最大約 150 文字
• 形式：- [type] summary → topic-file.md
• タイプ：[user] [feedback] [project] [reference]

例：

# Memory Index

## User
- [user] Prefers dark mode, uses Windows 11, PowerShell → user-preferences.md
- [user] Senior DevOps engineer, 8 years experience → user-preferences.md
- [user] Primary language: English, sometimes Turkish → user-preferences.md

## Project
- [project] Always use bun instead of npm → project-conventions.md
- [project] Tailwind v4 preferred, no v3 → tech-decisions.md
- [project] No purple/violet colors in UI → project-conventions.md

## Feedback
- [feedback] User likes concise responses, no filler → feedback-history.md
- [feedback] User dislikes verbose explanations → feedback-history.md
- [feedback] User prefers tables over bullet lists → feedback-history.md

## Reference
- [reference] Squid proxy runs on port 3128 → infrastructure-notes.md
- [reference] Git workflow: feature branches → main → project-conventions.md

---

トピックファイル形式

各トピックファイルにはフロントマターと構造化されたコンテンツが含まれます。

---
type: user | feedback | project | reference
created: 2026-04-01
updated: 2026-04-01
---

# User Preferences

## Development Environment
- OS: Windows 11
- Shell: PowerShell
- Editor: Cursor / Windsurf
- Package Manager: bun (NOT npm)

## Communication Style
- Prefers concise responses
- Likes tables for comparisons
- Dislikes verbose explanations

---

メモリーの分類

タイプ	保存する内容	例
user	役割、好み、ツール、コミュニケーションスタイル	「シニア DevOps、ダークモードを好む」
feedback	エージェントの出力についてユーザーが好んだ点／好まなかった点	「ユーザーは『冗長すぎる』と言った。表を好む」
project	コーディング規約、技術選定、慣習	「npm ではなく bun を使う、Tailwind v4」
reference	機密情報ではないインフラのメモ、公開 URL、設定	「本番 API のホスト名とポート」

---

保存しない情報

保存しない情報	理由
シークレット、認証情報、トークン、パスワード、秘密鍵、API キー	メモリーは永続的で、セッション間で共有される可能性があります
コードから導き出せる情報	依存関係を記憶するのではなく、package.json を読み込みます
一時的なデバッグ時のコンテキスト	メモリーが煩雑になり、後で役立ちません
正確なコードスニペット	コードは変更されるため、メモリーが古くなります
移動する可能性のあるファイルパス	代わりに glob パターンや説明を使います
会話全体の記録	メモリーに保存するのは要点をまとめた知見だけです

---

操作

保存（トリガー：ユーザーが「覚えておいて」「保存して」「忘れないで」と言った場合）

1. 情報のタイプ（user/feedback/project/reference）を特定します
2. 関連するトピックファイルがあるか確認します
3. ある場合 → 既存のトピックファイルに追記します
4. ない場合 → フロントマター付きで新しいトピックファイルを作成します
5. 1 行の参照を MEMORY.md インデックスに追加します
6. ユーザーに確認します：「メモリーに保存しました：[要約]」

想起（トリガー：セッション開始時、または「X について何を覚えていますか」と尋ねられた場合）

1. .agents/memory/MEMORY.md インデックスを読み込みます
2. 現在のタスクに関連する項目を探します
3. 一致する項目が見つかった場合 → 参照先のトピックファイルを読み込みます
4. 想起したコンテキストを黙って適用します（尋ねられない限り、メモリーの内容を読み上げません）

検索（トリガー：「X について何かメモがありますか」と尋ねられた場合）

1. .agents/memory/*.md 全体から検索語を grep します
2. 該当する項目をファイル参照とともに返します
3. 詳細を知りたい場合は、トピックファイル全体を読むことを提案します

整理（トリガー：インデックスが 200 行を超えた場合）

1. 警告します：「メモリーインデックスが大きくなっています（X 行）。見直しをおすすめします。」
2. 関連する項目をまとめることを提案します
3. 古い項目を memory/archive/ にアーカイブすることを提案します
4. 自動削除は絶対に行わず、必ず先にユーザーに確認します

---

セッション開始プロトコル

毎回のセッション開始時に：

1. Check: Does `.agents/memory/MEMORY.md` exist?
   → YES: Read index. Apply relevant context silently.
   → NO: Continue without memory. Create on first "remember" trigger.

2. Apply memory WITHOUT reciting it.
   ❌ WRONG: "I remember you prefer dark mode and use bun..."
   ✅ RIGHT: (silently apply preferences, use bun in commands)

3. Exception: If user asks "what do you remember?" → recite relevant memories.

---

メモリーと計画とタスクの違い

成果物	目的	有効期間	場所
メモリー	セッションをまたいで保持される知識	整理されるまで永続	.agents/memory/
計画	現在のプロジェクトのタスク分解	プロジェクト完了まで	プロジェクトルート
タスク	現在のセッションの進捗トラッカー	セッション終了まで	成果物ディレクトリ

メモリー = 知っていること。計画 = これから行うこと。タスク = 今行っていること。