Skip to content

resume

Pipelines get interrupted: a session crashes, you stop a run mid-flight, a lock expires, a fix cycle fails. /jkz:resume <issue-number> is how you get back on track. It diagnoses what state the pipeline is in, presents that diagnosis clearly, and — only after you confirm — delegates to the correct command to continue from the exact point it stopped.

Usage

/jkz:resume <issue-number>

What it diagnoses

/jkz:resume reads the pipeline checkpoint and classifies the interruption into one of six types, each with its own handling:

InterruptionWhat it meansHandling
completedPipeline already finishedNothing to resume
runningA lock is active — another session may be processing itWait, or inspect with /jkz:status
blockedThe fix cycle exhausted its attemptsShows the postmortem; offers re-plan / manual fix / close
crashAn unexpected interruptionPresents the recommended resume point for confirmation
stoppedThe run was stopped deliberatelyPresents the recommended resume point for confirmation
failA phase failedPresents the recommended resume point for confirmation

For the recoverable types, the diagnosis includes the current phase, the last completed step and the next step, the associated PR and its state, lock status, fix-cycle counts, and the issue’s age — so you can see precisely where the pipeline is before deciding.

The principle: diagnose, then delegate

/jkz:resume never auto-executes a recovery. It surfaces a recommended action (for example, “re-run review on PR #44” or “re-plan from scratch”) and asks you to confirm. On confirmation it releases any expired lock and hands control to the target command (/jkz:plan, /jkz:review, /jkz:qa, /jkz:pipeline, …). For a blocked pipeline it presents options rather than a single recommendation, because the right move — re-plan, fix manually, or close — is a judgment call.

If there is no pipeline state for the issue at all, /jkz:resume tells you so and points you to /jkz:pipeline <N> to start fresh.

Source of truth

The diagnosis logic lives in scripts/resume-diagnose.js and the command flow in .claude/commands/jkz/resume.md in the private repo. To inspect a pipeline without resuming, use /jkz:status.