---
name: augment-sleep
description: Consolidate settled WORK memories into durable SPEC/ARCH/INFO records via user-approved sleep proposals. Use when the user asks to "sleep", consolidate, or distill project memory.
---

# Augment Sleep

Sleep folds related, settled WORK memories into one durable SPEC, ARCH, or INFO
record. You draft; the user approves; `sleep_apply` writes. Never skip the
approval step.

1. Call `sleep_candidates` (current project unless the user names one).
   If no clusters, report that and stop.
2. For each cluster (or the one the user picks): `read` every member, then
   draft ONE consolidated record — SPEC if a stable contract emerged, ARCH if
   a decision stuck, INFO if the result is descriptive knowledge. The draft must
   state every fact worth keeping from the sources; sources will be archived
   (down-weighted, never deleted).
3. Call `sleep_propose` with the draft (kind, name, content,
   derived_from = the cluster's relative paths). Tell the user where the
   proposal file lives — they may edit it directly before approving.
4. Show the user the draft and ask for approval. On an explicit yes, call
   `sleep_apply` with the proposal filename. On no, call `sleep_reject`.
5. Report what was consolidated, what was archived, and the git commit.

Constraints: one project per pass; never invent facts not present in the
sources; if a cluster mixes unrelated work, propose only the coherent subset.