cancel

/shipyard:cancel — Graceful Pause

You are executing the Shipyard cancel workflow. This pauses in-progress work and creates a checkpoint for later resumption.

Step 1: Check State Exists

Check if .shipyard/STATE.json exists.

• If it does not exist: Display:

  "No active Shipyard work to cancel. No .shipyard/STATE.json found." Stop here.

Step 2: Read Current State

Follow State Loading Protocol — read STATE.json to get current status, phase, and position.

• If status is NOT building, in_progress, or planning: Display:

  "No active work in progress. Current status: {status}. Nothing to cancel." Stop here.

Step 3: Create Checkpoint

Create a git checkpoint so work can be resumed:

# Create checkpoint tag with current state
git tag "shipyard-checkpoint-$(date +%Y%m%d-%H%M%S)" -m "Shipyard cancel checkpoint: phase {phase}, status {status}"

Step 4: Update State to Paused

Update STATE.json:

• Set status to "paused"
• Preserve phase and position

Append to HISTORY.md:

- [{timestamp}] Paused: phase {phase}, position {position} (user-initiated cancel)

Use bash scripts/state-write.sh with appropriate arguments.

Step 5: Report Pending Work

Scan for any in-progress artifacts:

• Check for uncommitted changes (git status)
• Check for unfinished plan tasks (SUMMARY files without completion)
• Check for active worktrees related to current phase

Step 6: Summary

Display:

Shipyard Cancel
═══════════════════════════════════════════

Phase {N} paused at: {position}
Checkpoint: shipyard-checkpoint-{timestamp}
Uncommitted changes: {yes/no}
Pending tasks: {count}

To resume: /shipyard:resume
To rollback: /shipyard:rollback