Files
msd-core/commands/gsd/resume-task.md
Lex Christopherson 4ea054b9f6 docs(10-01): update documentation mentions to execute-plan.md
- commands/gsd/resume-task.md: infrastructure mention
- get-shit-done/workflows/plan-phase.md: execution context reference
- get-shit-done/templates/agent-history.md: 2 workflow mentions
- get-shit-done/templates/summary.md: 3 workflow mentions
- get-shit-done/templates/codebase/structure.md: example workflow
2026-01-12 12:45:45 -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-plan 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>