MCPGateway: Skill for Claude Code

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

# Look for session files
find . -name "SESSION-*.md" -mtime -7 | head -5
cat .claude/session-notes.md 2>/dev/null || echo "No previous session"

1. Check git for recent context

git log --oneline -10
git status

1. Review open tasks

grep -r "TODO:" --include="*.ts" --include="*.tsx" | head -10

Session Handoff Document

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

# 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

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