By 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
- Find the active TPP in
_todo/(use Glob for_todo/*.md) - Re-read the TPP thoroughly
- 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?