datit309/supergraph / plugins/supergraph/skills/handoff
handoff
UnverifiedCompact current session context into a handoff document for seamless continuation in a new session. Use when context window is exhausted, switching machines, handing work to another agent, or ending a long session mid-task.
/supergraph:handoff
Compress session state to a compact document. The next session picks up exactly where this one left off.
Announce: "π¦ /supergraph:handoff β compacting session state..."
Steps
1. Capture current state
Gather live state β do not rely on memory:
git status --short
git log --oneline -10
Read active plan file (if any) from docs/supergraph/plans/.
2. Write handoff document
Save to $TMPDIR/supergraph-handoff-<YYYY-MM-DD>.md β NOT in the workspace (avoids accidental commits).
# Supergraph Handoff β <YYYY-MM-DD>
## Goal
[One sentence: what we were trying to accomplish]
## Status
[In-progress / Blocked / Ready for next phase]
## Active Plan
Path: [docs/supergraph/plans/<slug>.md]
Current task: Task N β [description]
Remaining tasks: [list with Status values]
## What Was Done
- [Completed task summaries β brief, no code]
## What Is Left
- [Remaining tasks, in order]
- [Any stuck tasks and why]
## Blockers / Open Questions
- [List β or "none"]
## Key Files Changed
- [path] β [what changed, one line]
## Git State
Branch: [branch name]
Last commit: [hash] [message]
Uncommitted: [list or "none"]
## Environment Context
[Copy from plan's Environment Context section]
## Suggested Skills for Next Session
1. /supergraph:scan (always first)
2. /supergraph:execute plan <slug> (continue tasks)
or /supergraph:tdd (if resuming single task)
3. /supergraph:fix β /supergraph:verify β /supergraph:review
## Notes
[Anything non-obvious a fresh agent needs to know]
Rules for content:
- Reference artifacts by path or URL only β never duplicate code or file content
- Keep the document under 150 lines
- No session-specific context (e.g., "as I said earlier") β self-contained
3. Report handoff location
β
/supergraph:handoff complete
- Document: $TMPDIR/supergraph-handoff-<date>.md
- Status: [current status]
- Resume: /supergraph:scan β read handoff doc β /supergraph:execute plan <slug>
Rules
- Never save to workspace β always
$TMPDIR - References only, no content duplication
- Under 150 lines β force brevity
- Always include "Suggested Skills" so the next session has a clear entry point
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |