handoff

name	handoff
description	Prepare a session handoff — summarize progress, annotate tasks with current status, and identify what's ready for the next session. Use at the end of a work session or when the user says they're done for now.

Session Handoff

Prepare context for the next session so work can continue seamlessly.

Process

1. Review active tasks — call task_list with filter +ACTIVE to find tasks that were being worked on. Use the UUIDs from that response for the calls below; do not rely on UUIDs you remember from earlier in the session. For each task in the result:

   • Use task_annotate to record what was accomplished and what remains
   • Use task_stop to mark it as no longer active

2. Review pending tasks — call task_list with filter status:pending to see the full backlog. Note any tasks whose status has changed based on work done this session.

3. Log unplanned work — if work was done that wasn't tracked as a task, use task_log to record it retroactively with appropriate project and tags.

4. Update blocked tasks — if any blockers were resolved this session, use task_modify to remove dependencies or update descriptions.

5. Present the handoff summary:

   • Done this session: tasks completed or logged
   • Progress made: annotations added to in-progress tasks
   • Ready to pick up next: pending tasks sorted by priority that aren't blocked
   • Blockers: any tasks that are blocked and why

Keep the summary concise — the goal is to give the next session (or agent) a clear starting point.