---

name: agent-memory description: "Use this skill when the user asks to save, remember, recall, or organize memories. Triggers on: '記憶して', '保存して', 'remember this', 'save this', 'note this', '思い出して', 'what did we discuss about...', 'check your notes', 'メモ確認して', 'clean up memories'. Also use proactively when discovering valuable findings worth preserving."

Agent Memory

A persistent memory space for retaining knowledge across multiple conversations. Location: ~/.claude/skills/agent-memory/memories/

When to Use This Skill

Triggers:

• User explicitly asks: "remember this", "save this", "note this", "記憶して", "保存して"
• User wants to recall: "what did we discuss about...", "check your notes", "思い出して", "メモ確認して"
• Proactively when you discover valuable findings worth preserving

What to Remember:

• Research findings and investigation results
• Code patterns and architectural decisions
• Problem-solving approaches and solutions
• Work-in-progress that may be resumed later
• Important project decisions and their rationale
• Troubleshooting solutions

When to Check Memory:

• Before investigating a problem that seems familiar
• When resuming previous work
• When user asks about past discussions

Directory Structure

Memories are organized in category folders using kebab-case naming:

~/.claude/skills/agent-memory/memories/
├── global/                          # Cross-project knowledge
│   ├── coding-patterns/
│   ├── best-practices/
│   └── personal-preferences/
└── life-project-management/         # Project-specific memories
    ├── mission/
    ├── workflows/
    ├── system-design/
    ├── troubleshooting/
    └── daily-learnings/

Category Guidelines:

• Use descriptive kebab-case names
• Create new categories as needed
• Organize by topic or project name
• Prefer project-specific folders for context isolation

Memory File Format

Every memory file must have YAML frontmatter with at least summary and created fields. See the full template and field reference:

references/template-memory-file.md

Searching Memories

Use progressive disclosure approach with ripgrep:

Step 1: Search summaries (fastest)

rg --no-ignore --hidden "summary:.*keyword" ~/.claude/skills/agent-memory/memories/

Step 2: Search by tags

rg --no-ignore --hidden "tags:.*keyword" ~/.claude/skills/agent-memory/memories/

Step 3: Search by project

rg --no-ignore --hidden "project: project-name" ~/.claude/skills/agent-memory/memories/

Step 4: Full content search

rg --no-ignore --hidden "search-term" ~/.claude/skills/agent-memory/memories/

Step 5: Read relevant files Use the Read tool to open files that match the search criteria.

Important Flags:

• --no-ignore: Don't skip gitignored files (memories/ is in .gitignore)
• --hidden: Search hidden directories

Saving Memories

When saving a new memory:

1. Determine the category folder

   • Project-specific: memories/life-project-management/[category]/
   • Global knowledge: memories/global/[category]/
   • Create new category if needed

2. Choose a descriptive filename

   • Use kebab-case
   • Be specific: para-structure.md not notes.md

3. Create the file with frontmatter

   • Always include summary and created
   • Add project field for project-specific memories
   • Use tags for cross-category findability

4. Check for existing files

   • Before creating, search to avoid duplicates
   • Update existing memory if it already exists

5. Write complete, self-contained content

   • Include enough context to understand later
   • Link related files in related field
   • Add specific details (file paths, commands, code)

Updating Memories

When updating an existing memory:

1. Update the updated field with current date
2. Modify status if applicable (in-progress → resolved)
3. Add new information while preserving original context
4. Update summary if the focus has changed

Memory Maintenance

Regular Review (Monthly):

• Archive resolved items older than 6 months
• Delete abandoned items after 1 month
• Consolidate related memories
• Update outdated information

Archive Strategy:

• Move old resolved items to memories/archives/
• Keep frequently referenced memories active
• Use status: resolved and updated date for filtering

Cleanup:

• Remove duplicate information
• Merge similar memories
• Delete obsolete knowledge

Best Practices

1. Decisive Summaries

   • Make summaries searchable
   • Include key terms and context
   • One clear sentence

2. Complete Context

   • Include background and rationale
   • Link to relevant files and docs
   • Note the situation that prompted saving

3. Current Information

   • Update when circumstances change
   • Mark status appropriately
   • Date all modifications

4. Appropriate Sections

   • Use sections that