| name | memory-maintenance |
| description | Consolidates old memories by removing duplicates, promoting recurring patterns to learned-patterns.md or relationship files, and archiving outdated entries. |
| allowed-tools | Read, Write, Edit, Bash |
Memory Maintenance
Review agent-data/memories/ files older than 2 weeks. Consolidate, promote, or archive.
Process
- Find old memories — files in
agent-data/memories/ older than 2 weeks
- Categorize each entry:
- KEEP: Lasting facts, important events, relationship info
- PROMOTE: Recurring patterns (3+ occurrences) →
learned-patterns.md or relationships/
- ARCHIVE: Historical value but not active →
agent-data/compaction-summaries/
- DELETE: Trivial chatter, outdated temporary states
- Write a consolidation summary to
agent-data/compaction-summaries/[date].md
- Clean up — remove promoted/archived content from daily memory files
Don't consolidate memories < 2 weeks old (context still fresh). Archive rather than delete when unsure. Relationship files are source of truth for per-person patterns.
When to Use
When asked to "clean up memories" or "consolidate", or during idle time.
Idle Behavior
Cooldown: 24 hours
- Check for memory files older than 2 weeks (need at least 3 to justify a run)
- Read and categorize content (keep/promote/archive/delete)
- Promote recurring patterns, write consolidation summary
- If fewer than 3 old files, just quick-check learned-patterns.md for recent captures
