Workflow: Resume from Handoff

<required_reading> Read the handoff file found by context scan. </required_reading>

<purpose> Load context from a handoff file and restore working state. After loading, DELETE the handoff - it's a parking lot, not permanent storage. </purpose> <process> <step name="locate_handoff"> Context scan already found handoff. Read it:

cat .planning/phases/*/.continue-here.md 2>/dev/null

Parse YAML frontmatter for: phase, task, status, last_updated Parse markdown body for: context, completed work, remaining work </step>

<step name="calculate_time_ago"> Convert `last_updated` to human-readable: - "3 hours ago" - "Yesterday" - "5 days ago"

If > 2 weeks, warn: "This handoff is [X] old. Code may have changed." </step>

<step name="present_summary"> Display to user:

Resuming: Phase [X] - [Name]
Last updated: [time ago]

Task [N] of [Total]: [Task name]
Status: [in_progress/blocked/etc]

Completed this phase:
- [task 1]
- [task 2]

Remaining:
- [task 3] ← You are here
- [task 4]

Context notes:
[Key decisions, blockers, mental state from handoff]

Ready to continue? (1) Yes (2) See full handoff (3) Different action

</step> <step name="user_confirms"> **WAIT for user confirmation.** Do not auto-proceed.

On confirmation:

1. Load relevant files mentioned in handoff
2. Delete the handoff file
3. Continue from where we left off </step>

<step name="delete_handoff"> After user confirms and context is loaded:

rm .planning/phases/XX-name/.continue-here.md

Tell user: "Handoff loaded and cleared. Let's continue." </step>

<step name="continue_work"> Based on handoff state: - If mid-task: Continue that task - If between tasks: Start next task - If blocked: Address blocker first

Offer: "Continue with [next action]?" </step>

</process>

<stale_handoff> If handoff is > 2 weeks old:

Warning: This handoff is [X days] old.

The codebase may have changed. Recommend:
1. Review what's changed (git log)
2. Discard handoff, reassess from PLAN.md
3. Continue anyway (risky)

</stale_handoff>

<multiple_handoffs> If multiple .continue-here.md files found:

Found multiple handoffs:
1. phases/02-auth/.continue-here.md (3 hours ago)
2. phases/01-setup/.continue-here.md (2 days ago)

Which one? (likely want #1, the most recent)

Most recent is usually correct. Older ones may be stale/forgotten. </multiple_handoffs>

<success_criteria> Resume is complete when:

• Handoff located and parsed
• Time-ago displayed
• Summary presented to user
• User explicitly confirmed
• Handoff file deleted
• Context loaded, ready to continue </success_criteria>