Handoff

Create a handoff document capturing current session state for later resumption.

Usage

/handoff "Completed auth module, tests passing"
/handoff "WIP: Refactoring payment service, 60% done"

What Gets Captured

• Summary: Your provided description
• Status: complete, in_progress, blocked
• Session ID: For tracking
• Timestamp: When created
• Context: Recent work summary

Execute

Run the handoff script:

"${CLAUDE_PLUGIN_ROOT}/scripts/memory.sh" handoff \
  --summary "$ARGUMENTS" \
  --session "$CLAUDE_SESSION_ID"

Handoff Format

The handoff is stored as YAML:

---
id: handoff-2024-01-15-auth
session_name: auth-implementation
status: complete
created_at: 2024-01-15T10:30:00Z
---

# Session Handoff

## Summary
Completed auth module, tests passing

## What Was Done
- Implemented JWT authentication
- Added refresh token rotation
- Created auth middleware
- Wrote 15 unit tests (all passing)

## Files Modified
- src/auth/jwt.ts
- src/middleware/auth.ts
- tests/auth/*.test.ts

## Next Steps
1. Deploy to staging
2. Run integration tests
3. Update API documentation

## Open Questions
- Should we add OAuth providers?

After Creating

Confirm to user:

• Handoff ID for resumption
• Quick summary of what was captured
• Command to resume: /resume <id>

Auto-Handoff

The pre-compact-save hook automatically creates handoffs before context compaction to prevent losing work.