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
- •
Commit completed work
- •Stage and commit any finished changes
- •Write clear, descriptive commit messages
- •Don't leave partial work uncommitted unless necessary
- •
Document work in progress
- •Add TODO comments for incomplete work
- •Update task lists or issue trackers
- •Note any decisions made and why
- •
Summarize the session
- •What was accomplished?
- •What remains to be done?
- •Any blockers or issues encountered?
- •
Clean up
- •Remove debugging code or console.logs
- •Delete temporary files
- •Ensure tests pass (or document why they don't)
- •
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