handoff

name	handoff
description	Update TPP for engineer handoff when context is running low. Use when ending a session, running out of context, or switching to a different task.
disable-model-invocation	false
allowed-tools	Read, Edit, Write, Glob, Grep

TPP Handoff

We're out of time or context and need to hand off the remaining work so the next session can pick up exactly where we left off.

Required Reading First

Before any work, you MUST read:

• AGENTS.md — project conventions, critical knowledge, anti-patterns, and CI/CD constraints
• doc/TPP-GUIDE.md — how TPPs work in this project
• doc/C++_REVIEW_TODO.md — C++ review checklist (when native code was touched)

Your Task

1. Find the active TPP in _todo/ (use Glob for _todo/*.md)
2. Re-read the TPP thoroughly
3. Update it with everything the next session needs to know:

Progress Update

• Mark completed tasks with [x]
• Update the "Current phase" checklist
• Note partial progress on in-flight tasks

Discoveries & Lore

• Add non-obvious findings to the Lore section
• Document any gotchas encountered
• Record platform-specific behaviors discovered

Failed Approaches

• Document what was tried and didn't work, and WHY
• This prevents the next session from repeating mistakes

Remaining Work

• Clarify what remains and the recommended next step
• Note any blockers or open questions
• If the approach changed from the original plan, explain why

Context for Next Session

• Add a "Next steps" section at the top of the Tasks list
• Include file paths and line numbers for work in progress
• Reference any relevant test output or error messages

Quality Check

Before finishing, verify the TPP answers these questions:

• Could a new session pick this up cold and make progress immediately?
• Are all dead ends documented so they won't be re-explored?
• Is the current state of the code accurately reflected?