Memory System

🧠 Memory System Skill

name: memory-system description: Manage AI context, memory persistence, and knowledge retention across sessions

🎯 Purpose

Maintain context and knowledge across conversations, enabling continuity and learning from past interactions.

📋 When to Use

• Starting new conversations (load context)
• Completing tasks (save learnings)
• Switching between projects
• Referencing past decisions

🗂️ Memory Structure

📁 memory/
├── 📄 active.md       ← Current task context
├── 📄 summary.md      ← Project summaries
├── 📄 decisions.md    ← Architecture decisions
├── 📄 changelog.md    ← Changes history
├── 📄 patterns.md     ← Reusable patterns
├── 📄 snippets.md     ← Code templates
└── 📄 lessons.md      ← Learnings from mistakes

📝 Memory Types

1. Short-term Memory (Session)

• Current task context
• Recent files edited
• Active decisions

2. Long-term Memory (Persistent)

• Project architecture
• Design decisions
• Lessons learned
• Code patterns

3. Episodic Memory (Events)

• Bug fixes and solutions
• Feature implementations
• Deployment records

🔧 Memory Operations

Save Memory

## Save Format

### Context
- Project: [name]
- Date: [ISO date]
- Task: [description]

### Key Decisions
1. [Decision 1]: [Rationale]
2. [Decision 2]: [Rationale]

### Lessons Learned
- [Lesson 1]
- [Lesson 2]

### Code Patterns Used
- [Pattern]: [File reference]

Load Memory

## Load Checklist

1. [ ] Read project context.md
2. [ ] Check active.md for ongoing tasks
3. [ ] Review recent decisions.md entries
4. [ ] Load relevant patterns

Search Memory

## Search Methods

1. Keyword search in solutions.md
2. Date-based filtering
3. Project-specific lookup
4. Tag-based retrieval

📊 Memory Metrics

🔄 Memory Lifecycle

┌─────────────┐
│ Session     │
│ Start       │──▶ LOAD context from memory files
└─────────────┘
       │
       ▼
┌─────────────┐
│ During      │
│ Work        │──▶ UPDATE active.md with progress
└─────────────┘
       │
       ▼
┌─────────────┐
│ Task        │
│ Complete    │──▶ SAVE learnings to appropriate files
└─────────────┘
       │
       ▼
┌─────────────┐
│ Session     │
│ End         │──▶ SUMMARIZE session in summary.md
└─────────────┘

💡 Best Practices

1. Be Specific: Save context with enough detail to understand later
2. Use Tags: Add searchable tags to entries
3. Link Related: Reference related decisions/patterns
4. Prune Regularly: Archive old, irrelevant entries
5. Keep Active Current: Update active.md frequently

🔗 Related Skills

• session-recovery - Recover from session interruptions
• documentation - Document decisions properly
• progress-tracking - Track ongoing work