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 4 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 90/100

Stars 20%
56
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
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 unified-diff proposal to `.orchestrator/pending-dream.md` (atomic). Exit 0. | | `--apply-pending` | Read `.orchestrator/pending-dream.md`; refuse if older than 14 days; 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). **`--dry-run` flow:** - Read MEMORY.md and topic files (read-only). - Produce the same internal plan the interactive mode would (merges, prunes, rewr...

Details

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

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

dream

Nightly memory consolidation — prunes stale entries, merges duplicates, resolves contradictions, rebuilds MEMORY.md index. Use when memory files have accumulated over many sessions and need cleanup. Do NOT use for storing new decisions (use remember) or searching memory (use memory).

179 Updated today
yonatangross
AI & Automation Listed

aio-dream

Memory consolidation — review, merge, prune and re-index memory files so future sessions orient quickly.

3 Updated today
aiocean
AI & Automation Listed

consolidate-memory

Consolidate memory from the last 24 hours of local Claude logs (~/.claude) into memory/recent-memory.md, memory/long-term-memory.md, and memory/project-memory.md; promote durable facts and patterns from recent to long-term, and run nightly via launchd automation.

0 Updated 6 days ago
talgacapri
Code & Development Listed

review-memory

Review auto-memory for the current project. Shows accumulated learnings, identifies noise, and helps promote permanent patterns to CLAUDE.md, rules, or skills.

2 Updated 2 days ago
stuartshields
AI & Automation Listed

claude-md-overhaul

Audit and improve a Claude Code memory layer end-to-end. Measures CLAUDE.md and MEMORY.md against Anthropic's documented caps (200 lines per CLAUDE.md, 200 lines OR 25 KB for MEMORY.md auto-load), surveys project portfolio on disk vs memory coverage, finds sync conflicts in ~/.claude/, identifies gaps tier-by-tier, and executes improvements under bias-to-action with cap-fitting verification at each step. Use when CLAUDE.md/MEMORY.md "feel bloated", when memory feels invisible in fresh sessions, or as periodic hygiene (~monthly).

0 Updated 5 days ago
HermeticOrmus