Skip to content

commandWorkflow

Session Handoff

Writes a handoff note covering what was done, what remains, decisions made and the exact commands to resume work.

npx workspacetemplates add session-handoff --tool claude-code

Writes 1 file to .claude/commands/

.claude/commands/session-handoff.md21 lines · 1.2 KBFile
---
description: Writes a handoff note covering what was done, what remains, decisions made and the exact commands to resume work.
argument-hint: "[extra notes, e.g. waiting on API keys]"
---

Write a handoff note for the work in this repository. Extra notes: $ARGUMENTS

1. Gather facts: `git branch --show-current`, `git status -sb`, `git log --oneline -n 10`, `git diff --stat`, and `git stash list`. Note unpushed commits and uncommitted files.
2. Run the test or build command briefly to learn its current state. Record the exact command and result.
3. Read the changed files enough to describe the work in progress. Find FIXME or HACK markers you added today.
4. Write the note with these headings:
   - **Goal** (one sentence)
   - **Done** (bullets, with commit hashes)
   - **In progress** (files and what is unfinished)
   - **Next steps** (ordered; each with the exact command or file to open)
   - **Decisions and why**
   - **Gotchas** (flaky tests, env variables, things that look wrong but are not)
   - **Open questions**
5. Save it as HANDOFF.md in the repository root only if the user agrees; otherwise print it.

Never commit, push or stash on your own. Ask before writing the file.

What it does

Work stops mid-task all the time: end of day, a teammate takes over, or a fresh agent session starts with no memory. This command captures the state of the work from the repository itself, not from recollection.

The note names the branch, the changes in progress and the next commands to run, so the next person can continue within minutes.

Example

you › /session-handoff waiting on staging DB access

agent › Goal: move invoice export to a background job. Done: queue wired (a3f21c9). In progress: worker.ts retries. Next: npm run test:worker, then finish backoff in worker.ts:58. Gotcha: needs REDIS_URL. Save as HANDOFF.md?

Questions

Does it commit my unfinished work?
No. It only describes the state and leaves commits, stashes and pushes to you.
Where is the note stored?
Printed in chat by default, or in HANDOFF.md if you approve writing it.
  • Debug Error

    CommandWorkflow

    Free
  • Estimate Task

    CommandWorkflow

    Free
  • Explain Code

    CommandWorkflow

    Free
  • Plan Feature

    CommandWorkflow

    Free