Handoff Resume

Resume work from a previous session's handoff document. Read, understand, summarize, and WAIT for user confirmation before taking any action.

Optional argument: If $ARGUMENTS is provided, use it as an alternative path to the handoff file (e.g., /handoff:resume .context/HANDOFF-feature.md).

Instructions

Step 1: Locate and Read Context Files

1. MEMORY.md (MANDATORY if exists)

   • Check for MEMORY.md in project root
   • If found, read it FIRST - this contains persistent project context
   • If not found, continue without it

2. HANDOFF.md

   • Check for HANDOFF.md in project root
   • If $ARGUMENTS provided, use that path instead
   • If not found, ask user for the handoff file location

3. Verify Repository State

   git status
   git log --oneline -5

   • Compare current state with what HANDOFF.md describes
   • Note any commits or changes made since handoff was created
   • Alert user if significant drift detected

Step 2: Analyze and Summarize

Present a structured summary to the user:

## Session Resume Summary

**Previous Session Focus:** [1-line from handoff]

**Goal:** [The objective we're working toward]

**Progress Status:**
- Completed: [X items]
- In Progress: [what was active]
- Remaining: [Y items]

**Current State:**
- Last active file: [file]
- Last active task: [task]
- Any blockers: [blocker or "None"]

**Critical Context:**
- [Key decision 1 from handoff]
- [Key decision 2 from handoff]

**Issues to Remember (DO NOT REPEAT):**
- [Issue 1 and its solution]
- [Failed approach 1 - avoid this]

**Proposed Next Steps:**
1. [First action I will take]
2. [Second action I will take]
3. [...]

**State Drift Check:** [None detected / Changes detected: ...]

Step 3: Wait for Confirmation

After presenting the summary, ask:

"I've reviewed the handoff and am ready to continue. The next step is: [specific action]

Should I proceed, or would you like to adjust the plan?"

DO NOT start executing until the user explicitly confirms.

Step 4: Upon Confirmation

1. Recreate the todo list from the handoff using TodoWrite
2. Mark the current task as in_progress
3. Begin work on the first resume instruction
4. Reference the "Issues & Solutions" and "Failed Approaches" sections to avoid repeating mistakes

Important Rules

• NEVER auto-start - Always wait for user confirmation
• ALWAYS check MEMORY.md first if it exists
• ALWAYS verify git state matches handoff expectations
• Reference failed approaches before attempting solutions
• Ask for clarification on anything ambiguous rather than assuming