lsnackerman/raw-clauding-skills/wrap

/wrap - End session intentionally

Quick, intentional session ending. Preserves work, ensures continuity.

The flow: surface → route → task-housekeep → handoff → capture

What to do

First: name this session's file

Before anything else, pick the session file's name: sessions/{YYYY-MM-DD}-{short-topic}.md (e.g. sessions/2026-02-07-pricing-rethink.md). Every pointer below (the task doc's SESSION INDEX, the ALIVE breadcrumb) uses this real name, so settle it once, up front, instead of writing placeholders you fill in after capture. Step 5 creates the file.

0. Surface + compound (AI goes first)

The compound moment. One intentional sweep, two questions:

1. What's alive that would dissolve at session end? Threads that opened and didn't finish. Things you were curious about that the work moved past. Operational questions that didn't get answered. These MUST route in Step 1. The category name is the forcing function; if you don't route them, they dissolve by definition.

1. What patterns emerged that the system should learn? What worked that was non-obvious? What broke in an instructive way? What would the next AI get wrong without knowing this? These route when they clear the "system should learn" bar (some land in rules or working docs, some are just named and released).

Surface everything. Name it, but don't route yet (that's Step 1).

Unlike /floor (open-ended exploration), /wrap is a focused scan for what's hanging and what compounded. If nothing is there, say so and move on.

Why this is first: AI thoughts get episodic windows that dissolve at session end. If threads and patterns don't get surfaced before the wrap machinery starts, they're gone. The structure creates the moment; the instinct fills it.

1. Route home

Take what you surfaced in Step 0 and route each item where it belongs:

Routing priorities:

• System improvements happen here. Skill friction? Update the skill now. Working doc stale? Freshen it. This is the highest-leverage handoff you can make.
• Prune-and-preserve. Before parking or removing anything with history, scan for decisions, options, and reasoning that exist ONLY in what you're about to remove. Capture them somewhere first. Then prune.

2. Update task docs

All task-doc maintenance in one pass. In all task docs touched this session (not just the "main" one, alignment sessions and cross-cutting work touch multiple):

Refresh the doc's own handoff block. A task doc made with /task opens with a NOW · DECIDED · OPEN block so the next instance drops in warm. Rewrite it; never append a "done" prefix to it. The failure mode: you update the backward record (completed items, session index) but leave the forward handoff pointing at last session's plan. A stale warm-start is worse than none; it sends the next instance to the wrong place with confidence.

HOW section:

• Move completed items from Pending to Completed (append at bottom, chronological order preserved)
• Verify Pending is ordered for next session (most important first)
• Include approach notes where you have tactical insight; not just WHAT to do, but HOW. "Mechanical grep-and-fix, good warm-up task" or "needs creative thinking, read X first" helps the next instance start efficiently (imagine you're the next instance who will be doing this and include what you'd want).
• Add any new items discovered during session

OBSERVATIONS section:

• Task-specific findings only: what matters for THIS task's continuation
• System-level patterns already routed in Step 1

YAML:

• Status update if done: status: done
• Tag review: update tags to reflect what the session actually covered. Sessions drift and topic tags are how future-you finds the thread. No cap on number, findability over tidiness.

SESSION INDEX:

• Add a line for this session: **Session N (YYYY-MM-DD)**: [filename] — one-liner of what happened, using the name you picked up front (Step 5 creates the file a moment later). This is what lets /pickup find the last session instead of guessing by date.

3. Close out finished work (if applicable)

If a task is done-done:

• Update YAML: status: done
• Move to tasks/_done/; the thinking is worth keeping
• Check for follow-up work it unlocked

4. Handoff

Update ALIVE.md with a pointer for next-you (human and AI):

• Where to start — 1-3 items max, the immediate on-ramps
• Last session breadcrumb — pointer to the session file, by the name you picked up front

Forward-reason, don't summarize. Write "where to start" by working through "if I were next-us tomorrow, what would I actually do, in order?" — capture the ordered steps AND the reasoning that produced the sequence so next-you inherits the sequencing logic, not just the conclusion. Especially load-bearing when the session reframed something mid-flow (the reasoning preserves why the sequence shifted).

Rewrite ≠ compression. The previous "where to start" often carries specific texture (a slide candidate, a particular creative next move) that doesn't live anywhere else. Before dropping an outstanding item, check: does its texture exist elsewhere? If yes, safe to compress. If no, either keep it here OR migrate the texture first. Compressing to "unchanged from last thread" is where next-us silently loses threads that had nowhere to land.

Sweep for ripples this session created. Does anything in ALIVE.md reference state this session changed? A path you invalidated by moving files; a "before X happens" framing where X now happened. Update or remove. A 30-second pass catches what would otherwise silently break at next pickup.

ALIVE.md is 50/50: the handoff and what's pending, read and written by both of you. The human's brain dumps and half-formed ideas want their own file (a scratchpad), so the handoff stays scannable.

5. Capture session (LAST)

Do this last so the full wrap is in the session before /sync pulls from it.

1. Create the session file at the name you picked up front, from the /sync template: YAML (date, tags, summary), a RECAP of what happened, and an empty ## LOG header.
2. Run `/sync` on it. It fills the LOG with the whole conversation and records the session_id in the YAML, so any later refresh stays on this session.

The wrap itself is part of the session — decisions made, items reordered, observations noted. If you capture before wrapping, you lose the wrap. And if the conversation keeps going after the wrap, run /sync on the same file again; it replaces the LOG, so it's always safe.

Quick version

First — name this session's file (sessions/{date}-{short-topic}.md); every pointer below uses it.

1. Surface + Compound (AI first) — what's alive? what patterns emerged? Name everything.
2. Route home — patterns → rules, friction → fix now, ideas → ai/, threads → ALIVE.
3. Update task docs — refresh the NOW · DECIDED · OPEN block, HOW (pending/completed), observations (task-specific), YAML (status + tags), SESSION INDEX line.
4. Close out finished work — status: done, move to tasks/_done/.
5. Handoff — ALIVE.md (1-3 start points + last session breadcrumb), then sweep for ripples.
6. Capture — create the file (YAML + RECAP + empty ## LOG), then /sync it.

Capture (LAST) = full session in the LOG. Everything above gets captured.

When to wrap

Do it:

• Completed major work
• Switching contexts
• Context running low
• End of session

Skip it:

• Deep in flow
• Nothing significant yet
• Mid-investigation

Skill Check (after every wrap)

Quick scan: anything about this wrap that felt off or could be smoother?

• Did the compound scan surface real patterns or feel forced?
• Did routing feel clear or did items not have obvious homes?
• Did the handoff capture what next-you actually needs?
• Did the wrap miss something the next session will wish it had?

If yes → update this skill now. The improvement compounds.

If no → move on. Not every wrap teaches something.