# Handoff Template

Use this template when saving progress with `/workflow:save`.

---

```markdown
# Handoff Document

**Branch:** [branch-name]
**Last Updated:** [YYYY-MM-DD HH:MM]
**Goal:** [What we're trying to accomplish]

---

## Progress

### Completed
- [x] Task 1: Brief description
- [x] Task 2: Brief description

### In Progress
- [ ] Task 3: Brief description
  - Started: [what's done]
  - Remaining: [what's left]

### Not Started
- [ ] Task 4: Brief description
- [ ] Task 5: Brief description

---

## Key Decisions

### Decision 1: [Title]
**Context:** Why this decision was needed
**Choice:** What was decided
**Rationale:** Why this option was chosen

### Decision 2: [Title]
**Context:** ...
**Choice:** ...
**Rationale:** ...

---

## Files Modified

| File | Changes |
|------|---------|
| `path/to/file1.ts` | Added feature X |
| `path/to/file2.ts` | Fixed bug Y |
| `path/to/file3.ts` | Refactored Z |

---

## Current State

### Working
- Feature A is functional
- Tests pass

### Not Working
- Feature B has a bug in edge case
- Test for C is flaky

### Uncommitted Changes
```
M src/utils.ts
M src/api/client.ts
?? src/new-file.ts
```

---

## Blockers

- [ ] Blocker 1: Description and what's needed to unblock
- [ ] Blocker 2: Description

---

## Next Steps

1. **Immediate**: First thing to do when resuming
2. **Then**: Second priority
3. **Later**: Can be done after main task

---

## Notes

### Important Context
- Note 1: Something important to remember
- Note 2: A gotcha or edge case

### Links
- Issue: #123
- PR: #456
- Docs: https://...

### Questions for User
- Question 1?
- Question 2?
```

---

## Minimal Handoff

For quick saves:

```markdown
# Handoff

**Branch:** feature/xyz
**Goal:** Implement user preferences

## Done
- [x] Database schema
- [x] API endpoint

## Next
1. Add frontend form
2. Write tests

## Notes
- Using Zustand for state (user preference)
- Validation schema in src/lib/validators.ts
```