Skip to content

feat(wrap): /wrap skill + meta/wrap way for deliberate session close#196

Merged
aaronsb merged 1 commit into
mainfrom
feat/wrap-skill-and-way
Jun 29, 2026
Merged

feat(wrap): /wrap skill + meta/wrap way for deliberate session close#196
aaronsb merged 1 commit into
mainfrom
feat/wrap-skill-and-way

Conversation

@aaronsb

@aaronsb aaronsb commented Jun 29, 2026

Copy link
Copy Markdown
Owner

Summary

Adds the on-demand counterpart to the automatic compaction-checkpoint way — a wrap-up the user triggers when they decide the session is at a seam.

  • skills/wrap/SKILL.md — the procedure: gauge first (ways context; early-vs-late shapes handoff weight) → loose-ends check (ship is iterative, wrap is terminal — wrap doesn't ship) → honest TaskList pass (close done, retire stale, write real remaining with resume-detail) → dense continuation prompt (survives /clear) → gauge-dependent handoff to a directed /compact.
  • hooks/ways/meta/wrap/wrap.md — keyword + semantic router that catches "wrap up / hand this off / done for the day" and points Claude at the skill with the why.
  • Cross-refscompaction-checkpoint and todos now point back at wrap, closing the loop between automatic and on-demand.

Design note

A skill/way cannot self-trigger /compact (Claude Code forbids invoking / commands programmatically), so /wrap prepares everything and hands over a ready-to-run /compact <focus> line. Verified against the docs.

Test plan

  • ways lint hooks/ways — 0 errors, 0 warnings (125 ways)
  • Corpus rebuilt; meta/wrap embedded (154 ways)
  • Keyword trigger fires (ways scan prompt injects the router body)
  • Embedding trigger surfaces meta/wrap near top on non-regex phrasing
  • First real /wrap invocation next session

https://claude.ai/code/session_01TFyiQNDZ8RTMHX4Tnmp1wY

The `compaction-checkpoint` way already handles the automatic, near-limit
checkpoint. This adds the on-demand counterpart: a way the user pulls when
they decide the session is at a seam.

- skills/wrap/SKILL.md — the procedure: read the context gauge first
  (early-vs-late shapes how heavy the handoff is), loose-ends check (ship is
  iterative, wrap is terminal — wrap doesn't ship, it confirms nothing
  stranded), an honest TaskList pass (close done, retire stale, write real
  remaining with resume-detail), a dense continuation prompt that survives
  even /clear, and a gauge-dependent handoff to a directed /compact. A skill
  can't trigger /compact itself, so it hands over a ready-to-run line.

- hooks/ways/meta/wrap/wrap.md — keyword + semantic router that catches
  "wrap up / hand this off / done for the day" and points Claude at the skill
  with the why (the three failure modes of a freehand wrap).

- Cross-refs: compaction-checkpoint and todos now point back at wrap, closing
  the loop between the automatic and on-demand siblings.

Claude-Session: https://claude.ai/code/session_01TFyiQNDZ8RTMHX4Tnmp1wY
@aaronsb aaronsb merged commit fc9ef7f into main Jun 29, 2026
3 checks passed
@aaronsb aaronsb deleted the feat/wrap-skill-and-way branch June 29, 2026 06:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant