Session Handoff

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.

koach08 Updated

File contents

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)

koach08/claude-code-skills/tree/main/skills/workflow/session-handoff commit 40c9246555

Frequently asked questions

npx skillmds@latest add koach08/session-handoff