Files
2025-11-29 18:28:37 +08:00

2.6 KiB

Workflow: Resume from Handoff

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

Load context from a handoff file and restore working state. After loading, DELETE the handoff - it's a parking lot, not permanent storage. 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

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."

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
**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
After user confirms and context is loaded:
rm .planning/phases/XX-name/.continue-here.md

Tell user: "Handoff loaded and cleared. Let's continue."

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]?"

<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>