What is agent-memory?

This Claude skill provides a robust framework for persistent knowledge management, allowing the agent to store, organize, and retrieve critical insights across multiple chat sessions. It enables the proactive saving of architectural decisions, research findings, and complex problem-solving patterns into a structured local directory, ensuring long-term project continuity and efficient context recovery.

When should I use agent-memory?

agent-memory is useful in the following scenarios: • Case 1: Documenting and recalling architectural decisions to maintain design consistency throughout a long-term software project. • Case 2: Storing complex debugging solutions and non-obvious code patterns discovered during development for future reference. • Case 3: Proactively capturing and categorizing important research findings or project-specific configurations during active exploration. • Case 4: Organizing cross-session knowledge into a searchable markdown-based memory bank using a summary-first retrieval approach.

name	agent-memory
description	ユーザーが「記憶して」「思い出して」などのメモリ操作を指示した時に使用。重要な調査結果、アーキテクチャの決定、問題の解決策を発見した時にも積極的に保存を提案する。

Agent Memory

会話をまたいで知識を保存・復元するスキルです。記憶は .claude/skills/agent-memory/memories/ に保存されます。

使用タイミング

ユーザーからの指示

「記憶して」「保存して」「覚えておいて」
「思い出して」「○○について思い出して」
「メモを確認して」「記憶を整理して」

プロアクティブ（積極的な使用）

以下の場合は、ユーザーに保存を提案してください：

重要な調査結果を発見した時
非自明なコードパターンを見つけた時
問題の解決策を導き出した時
アーキテクチャ上の決定を行った時
既知の問題領域を調査する前に記憶を確認

保存方法

1. カテゴリフォルダを作成

mkdir -p memories/<category-name>

kebab-case形式で命名（例: file-processing, react-patterns, api-design）

2. マークダウンファイルを作成

必須front matterを含むファイルを作成：

---
summary: "簡潔な1-2行の要約"
created: 2025-01-09
---

# タイトル

詳細な内容をここに記述...

オプションのfront matterフィールド

updated: 最終更新日（YYYY-MM-DD）
status: in-progress, resolved, blocked, abandoned
tags: 検索用タグの配列 [tag1, tag2]
related: 関連ファイルのパス配列

3. ファイル例

---
summary: "ReactのuseEffectでクリーンアップ関数を使う方法"
created: 2025-01-09
status: resolved
tags: [react, hooks, cleanup]
related:
  - src/components/Timer.tsx
---

# useEffect クリーンアップパターン

## 問題
タイマーが正しくクリアされず、メモリリークが発生。

## 解決策
useEffectからクリーンアップ関数を返す：

\`\`\`typescript
useEffect(() => {
  const timer = setTimeout(() => {
    // 処理
  }, 1000);

  return () => clearTimeout(timer);
}, []);
\`\`\`

復元方法（Summary-First アプローチ）

1. カテゴリ一覧を確認

ls -d memories/*/

2. サマリー一覧を表示（推奨）

rg --no-ignore --hidden '^summary:' memories/

--no-ignore --hidden フラグは必須（memories ディレクトリは .gitignore 対象のため）

3. キーワードでサマリー検索

rg --no-ignore --hidden '^summary:.*<キーワード>' memories/ -i

4. タグで検索

rg --no-ignore --hidden '^tags:.*\[.*<タグ>.*\]' memories/ -i

5. 全文検索（必要な場合のみ）

rg --no-ignore --hidden '<キーワード>' memories/ -i

6. ファイルを読み込み

サマリーから該当ファイルを特定したら、Read toolで内容を確認。

メンテナンス操作

更新

ファイルを編集
updated フィールドを追加・更新
必要に応じて status を変更

削除

trash memories/<category>/<file>.md
# または
rm memories/<category>/<file>.md

空になったカテゴリフォルダも削除：

rmdir memories/<category>

統合・再編成

関連する記憶が増えてきたら：

複数のメモを1つに統合
カテゴリを再編成
重複を削除

ベストプラクティス

記述のポイント

自己完結的に: 前提知識なしで理解できるように記述
決定的なサマリー: サマリーだけで重要度を判断できるように
最新性を保つ: 古い情報は更新または削除
実用性重視: 本当に役立つ内容に絞る

保存する内容

✅ 調査結果・発見したパターン ✅ 問題の解決方法・回避策 ✅ アーキテクチャの決定と理由 ✅ プロジェクト固有の知識・設定

保存しない内容

❌ 一時的な情報 ❌ 頻繁に変更される情報 ❌ 機密情報（パスワード、APIキーなど）

フォルダ構成例

memories/
├── react/
│   ├── hooks-cleanup.md
│   └── state-management.md
├── typescript/
│   └── type-narrowing.md
├── api-design/
│   ├── rest-conventions.md
│   └── error-handling.md
└── project-context/
    └── architecture-decisions.md

注意事項

memories/ ディレクトリは .gitignore で除外される（個人用のメモのため）
ファイル名・フォルダ名はkebab-case形式を使用
ripgrep検索時は必ず --no-ignore --hidden フラグを使用
Summary-Firstアプローチで効率的に検索（全文検索は最終手段）

agent-memory

When & Why to Use This Skill

Use Cases