Generates structured Markdown handoff document with git status, session progress, learnings, files touched, and resume instructions for another Claude session. Supports --full and --compact modes.
From pro-workflownpx claudepluginhub rohitg00/pro-workflow --plugin pro-workflow/handoffEnds swarm session: summarizes work/blockers, persists state via hivemind_store and git, cleans agents/tasks/reservations, updates hive, generates handoff note.
/handoffGenerates a developer handoff package for the specified screen, feature, or component, including visual specs, interaction specs, QA checklist, assets, and notes.
/handoffSaves session state snapshot as structured JSON to docs/tasks/<branch>/session_logs/<timestamp>_handoff.json, capturing git status, progress summary, tasks, and context for resume.
/handoffCreates a detailed handoff plan summarizing conversation, technical details, code, decisions, and next steps for continuing work in a new session.
/handoffCreates handoff branch from main, scratchpad with analysis/plan/files/testing, PR, roadmap entry, and copy-paste worker prompt for task delegation.
/handoffCreates a scannable handoff note for session continuity by running a bun script, then populating Done (accomplishments), State (current status), and Next (checkbox steps) sections.
Generate a structured handoff document that another Claude session (or your future self) can consume immediately to continue where you left off.
/handoff
/handoff --full
/handoff --compact
When the user runs /handoff:
Gather current state:
git status and git diff --stat to see uncommitted workgit log --oneline -5 to see recent commits this sessionQuery learnings captured this session:
sqlite3 ~/.pro-workflow/data.db "
SELECT category, rule, mistake, correction
FROM learnings
WHERE created_at >= datetime('now', '-4 hours')
ORDER BY created_at DESC
"
Generate the handoff document:
# Session Handoff — [date] [time]
## Status
- **Branch**: feature/xyz
- **Commits this session**: 3
- **Uncommitted changes**: 2 files modified
- **Tests**: passing / failing / not run
## What's Done
- [completed task 1]
- [completed task 2]
## What's In Progress
- [current task with context on where you stopped]
- [file:line that needs attention next]
## What's Pending
- [next task that hasn't been started]
- [blocked items with reason]
## Key Decisions Made
- [decision 1 and why]
- [decision 2 and why]
## Learnings Captured
- [Category] Rule (from this session)
## Files Touched
- `path/to/file1.ts` — [what changed]
- `path/to/file2.ts` — [what changed]
## Gotchas for Next Session
- [thing that tripped you up]
- [non-obvious behavior discovered]
## Resume Command
Copy this into your next session:
> Continue working on [branch]. [1-2 sentence context]. Next step: [specific action].
~/.pro-workflow/handoffs/[date]-[branch].md/wrap-up is a checklist to close a session properly. /handoff is a document designed to be consumed by the next session — it's written for the reader, not the writer.
/wrap-up - End-of-session checklist (do this first, then handoff)/replay - Surface past learnings when starting a new session/insights - Session analyticsTrigger: Use when user says "handoff", "hand off", "pass to next session", "create handoff", "session transfer", "continue later", or when ending a session and wants to resume smoothly.