Session Handoffs

Session handoffs are small operational continuity notes between sessions or collaborators.

They help preserve momentum without pretending every temporary note is durable doctrine.

What Belongs Here

  • current branch or worktree note
  • immediate next step
  • blockers
  • important local assumptions
  • links to the stronger docs or files that matter next

What Does Not Belong Here By Default

  • long-term doctrine
  • glossary definitions
  • architecture rules that should guide future work repeatedly
  • canonical historical records

If a handoff contains a discovery that will matter later, promote that discovery into durable repo memory instead of leaving it only here.

Small Template

# Handoff: <short topic>

## Where Things Are

- branch:
- worktree:
- current task:

## What Changed

- <item>

## Next Likely Step

- <item>

## Blockers Or Risks

- <item>

## Read Next

- <item>