agent-memory

エージェントメモリ

会話をまたいで残る知識を保存するための永続メモリ領域です。

場所： .claude/skills/agent-memory/memories/

積極的な活用

保存する価値のある情報を見つけたら、メモリに保存します。

• 調査に手間がかかった発見
• コードベースにおける、わかりにくいパターンや注意点
• 難しい問題の解決策
• アーキテクチャ上の決定とその理由
• 後で再開する可能性がある作業

関連する作業を始めるときは、メモリを確認します。

• 問題領域を調査する前
• 以前に取り組んだことがある機能を作業するとき
• 会話が中断した後に作業を再開するとき

必要に応じてメモリを整理します。

• 同じトピックに関する散在したメモリを統合する
• 古くなった情報や、置き換えられた情報を削除する
• 作業の完了、ブロック、中止に応じてステータスフィールドを更新する

フォルダー構成

可能であれば、メモリをカテゴリ別のフォルダーに整理します。あらかじめ定められた構成はありません。内容に合ったカテゴリを作成してください。

ガイドライン：

• フォルダー名とファイル名には kebab-case を使用する
• ナレッジベースの成長に応じて統合や再編成を行う

例：

memories/
├── file-processing/
│   └── large-file-memory-issue.md
├── dependencies/
│   └── iconv-esm-problem.md
└── project-context/
    └── december-2025-work.md

これはあくまで例です。実際の内容に合わせて自由に構成してください。

フロントマター

すべてのメモリに summary フィールドを含むフロントマターを記述する必要があります。概要は、全文を読むべきかどうかを判断できる程度に簡潔にしてください。

概要が判断の決め手です：エージェントは rg "^summary:" で概要を検索し、どのメモリを全文読むか判断します。この判断に必要な情報を含めてください。メモリの内容、主な問題やトピック、重要である理由を記述します。

必須：

---
summary: "1-2 line description of what this memory contains"
created: 2025-01-15  # YYYY-MM-DD format
---

任意：

---
summary: "Worker thread memory leak during large file processing - cause and solution"
created: 2025-01-15
updated: 2025-01-20
status: in-progress  # in-progress | resolved | blocked | abandoned
tags: [performance, worker, memory-leak]
related: [src/core/file/fileProcessor.ts]
---

検索ワークフロー

関連するメモリを効率よく見つけるには、概要を先に確認します。

# 1. List categories
ls .claude/skills/agent-memory/memories/

# 2. View all summaries
rg "^summary:" .claude/skills/agent-memory/memories/ --no-ignore --hidden

# 3. Search summaries for keyword
rg "^summary:.*keyword" .claude/skills/agent-memory/memories/ --no-ignore --hidden -i

# 4. Search by tag
rg "^tags:.*keyword" .claude/skills/agent-memory/memories/ --no-ignore --hidden -i

# 5. Full-text search (when summary search isn't enough)
rg "keyword" .claude/skills/agent-memory/memories/ --no-ignore --hidden -i

# 6. Read specific memory file if relevant

注： メモリファイルは Git の無視対象になっているため、ripgrep では --no-ignore と --hidden フラグを使用してください。

操作

保存

1. 内容に適したカテゴリを決めます
2. 既存のカテゴリが適切か確認し、必要に応じて新しいカテゴリを作成します
3. 必須のフロントマターを付けてファイルを作成します（現在の日付には date +%Y-%m-%d を使用してください）

mkdir -p .claude/skills/agent-memory/memories/category-name/
# Note: Check if file exists before writing to avoid accidental overwrites
cat > .claude/skills/agent-memory/memories/category-name/filename.md << 'EOF'
---
summary: "Brief description of this memory"
created: 2025-01-15
---

# Title

Content here...
EOF

メンテナンス

• 更新：情報が変わったら内容を更新し、フロントマターに updated フィールドを追加します
• 削除：関連性がなくなったメモリを削除します

  trash .claude/skills/agent-memory/memories/category-name/filename.md
  # Remove empty category folders
  rmdir .claude/skills/agent-memory/memories/category-name/ 2>/dev/null || true
  

• 統合：関連するメモリが増えてきたら統合します
• 再編成：ナレッジベースの成長に応じて、より適切なカテゴリにメモリを移動します

ガイドライン

1. 作業再開に役立つように書く：メモリは後で作業を再開するためにあります。文脈を失わずに続行できるよう、決定事項、理由、現在の状況、次のステップなど、必要な要点を記録します。
2. 自己完結したメモを書く：読者が事前知識なしで内容を理解し、対応できるよう、必要な文脈をすべて含めます
3. 判断しやすい概要にする：概要を読めば詳細が必要かどうか判断できるようにします
4. 最新の状態を保つ：古くなった情報を更新または削除します
5. 実用性を重視する：すべてではなく、本当に役立つ情報を保存します

内容の参考

詳細なメモリを書くときは、次の内容を含めることを検討してください。

• 背景：目標、経緯、制約
• 状況：完了したこと、進行中のこと、ブロックされていること
• 詳細：重要なファイル、コマンド、コードスニペット
• 次のステップ：次に行うこと、未解決の疑問

すべてのメモリにすべての項目を含める必要はありません。関連する内容を使用してください。