session-handoff

# Session Handoff Protocol

## When This Skill Activates
- "Save this session", "I need to continue later"
- "Switching to Cursor/Windsurf/VS Code"
- "What did we accomplish?"
- "End of session", "wrapping up"
- "Summarize what we did"

## Session Start Checklist

### When Starting a Session:
1. **Check for previous session notes**
```bash
# Look for session files
find . -name "SESSION-*.md" -mtime -7 | head -5
cat .claude/session-notes.md 2>/dev/null || echo "No previous session"
```

2. **Check git for recent context**
```bash
git log --oneline -10
git status
```

3. **Review open tasks**
```bash
grep -r "TODO:" --include="*.ts" --include="*.tsx" | head -10
```

## Session Handoff Document

When user ends session or switches IDE, create this document:

```markdown
# Session Handoff: [Date]

## What Was Accomplished
- [x] [Completed task 1]
- [x] [Completed task 2]
- [ ] [Started but not finished]

## Current State
- **Working on**: [Current task]
- **Branch**: [git branch name]
- **Last file modified**: [file path]
- **Uncommitted changes**: [yes/no, what]

## Key Decisions Made
1. **[Decision]**: [Rationale]
2. **[Decision]**: [Rationale]

## Open Issues / Blockers
- [ ] [Issue 1]: [Why blocked]
- [ ] [Issue 2]: [Next step needed]

## For Next Session
1. [Priority 1 - Must do first]
2. [Priority 2]
3. [Priority 3]

## Context Files to Review
- `path/to/important/file.ts` - [Why important]
- `path/to/another.ts` - [Why important]

## Commands to Remember
```bash
# Start dev server
npm run dev

# Run specific test
npm test -- path/to/test.ts
```

## Notes
[Any additional context the next session needs]
```

## Quick Handoff Commands

### Save Session State
```bash
# Create session file
cat > .claude/session-$(date +%Y%m%d).md << 'EOF'
# Session: $(date)

## Status
[Current state]

## Next Steps
[What to do next]
EOF
```

### Git-Based Context
```bash
# Create WIP commit with context
git add -A
git commit -m "WIP: [description]

Session context:
- Working on: [feature]
- Next step: [what to do]
- Blocked by: [if any]"
```

## Cipher Memory Integration

For cross-IDE persistence, store in Cipher:
```
Use cipher_ask_cipher to store:
- Key decisions made
- Patterns discovered
- Blockers encountered
- Solutions found

Always include projectPath: "/path/to/your/project"
```

### Store Session Summary
```javascript
cipher_ask_cipher({
  message: `SESSION SUMMARY for [project]:

  Accomplished:
  - [task 1]
  - [task 2]

  Decisions:
  - [decision]: [why]

  Next session:
  - [priority task]

  Blockers:
  - [if any]`,
  projectPath: "/path/to/your/project"
})
```

### Recall Previous Session
```javascript
cipher_ask_cipher({
  message: "Recall the last session for this project. What was accomplished and what should I focus on?",
  projectPath: "/path/to/your/project"
})
```

## IDE Switch Protocol

When switching between Claude Code, Cursor, Windsurf, etc:

1. **Before leaving current IDE**:
   - Save session notes
   - Commit or stash changes
   - Store key context in Cipher

2. **When entering new IDE**:
   - Read session notes
   - Recall from Cipher
   - Check git status
   - Review TODO list

## Quick Session Summary Format

For fast handoffs:
```
STATUS: [Working/Blocked/Done]
TASK: [What you were doing]
NEXT: [Immediate next action]
FILES: [Key files touched]
NOTES: [Anything important]
```

## Key Principle
The goal is seamless continuity. The next session (in any IDE) should be able to pick up exactly where this one left off without re-explaining context.