memory-cleanup

Solid

Use this skill when performing manual memory consolidation (Dream-equivalent). Reviews, consolidates, and prunes memory files under ~/.claude/projects/*/memory/. Run after major refactors, every 5+ sessions, or when memory quality degrades (broken links, stale references, contradictions, MEMORY.md > 200 lines). Invoke with /memory-cleanup.

Code & Development 48 stars 8 forks Updated today MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
56
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Memory Cleanup — Manual Dream Process Implements the 4-phase memory consolidation process modelled after Claude Code's Auto Dream feature. Run after major refactors, framework migrations, or every 5+ sessions in a repo. The memory system lives at `~/.claude/projects/<encoded-cwd>/memory/` and consists of: - `MEMORY.md` — index file (must stay under 200 lines; lines after 200 are truncated by the harness). - Topic files — one Markdown file per memory entry with YAML frontmatter (`name`, `description`, `metadata.type`). The four memory types are `user`, `feedback`, `project`, `reference` (see global `auto memory` instructions for semantics). This skill never invents new types. ## Argument Handling (Phase 0) This skill accepts two optional flags. Default (no flag) runs the interactive 4-phase consolidation defined below. | Flag | Behavior | |---|---| | `--dry-run` | Run Phases 1-3 read-only; instead of mutating MEMORY.md / topic files, write a complete-body MEMORY.md proposal (single fenced block — never a unified-diff) to `.orchestrator/pending-dream.md` (atomic). Exit 0. | | `--apply-pending` | Read `.orchestrator/pending-dream.md`; refuse if older than 14 days (`stale`) or if MEMORY.md changed since the producing --dry-run (`stale-index`, #788); apply diff; delete pending file; print `auto-dream applied: -<X> lines, +<Y> entries`. Exit 0. | Flags are mutually exclusive — passing both is an error. Absence of both = legacy interactive mode (Phases 1-4 below). **`--dr...

Details

Author
Kanevry
Repository
Kanevry/session-orchestrator
Created
3 months ago
Last Updated
today
Language
JavaScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category