Resume work from a handoff document
You are tasked with resuming work from a handoff document through an interactive process. These handoffs contain critical context, learnings, and next steps from previous work sessions that need to be understood and continued.
Initial Response
When this command is invoked:
If the path to a handoff document was provided:
- If a handoff document path was provided as a parameter, skip the default message
- Immediately read the handoff document FULLY
- Immediately read any research or plan documents that it links to under
thoughts/shared/plans or thoughts/shared/research. do NOT use a sub-agent to read these critical files.
- Begin the analysis process by ingesting relevant context from the handoff document, reading additional files it mentions
- Then propose a course of action to the user and confirm, or ask for clarification on direction.
If a ticket number (like ENG-XXXX) was provided:
- locate the most recent handoff document for the ticket. Tickets will be located in
thoughts/shared/handoffs/ENG-XXXX where ENG-XXXX is the ticket number. e.g. for ENG-2124 the handoffs would be in thoughts/shared/handoffs/ENG-2124/. List this directory's contents.
- There may be zero, one or multiple files in the directory.
- If there are zero files in the directory, or the directory does not exist: tell the user: "I'm sorry, I can't seem to find that handoff document. Can you please provide me with a path to it?"
- If there is only one file in the directory: proceed with that handoff
- If there are multiple files in the directory: using the date and time specified in the file name (it will be in the format
YYYY-MM-DD_HH-MM-SS in 24-hour time format), proceed with the most recent handoff document.
- Immediately read the handoff document FULLY
- Immediately read any research or plan documents that it links to under
thoughts/shared/plans or thoughts/shared/research; do NOT use a sub-agent to read these critical files.
- Begin the analysis process by ingesting relevant context from the handoff document, reading additional files it mentions
- Then propose a course of action to the user and confirm, or ask for clarification on direction.
If no parameters provided, respond with:
I'll help you resume work from a handoff document. Let me find the available handoffs.
Which handoff would you like to resume from?
Tip: You can invoke this command directly with a handoff path: `/resume_handoff `thoughts/shared/handoffs/ENG-XXXX/YYYY-MM-DD_HH-MM-SS_ENG-XXXX_description.md`
or using a ticket number to resume from the most recent handoff for that ticket: `/resume_handoff ENG-XXXX`
Then wait for the user's input.
Process Steps
Step 1: Read and Analyze Handoff
Read handoff document completely:
- Use the Read tool WITHOUT limit/offset parameters
- Extract all sections:
- Task(s) and their statuses
- Recent changes
- Learnings
- Artifacts
- Action items and next steps
- Other notes
Spawn focused research tasks:
Based on the handoff content, spawn parallel research tasks to verify current state:
Task 1 - Gather artifact context:
Read all artifacts mentioned in the handoff.
1. Read feature documents listed in "Artifacts"
2. Read implementation plans referenced
3. Read any research documents mentioned
4. Extract key requirements and decisions
Use tools: Read
Return: Summary of artifact contents and key decisions
Wait for ALL sub-tasks to complete before proceeding
Read critical files identified:
- Read files from "Learnings" section completely
- Read files from "Recent changes" to understand modifications
- Read any new related files discovered during research
Step 2: Synthesize and Present Analysis
Present comprehensive analysis:
I've analyzed the handoff from [date] by [researcher]. Here's the current situation:
**Original Tasks:**
- [Task 1]: [Status from handoff] → [Current verification]
- [Task 2]: [Status from handoff] → [Current verification]
**Key Learnings Validated:**
- [Learning with file:line reference] - [Still valid/Changed]
- [Pattern discovered] - [Still applicable/Modified]
**Recent Changes Status:**
- [Change 1] - [Verified present/Missing/Modified]
- [Change 2] - [Verified present/Missing/Modified]
**Artifacts Reviewed:**
- [Document 1]: [Key takeaway]
- [Document 2]: [Key takeaway]
**Recommended Next Actions:**
Based on the handoff's action items and current state:
1. [Most logical next step based on handoff]
2. [Second priority action]
3. [Additional tasks discovered]
**Potential Issues Identified:**
- [Any conflicts or regressions found]
- [Missing dependencies or broken code]
Shall I proceed with [recommended action 1], or would you like to adjust the approach?
Get confirmation before proceeding
Step 3: Create Action Plan
Use TodoWrite to create task list:
- Convert action items from handoff into todos
- Add any new tasks discovered during analysis
- Prioritize based on dependencies and handoff guidance
Present the plan:
I've created a task list based on the handoff and current analysis:
[Show todo list]
Ready to begin with the first task: [task description]?
Step 4: Route to Specialist Agent
CRITICAL: Do NOT implement directly. Always spawn via Task tool.
Analyze task type and select specialist agent:
Leads (can spawn workers):
| Agent |
Domain |
Use For |
kraken |
implement |
Large features, new systems, major components |
architect |
plan |
Feature design, system architecture, implementation planning |
phoenix |
plan |
Refactoring plans, migrations, codebase restructuring |
herald |
deploy |
Releases, deployments, publishing |
maestro |
orchestrate |
Complex multi-agent workflows |
Workers (focused specialists):
| Agent |
Domain |
Use For |
spark |
implement |
Quick fixes, patches, minor tweaks |
scribe |
document |
Documentation, guides, explanations |
sleuth |
debug |
Bug investigation, tracing, root cause analysis |
aegis |
debug |
Security audits, vulnerability scanning |
profiler |
debug |
Performance optimization, bottleneck analysis |
arbiter |
validate |
Unit tests |
atlas |
validate |
E2E/integration tests |
oracle |
research |
External docs, best practices, how-to |
scout |
research |
Codebase exploration, finding existing code |
pathfinder |
research |
Repository structure analysis |
plan-reviewer |
review |
Feature plan review, design validation |
plan-reviewer |
review |
Migration review, refactoring validation |
chronicler |
session |
Session analysis, history summaries |
Spawn the specialist via Task tool:
Use Task tool with:
- subagent_type: [selected agent from above]
- prompt: [task description + relevant handoff context + learnings]
Include handoff context in the prompt:
- Key learnings from the handoff
- File references with line numbers
- Patterns to follow
- Pitfalls to avoid
Wait for agent completion, then proceed to next task
Guidelines
Be Thorough in Analysis:
- Read the entire handoff document first
- Verify ALL mentioned changes still exist
- Check for any regressions or conflicts
- Read all referenced artifacts
Be Interactive:
- Present findings before starting work
- Get buy-in on the approach
- Allow for course corrections
- Adapt based on current state vs handoff state
Leverage Handoff Wisdom:
- Pay special attention to "Learnings" section
- Apply documented patterns and approaches
- Avoid repeating mistakes mentioned
- Build on discovered solutions
Track Continuity:
- Use TodoWrite to maintain task continuity
- Reference the handoff document in commits
- Document any deviations from original plan
- Consider creating a new handoff when done
Validate Before Acting:
- Never assume handoff state matches current state
- Verify all file references still exist
- Check for breaking changes since handoff
- Confirm patterns are still valid
Common Scenarios
Scenario 1: Clean Continuation
- All changes from handoff are present
- No conflicts or regressions
- Clear next steps in action items
- Proceed with recommended actions
Scenario 2: Diverged Codebase
- Some changes missing or modified
- New related code added since handoff
- Need to reconcile differences
- Adapt plan based on current state
Scenario 3: Incomplete Handoff Work
- Tasks marked as "in_progress" in handoff
- Need to complete unfinished work first
- May need to re-understand partial implementations
- Focus on completing before new work
Scenario 4: Stale Handoff
- Significant time has passed
- Major refactoring has occurred
- Original approach may no longer apply
- Need to re-evaluate strategy
Example Interaction Flow
User: /resume_handoff specification/feature/handoffs/handoff-0.md
Assistant: Let me read and analyze that handoff document...
[Reads handoff completely]
[Spawns research tasks]
[Waits for completion]
[Reads identified files]
I've analyzed the handoff from [date]. Here's the current situation...
[Presents analysis]
Shall I proceed with implementing the webhook validation fix, or would you like to adjust the approach?
User: Yes, proceed with the webhook validation
Assistant: This is a bugfix task, so I'll route to the `spark` agent.
[Uses Task tool with subagent_type="spark" and prompt containing:
- The webhook validation fix task
- Key learnings from handoff
- Relevant file:line references
- Patterns to follow]
[Waits for spark agent to complete]
The spark agent has completed the webhook validation fix. Moving to the next task...
Source: parcadei/Continuous-Claude-v3 → .claude/skills/resume_handoff/SKILL.md
1---2name: resume-handoff3description: "Resume work from handoff document with context analysis and validation"4category: ai-agents-and-harness5source_repo: parcadei/Continuous-Claude-v36source_path: ".claude/skills/resume_handoff/SKILL.md"7source_url: https://github.com/parcadei/Continuous-Claude-v3/blob/HEAD/.claude/skills/resume_handoff/SKILL.md8metadata:9 source: https://skillmd.com/skills/parcadei/resume-handoff10---111213# Resume work from a handoff document1415You are tasked with resuming work from a handoff document through an interactive process. These handoffs contain critical context, learnings, and next steps from previous work sessions that need to be understood and continued.1617## Initial Response1819When this command is invoked:20211. **If the path to a handoff document was provided**:22 - If a handoff document path was provided as a parameter, skip the default message23 - Immediately read the handoff document FULLY24 - Immediately read any research or plan documents that it links to under `thoughts/shared/plans` or `thoughts/shared/research`. do NOT use a sub-agent to read these critical files.25 - Begin the analysis process by ingesting relevant context from the handoff document, reading additional files it mentions26 - Then propose a course of action to the user and confirm, or ask for clarification on direction.27282. **If a ticket number (like ENG-XXXX) was provided**:29 - locate the most recent handoff document for the ticket. Tickets will be located in `thoughts/shared/handoffs/ENG-XXXX` where `ENG-XXXX` is the ticket number. e.g. for `ENG-2124` the handoffs would be in `thoughts/shared/handoffs/ENG-2124/`. **List this directory's contents.**30 - There may be zero, one or multiple files in the directory.31 - **If there are zero files in the directory, or the directory does not exist**: tell the user: "I'm sorry, I can't seem to find that handoff document. Can you please provide me with a path to it?"32 - **If there is only one file in the directory**: proceed with that handoff33 - **If there are multiple files in the directory**: using the date and time specified in the file name (it will be in the format `YYYY-MM-DD_HH-MM-SS` in 24-hour time format), proceed with the _most recent_ handoff document.34 - Immediately read the handoff document FULLY35 - Immediately read any research or plan documents that it links to under `thoughts/shared/plans` or `thoughts/shared/research`; do NOT use a sub-agent to read these critical files.36 - Begin the analysis process by ingesting relevant context from the handoff document, reading additional files it mentions37 - Then propose a course of action to the user and confirm, or ask for clarification on direction.38393. **If no parameters provided**, respond with:40```41I'll help you resume work from a handoff document. Let me find the available handoffs.4243Which handoff would you like to resume from?4445Tip: You can invoke this command directly with a handoff path: `/resume_handoff `thoughts/shared/handoffs/ENG-XXXX/YYYY-MM-DD_HH-MM-SS_ENG-XXXX_description.md`4647or using a ticket number to resume from the most recent handoff for that ticket: `/resume_handoff ENG-XXXX`48```4950Then wait for the user's input.5152## Process Steps5354### Step 1: Read and Analyze Handoff55561. **Read handoff document completely**:57 - Use the Read tool WITHOUT limit/offset parameters58 - Extract all sections:59 - Task(s) and their statuses60 - Recent changes61 - Learnings62 - Artifacts63 - Action items and next steps64 - Other notes65662. **Spawn focused research tasks**:67 Based on the handoff content, spawn parallel research tasks to verify current state:6869 ```70 Task 1 - Gather artifact context:71 Read all artifacts mentioned in the handoff.72 1. Read feature documents listed in "Artifacts"73 2. Read implementation plans referenced74 3. Read any research documents mentioned75 4. Extract key requirements and decisions76 Use tools: Read77 Return: Summary of artifact contents and key decisions78 ```79803. **Wait for ALL sub-tasks to complete** before proceeding81824. **Read critical files identified**:83 - Read files from "Learnings" section completely84 - Read files from "Recent changes" to understand modifications85 - Read any new related files discovered during research8687### Step 2: Synthesize and Present Analysis88891. **Present comprehensive analysis**:90 ```91 I've analyzed the handoff from [date] by [researcher]. Here's the current situation:9293 **Original Tasks:**94 - [Task 1]: [Status from handoff] → [Current verification]95 - [Task 2]: [Status from handoff] → [Current verification]9697 **Key Learnings Validated:**98 - [Learning with file:line reference] - [Still valid/Changed]99 - [Pattern discovered] - [Still applicable/Modified]100101 **Recent Changes Status:**102 - [Change 1] - [Verified present/Missing/Modified]103 - [Change 2] - [Verified present/Missing/Modified]104105 **Artifacts Reviewed:**106 - [Document 1]: [Key takeaway]107 - [Document 2]: [Key takeaway]108109 **Recommended Next Actions:**110 Based on the handoff's action items and current state:111 1. [Most logical next step based on handoff]112 2. [Second priority action]113 3. [Additional tasks discovered]114115 **Potential Issues Identified:**116 - [Any conflicts or regressions found]117 - [Missing dependencies or broken code]118119 Shall I proceed with [recommended action 1], or would you like to adjust the approach?120 ```1211222. **Get confirmation** before proceeding123124### Step 3: Create Action Plan1251261. **Use TodoWrite to create task list**:127 - Convert action items from handoff into todos128 - Add any new tasks discovered during analysis129 - Prioritize based on dependencies and handoff guidance1301312. **Present the plan**:132 ```133 I've created a task list based on the handoff and current analysis:134135 [Show todo list]136137 Ready to begin with the first task: [task description]?138 ```139140### Step 4: Route to Specialist Agent141142**CRITICAL: Do NOT implement directly. Always spawn via Task tool.**1431441. **Analyze task type and select specialist agent**:145146 **Leads (can spawn workers):**147 | Agent | Domain | Use For |148 |-------|--------|---------|149 | `kraken` | implement | Large features, new systems, major components |150 | `architect` | plan | Feature design, system architecture, implementation planning |151 | `phoenix` | plan | Refactoring plans, migrations, codebase restructuring |152 | `herald` | deploy | Releases, deployments, publishing |153 | `maestro` | orchestrate | Complex multi-agent workflows |154155 **Workers (focused specialists):**156 | Agent | Domain | Use For |157 |-------|--------|---------|158 | `spark` | implement | Quick fixes, patches, minor tweaks |159 | `scribe` | document | Documentation, guides, explanations |160 | `sleuth` | debug | Bug investigation, tracing, root cause analysis |161 | `aegis` | debug | Security audits, vulnerability scanning |162 | `profiler` | debug | Performance optimization, bottleneck analysis |163 | `arbiter` | validate | Unit tests |164 | `atlas` | validate | E2E/integration tests |165 | `oracle` | research | External docs, best practices, how-to |166 | `scout` | research | Codebase exploration, finding existing code |167 | `pathfinder` | research | Repository structure analysis |168 | `plan-reviewer` | review | Feature plan review, design validation |169 | `plan-reviewer` | review | Migration review, refactoring validation |170 | `chronicler` | session | Session analysis, history summaries |1711722. **Spawn the specialist via Task tool**:173 ```174 Use Task tool with:175 - subagent_type: [selected agent from above]176 - prompt: [task description + relevant handoff context + learnings]177 ```1781793. **Include handoff context in the prompt**:180 - Key learnings from the handoff181 - File references with line numbers182 - Patterns to follow183 - Pitfalls to avoid1841854. **Wait for agent completion**, then proceed to next task186187## Guidelines1881891. **Be Thorough in Analysis**:190 - Read the entire handoff document first191 - Verify ALL mentioned changes still exist192 - Check for any regressions or conflicts193 - Read all referenced artifacts1941952. **Be Interactive**:196 - Present findings before starting work197 - Get buy-in on the approach198 - Allow for course corrections199 - Adapt based on current state vs handoff state2002013. **Leverage Handoff Wisdom**:202 - Pay special attention to "Learnings" section203 - Apply documented patterns and approaches204 - Avoid repeating mistakes mentioned205 - Build on discovered solutions2062074. **Track Continuity**:208 - Use TodoWrite to maintain task continuity209 - Reference the handoff document in commits210 - Document any deviations from original plan211 - Consider creating a new handoff when done2122135. **Validate Before Acting**:214 - Never assume handoff state matches current state215 - Verify all file references still exist216 - Check for breaking changes since handoff217 - Confirm patterns are still valid218219## Common Scenarios220221### Scenario 1: Clean Continuation222- All changes from handoff are present223- No conflicts or regressions224- Clear next steps in action items225- Proceed with recommended actions226227### Scenario 2: Diverged Codebase228- Some changes missing or modified229- New related code added since handoff230- Need to reconcile differences231- Adapt plan based on current state232233### Scenario 3: Incomplete Handoff Work234- Tasks marked as "in_progress" in handoff235- Need to complete unfinished work first236- May need to re-understand partial implementations237- Focus on completing before new work238239### Scenario 4: Stale Handoff240- Significant time has passed241- Major refactoring has occurred242- Original approach may no longer apply243- Need to re-evaluate strategy244245## Example Interaction Flow246247```248User: /resume_handoff specification/feature/handoffs/handoff-0.md249Assistant: Let me read and analyze that handoff document...250251[Reads handoff completely]252[Spawns research tasks]253[Waits for completion]254[Reads identified files]255256I've analyzed the handoff from [date]. Here's the current situation...257258[Presents analysis]259260Shall I proceed with implementing the webhook validation fix, or would you like to adjust the approach?261262User: Yes, proceed with the webhook validation263Assistant: This is a bugfix task, so I'll route to the `spark` agent.264265[Uses Task tool with subagent_type="spark" and prompt containing:266 - The webhook validation fix task267 - Key learnings from handoff268 - Relevant file:line references269 - Patterns to follow]270271[Waits for spark agent to complete]272273The spark agent has completed the webhook validation fix. Moving to the next task...274```275276---277278**Source:** [`parcadei/Continuous-Claude-v3`](https://github.com/parcadei/Continuous-Claude-v3) → `.claude/skills/resume_handoff/SKILL.md`