| name | memory-management |
| description | 4-tier memory system management for all stateful agents — loading, saving, pruning, promoting, and maintaining memory files. Use when user says "load memory", "save memory", "update working memory", "prune memory", "memory management", "tier system", or any agent memory lifecycle activity. |
Memory Management Skill
Standard 4-tier memory system used by all stateful agents in the {{FAMILY_NAME}} family platform. This skill defines the canonical patterns for loading, saving, pruning, and promoting agent memory.
The 4-Tier System
| Tier | File | Purpose | Load Rule | Size Limit |
|---|
| 1 | core.md | Identity, mission, heuristics | ALWAYS load first | 3-5KB |
| 2 | working.md | Current state, active context | ALWAYS load second | 5KB max |
| 3 | long-term.md | Historical patterns, lessons | On-demand only | 10KB max |
| 4 | events.log | Append-only event stream | Never bulk-load | Unlimited (prune >30 days) |
Directory Structure
All agent memory lives at:
data/agents/{agent-name}/
├── core.md # Tier 1 — identity, rules, preferences
├── working.md # Tier 2 — current state, today's context
├── long-term.md # Tier 3 — accumulated wisdom, patterns
└── events.log # Tier 4 — append-only audit trail
First Action: Load Memory (Every Run)
MANDATORY for every stateful agent at run start:
1. Read data/agents/{agent-name}/core.md # Tier 1 — ALWAYS
2. Read data/agents/{agent-name}/working.md # Tier 2 — ALWAYS