Resume work from a handoff document

---

description: Resume work from handoff document with context analysis and validation

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:

1. **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.

2. **If a ticket number (like ENG-XXXX) was provided**:

   • run humanlayer thoughts sync to ensure your thoughts/ directory is up to date.
   • 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.

3. **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