dream

Dream: Memory Consolidation

Overview

Consolidate auto memory by enforcing the format contract, pruning stale content, deduplicating facts, and rebuilding MEMORY.md as a clean index.

Announce at start: "Running memory consolidation (dream)."

Context: Standalone maintenance utility. Run periodically or when memory feels cluttered. Simulates the Auto Dream feature that is in gradual rollout.

The Format Contract

Source: Claude Code client system prompt + official docs.

MEMORY.md is an index, not a memory. It should contain only one-line pointers to topic files:

• Format: - [Title](file.md) -- one-line hook
• Target: under ~150 characters per entry
• Hard limit: 200 lines / 25KB (only this much loads at session start)
• No content, tables, or multi-line facts directly in MEMORY.md

Topic files require frontmatter:

---
name: {{topic name}}
description: {{one-line description}}
type: {{user | feedback | project | reference}}
---

Organization: Semantic by topic, not chronological by session.

The Process

Phase 1: Audit

Read MEMORY.md and every file in the memory directory. For each file, check:

1. Frontmatter present? Must have name, description, type fields.
2. Type correct? Must be one of: user, feedback, project, reference.
3. Named by topic? Files named session-YYYY-MM-DD-* should be renamed to their actual topic.

For MEMORY.md, check:

1. Index entries only? Flag any line that is NOT a - [Title](file.md) link or a ## section header.
2. Content leaking into index? Flag inline facts, tables, multi-line bullet points.
3. Under 200 lines? Flag if approaching the limit.

Phase 2: Propose Changes

Present a structured report to the user with these sections:

Format violations -- files missing frontmatter, content in MEMORY.md Stale content -- items older than 14 days with forward-looking TODOs or "Next/Pending" sections that may be completed Duplicates -- facts that appear in both topic files and MEMORY.md inline, or across multiple topic files Rename candidates -- session-dated files that should be topic-named Proposed actions -- numbered list of specific changes (extract, merge, prune, rename, add frontmatter)