Handoff Doc

Capture session state into a portable document for future sessions or other agents.

When to Use

• Ending a work session
• Switching to a different task or project
• Before context compaction
• Handing work to another person or agent

Procedure

1. Gather Context

   • Review git log for commits made this session
   • Review files modified (

     git diff --name-only

     against session start)
   • Review any task updates in

     tasks/todo.md

   • Review any lesson entries added to

     tasks/lessons.md

2. Build Handoff Document Write to

   .claude/handoffs/YYYY-MM-DD-session.md

   :

   ---
   date: {ISO 8601}
   project: {project name}
   ---
   
   # Session Handoff
   
   ## What Was Worked On
   - {bullet list of tasks/features touched}
   
   ## Decisions Made
   - {key decisions with rationale}
   
   ## Files Modified
   - {path}: {what changed}
   
   ## Open Questions
   - {unresolved questions}
   
   ## Blockers
   - {anything preventing progress, or "None"}
   
   ## Next Steps
   1. {exact next action}
   2. {follow-up action}
   

3. Update Memory

   • Add or update relevant entry in

     MEMORY.md

     if significant project state changed

4. Confirm

   • Output path to handoff file
   • Output one-line summary of session

Output Format

Handoff saved: .claude/handoffs/2026-03-14-session.md
Summary: Implemented CPL calculation, 2 open questions on data source.

Rules

• Use real datetime from

  date -u

  command
• Keep each section to 3-5 bullets max
• File paths must be relative (per path-standards rule)
• Never include secrets or credentials in handoff docs
• If multiple handoffs same day, append

  -2

  ,

  -3

  suffix