tobihagemann/turbo / claude/skills/dream
dream
VerifiedConsolidate the project's auto memory, move notes that belong in the repo, then offer to clean up .turbo/. Use when the user asks to "dream", "tidy memory", or "move memory into the repo".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.5 KB |
SKILL.md
View on GitHub---
name: dream
description: "Consolidate the project's auto memory, move notes that belong in the repo, then offer to clean up .turbo/. Use when the user asks to \"dream\", \"tidy memory\", or \"move memory into the repo\"."
---
# Dream
Consolidate this project's auto memory, move what belongs in the repo, then clear out what `.turbo/` no longer needs.
Text passed with the invocation steers the memory pass: what to look for and how to organize the notes. Every note is still read, and Step 3's and Step 5's conditions for deleting a note hold regardless.
## Task Tracking
Use `TaskCreate` to create a task for each step:
1. Read the memory
2. Gather evidence
3. Consolidate the memory
4. Run `/route-lessons` skill
5. Remove moved statements
6. Clean up `.turbo/`
7. Report
## Step 1: Read the Memory
Use the auto-memory directory the system prompt names. When it names none, an effective `autoMemoryDirectory` setting gives the location. Otherwise the directory is `<Claude config home>/projects/<encoded project root>/memory/`. The config home is `CLAUDE_CONFIG_DIR` when set and `~/.claude` otherwise. The key replaces every character outside `A-Za-z0-9` with `-`, and long keys may be truncated and hashed.
List the directory, then read `MEMORY.md` and every note with the Read tool. When the directory does not exist, or holds no notes and `MEMORY.md` holds no entry in full, say so and continue with Step 6.
## Step 2: Gather Evidence
Judge each statement in every note, and in every entry `MEMORY.md` holds in full rather than as a pointer to a note, by its kind:
- **A claim the project can confirm or refute**, such as a path, a symbol, a flag, or a command: check it by searching the current code, reading a file only where the match does not settle the claim. A claim about how a tool behaves at runtime is unverifiable unless reading settles it.
- **A decision or preference of the user**: the code never contradicts it. Only a note modified more recently, or the user reversing it in a session transcript, does.
- **Anything else**: unverifiable.
Then check each statement against what the project records in its instruction files, the documents they point to, and its skills. A statement is covered when they hold every detail it holds. A statement they disagree with, where the code does not settle it, is in conflict with the project; a project file is never the evidence for a contradicted verdict. Name the file in both cases.
Search the session transcripts only to settle which of two notes that contradict each other holds. Claude Code writes them to `<Claude config home>/projects/<key>/<session-id>.jsonl`. A session started in a subdirectory uses its own key, so match the encoded project root as a prefix. An `autoMemoryDirectory` setting does not move them. Search the transcripts modified after the older of the two notes for a narrow term, and output a short window around each match rather than the whole line, since one line can hold an entire tool result.
The step is done when every statement carries one of three verdicts: confirmed, contradicted with the evidence named, or unverifiable; every statement is marked covered, naming the covering file, or not covered; and every conflict names its file.
## Step 3: Consolidate the Memory
Apply these changes without asking, following the memory conventions from the system prompt:
- **Merge** notes that cover the same fact into the one that covers it best, keeping every detail any of them held, and delete the others.
- **Delete** a statement the project covers, and its note when nothing else remains in it.
- **Correct** a contradicted statement so it states what the evidence shows. Delete the note when nothing true remains in it.
- **Leave** the content of an unverifiable statement, or of one in conflict with the project, as it stands. Merging and date rewriting still apply to it.
- **Rewrite** a relative date as an absolute one when the note's own text fixes the day.
- **Repoint** each link in another note that names a note merged away at the note that absorbed it, and remove each link to a deleted note.
- **Re-index** `MEMORY.md`: one line per note, each pointing at a file that exists. Leave entries it holds in full where they are, correcting or deleting them under the rules above.
Before the first edit this step makes to a note, and before deleting one, output its path and its full original text. Output each line of `MEMORY.md` before changing or removing it. Leave every file that is not a note or the index untouched.
When a write or a deletion is refused, continue with the rest and carry what is left to do into Step 7.
## Step 4: Run `/route-lessons` Skill
**Skip** when every remaining statement is in conflict with the project, or none remains.
Run the `/route-lessons` skill with each statement in every note, and in every entry `MEMORY.md` holds in full, as a candidate lesson: its note or entry as its origin, and the evidence Step 2 gathered for it. Leave out each statement in conflict with the project; Step 7 reports it for the user to settle.
## Step 5: Remove Moved Statements
**Skip** when Step 4 was skipped.
Remove each statement `/route-lessons` reports as moved from its note, or from its entry when `MEMORY.md` holds it in full. Delete a note left with nothing, and remove an entry held in full that is left with nothing, keeping `MEMORY.md` itself. Make these edits under Step 3's rules for outputting original text, removing links, re-indexing `MEMORY.md`, and refused writes, outputting only the removed statements for a note Step 3 already printed.
## Step 6: Clean Up `.turbo/`
Resolve the repo root with `git rev-parse --show-toplevel`, except inside a linked worktree — where `git rev-parse --git-dir` differs from `--git-common-dir` — in which case use the parent of the common dir. Outside a git repository, use the working directory. When that root has no `.turbo/` directory, continue with Step 7.
List the top-level entries of `.turbo/` with one command that prints one line per entry: its size and the date of its newest file. Say what each holds from its name and, for a file, its heading. Read the frontmatter `status:` of every plan with one search.
Recommend deleting or keeping each entry by its kind:
- **The backlog** (`backlog.md` and a legacy `improvements.md`) — keep
- **A plan** — delete when its frontmatter `status:` is `done`, keep otherwise, including a legacy `plan.md`
- **A standing document**, one fixed name that a skill replaces on each run — keep
- **A handoff, or a file that tracks one execution**, named `<label>-<tag>`, such as a ledger under `loops/` — keep
- **A file that only carried text to a command**, named by a random tag or by the identifier of what it carried — delete when it was last modified before today
- **A prototype, capture, or scratch directory** — delete when its newest file predates the last commit to what it shows
- **Anything else**, including an entry whose purpose you cannot tell — keep
Where a directory holds items with different recommendations, list the ones recommended for deletion together as one entry and the rest as another.
Output a numbered table of the entries with size, the date of the newest file, what each holds, and the recommendation.
Then use `AskUserQuestion`, one question per entry recommended for deletion, in number order, filling each call to its four-question limit:
- **Header** — `#<number>`
- **Question** — the entry's name, what it holds, its size and age, ending with "Delete or keep?"
- **Options** — **Delete (Recommended)** with the reason in its description, then **Keep** with what keeping costs in its description
After each call, delete the entries the user chose to delete. When an answer asks a question or gives an instruction in place of a choice, act on it, then ask about that entry again when delete or keep is still open. When a deletion is refused, carry it into Step 7.
## Step 7: Report
Output what changed:
- **Memory** — each note merged, corrected, or deleted, and each statement removed as covered, with the evidence for it, the dates rewritten, and the index lines added, changed, or removed
- **Moved out of memory** — each statement removed from its note, with the file it now lives in or the upstream proposal that carries it
- **Conflicts with the project** — each statement a project file contradicts, with the note and the file, for the user to settle
- **`.turbo/`** — each entry deleted, with the space freed
- **Left to do** — each write or deletion that was refused, with the path
Then use the TaskList tool and proceed to any remaining task.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |