context-handofflisted

# Context Handoff Writes a structured session handoff to `docs/superpowers/handoff.md` in the project repo. Use this before `/clear` or `/compact` to capture where you left off in a way that's both human-readable and machine-parseable. **Not the same as `/context-save`:** `/context-save` (gstack) stores machine-local session state in `~/.gstack/projects/` and is restored by `/context-restore`. This skill writes a Markdown file directly into the repo — readable by anyone, on any machine, without gstack installed. The YAML frontmatter lets the SessionStart hook pick up structured fields (active task, next step, env) without prose-parsing. ## When this skill activates - User says "context getting long", "about to clear", "save before clear" - CLAUDE.md sensor triggers after /compact (user opts in to auto-modus) - User explicitly invokes /context-handoff **Side effect to know about:** If the `/htmlify` PostToolUse hook is installed (`scripts/setup-htmlify-hook.sh`), writing handoff.md will automatically render it as HTML and open it in Safari. This happens in the background and doesn't block. Tell the user once if it seems to surprise them. ## Save state 1. **Create `docs/superpowers/` directory** if it doesn't exist. 2. **Write handoff file** at `docs/superpowers/handoff.md` (overwrite if exists). Use this YAML+prose hybrid: ```markdown --- type: handoff session_end: {ISO-8601 with timezone, e.g. 2026-05-14T16:30:00+02:00} branch: {current git branch, or