From aura-frog
Saves current workflow state, context summary, git branch/commit/changes, deliverables, and pending tasks to .claude/logs files for new session resumption.
How this command is triggered — by the user, by Claude, or both
Slash command
/aura-frog:handoffworkflow/The summary Claude sees in its command listing — used to decide when to auto-load this command
# Command: workflow:handoff **Purpose:** Prepare workflow for continuation in new session **Aliases:** `handoff`, `save context`, `checkpoint` --- ## Usage --- ## When to Use --- ## What Gets Saved --- ## Output Files --- ## HANDOFF_CONTEXT.md Structure --- ## Resume ---
Purpose: Prepare workflow for continuation in new session
Aliases: handoff, save context, checkpoint
workflow:handoff
"Save context for handoff"
"Checkpoint workflow"
triggers[4]{condition,action}:
Token > 150K (75%),Run handoff proactively
Token > 160K (80%),Warning shown automatically
Before break,Save progress
Multi-day project,Regular checkpoints
saved_data[5]{category,content}:
State,workflow-state.json (phase + progress + tokens)
Context,HANDOFF_CONTEXT.md (summary for next session)
Git,Branch + commit + uncommitted changes
Deliverables,All phase outputs so far
Pending,Outstanding tasks + next steps
.claude/logs/workflows/{workflow-id}/
├── workflow-state.json # Machine-readable state
├── HANDOFF_CONTEXT.md # Human-readable summary
├── task-context.md # Original requirements
└── deliverables/ # All phase outputs
sections[6]{section,content}:
Summary,What was accomplished
Current Phase,Where we stopped
Pending Tasks,What remains to do
Key Decisions,Important choices made
Next Steps,How to continue
Resume Command,Exact command to run
workflow:resume {workflow-id}
npx claudepluginhub nguyenthienthanh/aura-frog --plugin aura-frog/checkpointSaves current workflow state by identifying active workflows, updating progress, reconciling with git worktree, and outputting a markdown checkpoint summary with phase details and resume instructions.
/handoffGenerates a context handoff brief for session continuation, saving state, decisions, and next steps as a markdown file with git hygiene checks.
/pause-workCreates a .continue-here.md handoff file preserving complete work state across sessions, including phase detection, progress, blockers, and decisions. Also supports generating a session report via --report.
/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 handoff document summarizing git state, workflow artifacts from .agents/, session context, tasks, phase, critical files, and next steps; saves to .agents/handoff-YYYY-MM-DD-HH-MM-slug.md
/context-saveCompacts session or saves full handoff to .handoff/ file with progress summary, git state, and next steps when context pressure detected.