/handoff

Handoff — Session Continuation

Generate a structured handoff document so the next session can pick up exactly where this one left off.

Process

Step 1: Gather State

• Read .claude/omo/boulder.json for current execution state
• Check TodoWrite for any active todo lists
• Review recent git changes: git diff --stat HEAD~5 and git log --oneline -10

Step 2: Extract Context

Review the conversation to identify:

• What the user originally requested
• What has been accomplished
• What remains to be done
• Key decisions made and their rationale
• Blockers or issues discovered
• Files that were modified

Step 3: Write Handoff Document

Write to .claude/omo/handoffs/{timestamp}.md:

# Session Handoff — {date}

## User Request
{Original task/goal}

## What Was Accomplished
- {completed item 1}
- {completed item 2}

## Current State
- boulder.json status: {status}
- Active plan: {plan file or "none"}
- Active todos: {count remaining}

## What Remains
- [ ] {pending item 1}
- [ ] {pending item 2}

## Key Decisions
- {decision}: {rationale}

## Modified Files
- `path/to/file` — {what changed}

## Blockers / Issues
- {blocker or "none"}

## Resume Instructions
{Exactly what the next session should do first}

Step 4: Present Summary

Show the user a brief summary and the handoff file path.

Rules

• Be specific — "modified the auth middleware" not "made some changes"
• Include file paths for everything
• Resume instructions should be actionable, not vague