handoff-new-session

name	handoff-new-session
description	Use when ending a session and want to spawn a continuation session in agent-deck with inline context

Handoff to New Session

Spawn a continuation session in agent-deck with your current context inline.

When to Use

• End of work session when you want immediate continuation
• Handing off to a parallel agent
• Before context gets too full and you want a fresh session

Process

1. Gather context from the current conversation:

   • What task are you working on?
   • What's been completed?
   • What are the next steps?

2. Call the MCP tool:

   spawn_continuation_session({
     task: "Brief description of current work"
   })
   

3. Report to user:

   • Session name created
   • How to attach: agent-deck then select session, or run in background

Output

Tell the user:

• The session name (e.g., auth-refactor-abc12)
• The handoff ID for reference
• How to attach: launch agent-deck TUI and select the session

Example

User: "I need to stop here, can you hand this off?"

You:

1. Summarize current task from conversation
2. Call spawn_continuation_session({ task: "Implementing OAuth login flow" })
3. Report: "Created session oauth-login-xyz89. Run agent-deck and select it to continue."

Notes

• The new session gets inline context - it can start working immediately
• If claude-mem is running, uses its summary (already synthesized by Haiku)
• Falls back to rolling checkpoint data if claude-mem unavailable
• Handoff is persisted for 7 days in case you need to reference it