gioe/resume-task

Resume Task Skill

Recovers context after a session crash/timeout and continues the implementation workflow.

Step 1: Detect the Task ID

tusk branch-parse

• Returns {"task_id": N} → use that ID and proceed to Step 2
• Exits 1 (branch doesn't match) → check for user-provided argument (e.g., /resume-task 42)
• Neither → ask: "Could not detect a task ID. Which task ID should I resume?"

Step 2: Start the Task (Idempotent)

tusk task-start <TASK_ID> --force --force-session

The --force flag ensures the workflow proceeds even if the task has no acceptance criteria (emits a warning rather than hard-failing). The --force-session flag explicitly reuses an active session when resuming from outside the recorded task workspace.

Returns JSON with four keys:

task        — full task row (summary, description, priority, domain, assignee, complexity)
progress    — checkpoints (most recent first); first entry's next_steps = resume point
criteria    — acceptance criteria (id, criterion, source, is_completed)
session_id  — reuses open session if one exists

Hold onto session_id for later use.

Step 3: Gather Context

git log --oneline $(git merge-base HEAD main)..HEAD

Step 4: Display Recovery Summary

Task:        [TASK-<id>] <summary> (priority, complexity, domain)
Description: <description>

Progress Checkpoints: (most recent first)
  - <next_steps> | <commit_hash> | <files_changed>
  (or "No prior checkpoints found.")

Acceptance Criteria:
  - [x] completed criterion
  - [ ] pending criterion  ← defines remaining work

Recent Commits: (git log output from Step 3)

Next Steps: <most recent checkpoint's next_steps, or incomplete criteria if none>

Step 5: Resume the /tusk Workflow

Continue from /tusk step 4 onward (subagents → explore → implement → commit → criteria → finalize). Steps 1-3 are already done.

• Mark criteria done as you go: tusk criteria done <cid>
• Log progress after each commit:

  tusk progress <TASK_ID> --next-steps "<what remains>"
  

• Run tusk lint before pushing (advisory only)
• For finalize steps (step 12), read step 12 directly from the tusk skill:

  Read file: <base_directory>/../tusk/SKILL.md
  

  Where <base_directory> is the resume-task skill's base directory.