# Memory Management

> Manage tri-tier agent memory (hot/warm/cold) with event consolidation and weekly cleanup. Use for memory updates after completing tasks. Use when this capability is needed.

- Skill: `tomevault-io/memory-management-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/memory-management-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/memory-management-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/memory-management-3

---


# Memory Management - Tri-Tier System

## Memory Structure

```json
{
  "hot_memory": {
    "_description": "Last 20 events - always loaded",
    "recent_events": [],
    "active_tasks": [],
    "recent_learnings": []
  },
  "warm_memory": {
    "_description": "Events 21-100 - patterns",
    "patterns": [],
    "known_issues": [],
    "successful_strategies": []
  },
  "cold_memory": {
    "_description": "Events 101+ - archived",
    "historical_patterns": []
  }
}
```

## When to Update

### After Task Completion
```
Update hot_memory.recent_events:
- What was done
- Outcome
- Lessons learned
```

### Weekly Consolidation
```
hot → warm (after 20 events)
warm → cold (after 100 events)
```

## Update Pattern

```json
{
  "recent_events": [
    {
      "date": "2025-11-24",
      "task": "Built FastAPI endpoint",
      "outcome": "Success",
      "lessons": ["Async patterns work well", "Remember CORS"]
    }
  ]
}
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/ak-eyther) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->