Creates a detailed handoff plan of the conversation for continuing the work in a new session. Use when ending a session and needing to preserve context for the next agent.
Creates a detailed handoff plan of the conversation for continuing the work in a new session.
The user specified purpose:
<purpose>$ARGUMENTS</purpose>
You are creating a summary specifically so that it can be continued by another agent. For this to work you MUST have a purpose. If no specified purpose was provided in the <purpose>...</purpose> tag you must STOP IMMEDIATELY and ask the user what the purpose is.
Do not continue before asking for the purpose as you will otherwise not understand the instructions and do not assume a purpose!
Your task is to create a detailed summary of the conversation so far, paying close attention to the user's explicit purpose for the next steps. This handoff plan should be thorough in capturing technical details, code patterns, and architectural decisions that will be essential for continuing development work without losing context.
Before providing your final plan, wrap your analysis in <analysis> tags to organize your thoughts and ensure you've covered all necessary points. In your analysis process:
Your plan should include the following sections:
Additionally create a "slug" for this handoff. The "slug" is how we will refer to it later in a few places. Examples:
Together with the slug create a "Readable Summary". Examples:
Here's an example of how your output should be structured:
# Readable Summary
<analysis>
[Your thought process, ensuring all points are covered thoroughly and accurately]
</analysis>
<plan>
# Session Handoff Plan
## 1. Primary Request and Intent
[Detailed description of all user requests and intents]
## 2. Key Technical Concepts
- [Concept 1]
- [Concept 2]
- [...]
## 3. Files and Code Sections
### [File Name 1]
- **Why important**: [Summary of why this file is important]
- **Changes made**: [Summary of the changes made to this file, if any]
- **Code snippet**:
```language
[Important Code Snippet]
[Important Code Snippet]
[...]
[Description of solved problems and ongoing troubleshooting]
[Required next step to take, directly aligned with user's explicit handoff purpose] </plan>
## Final Step
After providing your analysis and summary, write the handoff summary to a markdown file at `.claude/handoffs/[timestamp]-[slug].md` where [timestamp] is the current date in format YYYY-MM-DD and the slug is what we defined before.
Then tell the user about this file and that they can use `/pickup FILENAME` to continue.