dream-memory

name	dream-memory
description	Consolidate recent logs, sessions, and existing memory files into durable topic memories, normalize dates, prune stale entries, and keep MEMORY.md short enough for prompt use.

Dream Memory

Use this skill when you want a deliberate memory-consolidation pass instead of storing more raw notes.

This bundle is intentionally portable. It borrows the workflow shape from Claude Code's dream system, but it does not depend on Claude Code internals.

Use It For

• nightly or manual memory cleanup
• merging overlapping memory notes
• normalizing relative dates into absolute dates
• pruning stale or contradicted memories
• keeping MEMORY.md small and index-like

Avoid It For

• saving a single new memory from the current turn
• persisting code facts that should be re-read from source
• replacing plans, task boards, or issue trackers

Quick Start

Inspect a memory directory before running the consolidation prompt:

python3 {baseDir}/scripts/dream_memory.py --memory-root /path/to/memory --transcripts-dir /path/to/transcripts

Then use the portable prompt in references/prompt-template.md.

Workflow

1. Inspect MEMORY.md, topic files, and recent logs or transcripts.
2. Identify durable facts worth keeping.
3. Merge into topic files instead of creating near-duplicates.
4. Remove stale or contradicted memory.
5. Rewrite MEMORY.md as a concise index.

Rules

• MEMORY.md is an index, not a content dump.
• Prefer topic merges over new file creation.
• Convert relative dates to absolute dates.
• Do not store code-state facts that can drift.

Supporting Files

• Prompt template: references/prompt-template.md
• Source notes: references/source-notes.md
• Helper script: python3 {baseDir}/scripts/dream_memory.py ...