session-handoff

name	session-handoff
description	Generate a handoff note at the end of a work session. Captures current state, completed work, remaining tasks, file paths, and known bugs in a structured format. Use at the end of a work session to create a handoff note for the next session.
allowed-tools	["Read","Write","Edit","Bash","Grep","Glob"]

Session Handoff — End-of-Session Notes

Generate a handoff note at the end of a work session for continuity in the next session.

---

Process

1. Identify the current project directory
2. Run git log to review changes made during this session
3. Run git status to check for uncommitted changes
4. Generate a handoff note in the format below
5. Save to the project's memory directory (e.g., ~/.claude/projects/{project}/memory/)

---

Format

---
name: session_{YYYYMMDD}_handoff
description: {Project name} session handoff ({date})
type: project
---

# Session Handoff: {Project Name} ({YYYY/MM/DD})

## Completed Work
- ...
- ...

## Current State
- Build: passing / errors
- Deployed: yes / no
- Uncommitted changes: yes / no

## Remaining Tasks
1. ...
2. ...

## Key File Paths
- ...

## Known Bugs / Notes
- ...

## Environment Variable Changes
- (list if any)

---

Save Rules

• File name: session_{YYYYMMDD}_handoff.md
• If a handoff for the same day exists, overwrite it
• Update the project's memory index file if one exists
• Suggest cleaning up old handoff notes (older than 2 weeks)