# Always sync beads first
bd sync

# Check for in-progress work
bd list --status in_progress --json

# Check for ready work
bd ready --json

bd sync
bd ready --json      # Shows next unblocked task
bd list --status in_progress --json  # Any in-progress?

1. Sync beads state
2. Check in-progress tasks (pick up where left off)
3. Check ready tasks (next unblocked work)
4. Announce: "Resuming: [task title]"
5. Continue with implement-plan workflow

## Resuming from Beads

### In Progress
- bd-a1b2: "Login endpoint" (started earlier)

### Ready Next
- bd-c3d4: "Logout endpoint"
- bd-e5f6: "Register endpoint"

### Blocked (waiting on above)
- bd-g7h8: "Integration tests" [blocked by: bd-c3d4]

Continuing with bd-a1b2...

1. Read handoff document completely
2. Parse and understand:
   - What was done (completed items)
   - What was in progress (current state)
   - Key decisions made
   - Open blockers/questions
3. Read referenced artifacts:
   - Plan file (if referenced)
   - TODO.md
   - Active files mentioned

# Pull latest state (may have changed since handoff)
bd sync

# See what's ready to work on
bd ready --json

# Cross-reference with handoff's beads state
# Note any changes since handoff was created

4. Verify current state matches handoff:
   - Check commits exist
   - Confirm files are in expected state
   - Note any drift since handoff
   - If using beads: check for task state changes

5. Check for user responses:
   - Were blockers resolved?
   - Any new instructions?
   - Decisions filled in?

6. Announce resumption:
   "Resuming [Task Name] from handoff dated [date]

   **Previous Progress:**
   - [x] Item 1
   - [x] Item 2

   **Continuing With:**
   - [ ] Next item (priority 1)

   **Open Questions:**
   - [Any pending questions]

   Proceeding with [first next step]..."

7. Start with first item in "Next Steps"
8. Follow implement-plan workflow:
   - Mark in_progress in TODO.md
   - Implement
   - Test
   - Commit
   - Mark complete
9. Continue through remaining steps

If handoff listed blockers that aren't resolved:
1. Highlight pending blockers
2. Ask user for resolution
3. Continue with non-blocked items if possible
4. Create new handoff if can't proceed

If repo state differs from handoff:
1. Note the differences
2. Determine if changes conflict or complement
3. Ask user for guidance if unclear
4. Update handoff understanding accordingly

If referenced plan has new changes:
1. Re-read the plan
2. Identify new steps or modified requirements
3. Update TODO.md to reflect changes
4. Proceed with updated understanding

If multiple handoff files:
1. List available handoffs with dates
2. Ask user which to resume
3. Or resume most recent by default

## Resuming: [Task Name]

**Handoff from**: YYYY-MM-DD
**Time since handoff**: [X hours/days]

### Progress Restored
| Status | Item |
|--------|------|
| Done | Item 1 |
| Done | Item 2 |
| **Resuming** | Item 3 |
| Pending | Item 4 |

### Context Restored
- [Key decision 1]
- [Key decision 2]

### Blockers Status
- [Blocker 1]: [Resolved/Still pending]

### Immediate Next Action
[What you're about to do]

---
Proceeding...

# List recent handoffs
ls -la thoughts/shared/handoffs/

# Show most recent
ls -t thoughts/shared/handoffs/ | head -1

# Search by keyword
grep -l "keyword" thoughts/shared/handoffs/*.md