Files
msd-core/commands/gsd/resume-task.md
Lex Christopherson 6ba850712f feat: add subagent resume capability
Add ability to resume interrupted subagent executions using Task tool's
resume parameter. Tracks agent IDs during execution and enables seamless
continuation after session timeout, rate limits, or crashes.

- New /gsd:resume-task command for resuming interrupted agents
- Agent ID tracking in execute-phase workflow
- Dual storage: current-agent-id.txt (fast) + agent-history.json (audit)
- Auto-detection of interrupted agents in resume-project workflow
- File conflict warnings before resume

Closes #37

Co-Authored-By: davesienkowski <davesienkowski@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 14:19:10 -06:00

2.2 KiB

name, description, argument-hint, allowed-tools
name description argument-hint allowed-tools
gsd:resume-task Resume an interrupted subagent execution [agent-id]
Read
Write
Edit
Bash
Task
AskUserQuestion
Resume an interrupted subagent execution using the Task tool's resume parameter.

When a session ends mid-execution, subagents may be left in an incomplete state. This command allows users to continue that work without starting over.

Uses the agent ID tracking infrastructure from execute-phase to identify and resume agents.

<execution_context> @~/.claude/get-shit-done/workflows/resume-task.md </execution_context>

Agent ID: $ARGUMENTS (optional - defaults to most recent)

Load project state: @.planning/STATE.md

Load agent tracking: @.planning/current-agent-id.txt @.planning/agent-history.json

1. Check .planning/ directory exists (error if not) 2. Parse agent ID from arguments or current-agent-id.txt 3. Validate agent exists in history and is resumable 4. Check for file conflicts since spawn 5. Follow resume-task.md workflow: - Update agent status to "interrupted" - Resume via Task tool resume parameter - Update history on completion - Clear current-agent-id.txt **Resume most recent interrupted agent:** ``` /gsd:resume-task ```

Resume specific agent by ID:

/gsd:resume-task agent_01HXYZ123

Find available agents to resume: Check .planning/agent-history.json for entries with status "spawned" or "interrupted".

<error_handling> No agent to resume:

  • current-agent-id.txt empty or missing
  • Solution: Run /gsd:progress to check project status

Agent already completed:

  • Agent finished successfully, nothing to resume
  • Solution: Continue with next plan

Agent not found:

  • Provided ID not in history
  • Solution: Check agent-history.json for valid IDs

Resume failed:

  • Agent context expired or invalidated
  • Solution: Start fresh with /gsd:execute-plan </error_handling>

<success_criteria>

  • Agent resumed via Task tool resume parameter
  • Agent-history.json updated with completion
  • current-agent-id.txt cleared
  • User informed of result </success_criteria>