Agent Handoff

Prepare for the next agent or session by documenting your work and leaving the codebase in a good state.

When to Use

• At the end of a work session
• Before switching to a different task
• When handing off to another developer or agent
• When context window is getting full

Steps

1. Commit completed work

   • Stage and commit any finished changes
   • Write clear, descriptive commit messages
   • Don't leave partial work uncommitted unless necessary

2. Document work in progress

   • Add TODO comments for incomplete work
   • Update task lists or issue trackers
   • Note any decisions made and why

3. Summarize the session

   • What was accomplished?
   • What remains to be done?
   • Any blockers or issues encountered?

4. Clean up

   • Remove debugging code or console.logs
   • Delete temporary files
   • Ensure tests pass (or document why they don't)

5. Leave notes for next session

   • What should the next agent focus on?
   • Any context that would be helpful?
   • Links to relevant documentation or issues

Notes

• Leave the codebase in a working state when possible
• Don't leave uncommitted debugging code
• Be explicit about what's done vs what's in progress
• The next agent has no context - write notes accordingly