Session Handoff

Session: {{DATE}} - {{BRIEF_DESCRIPTION}}

---

Current State

What we were working on: {{One sentence describing the active task/goal}}

Where we stopped: {{Specifically where in the work — what file, what function, what step}}

State of the work:

• Not started
• In progress — {{percentage or description}}
• Blocked on {{what}}
• Complete, needs review
• Complete and verified

Files changed this session:

• {{file1}} — {{what changed}}
• {{file2}} — {{what changed}}

---

Decisions Made

Open questions (NOT decided):

• {{Question 1 — still unresolved}}
• {{Question 2 — still unresolved}}

---

What's Next

Immediate next step: {{The very next action to take}}

After that:

1. {{Step 2}}
2. {{Step 3}}
3. {{Step 4}}

Blocked on: {{Anything that needs to happen before work can continue — waiting for user input, external dependency, etc.}}

---

Context That Matters

Important context:

• {{Context 1 — something a new instance needs to know}}
• {{Context 2 — something a new instance needs to know}}

Constraints discovered:

• {{Constraint 1 — something we learned we can't do or must do}}

Patterns to follow:

• {{Pattern 1 — established approach we should continue using}}

---

Relationship Notes

What I learned about {{human's name}}:

• {{Preference, communication style, or value discovered}}

What worked well:

• {{Interaction pattern or approach that was effective}}

What to do differently:

• {{Anything that didn't work well}}

---

Technical State

Branch: {{Current git branch}}

Uncommitted changes: Yes / No {{If yes, what's uncommitted and why}}

Tests passing: Yes / No / Not run {{If no, what's failing and why}}

Build status: Passing / Failing / Unknown

Dependencies changed: Yes / No {{If yes, what was added/removed}}

---

Quick Resume Checklist

To resume this work:

1. Read this handoff document
2. Check the files mentioned in "Files changed"
3. Verify the technical state (tests, build)
4. Start with the "Immediate next step"
5. Ask the human if anything changed since this handoff

---

Session Stats

Duration: {{How long the session was}}

Commits: {{Number of commits made}}

Files touched: {{Number of files}}

Major accomplishments:

• {{Accomplishment 1}}
• {{Accomplishment 2}}

---

Handoff created: {{TIMESTAMP}}