cleanup

/cleanup — Pipeline Teardown

The user-initiated cleanup command for pipeline teardown. Run this after a pipeline completes (success, failure, escalation, or abort) when you are ready to discard the worktree and close the session.

What cleanup does:

1. Deletes the pipeline-team agent team
2. Removes the pipeline worktree (no prompt — invoking this skill is the user's confirmation)
3. Completes the sentinel task to mark pipeline completion

When to invoke: Only when you are done with the current pipeline session. Teardown is irreversible — the worktree is deleted and cannot be recovered.

- **User-initiated only.** This skill is never called by the pipeline automatically. The user runs `/cleanup` when they are ready. - **No approval pause.** Invoking this skill is the user's confirmation to tear down. - **Graceful no-op.** If no active pipeline exists (no team, no sentinel task), explain that and exit cleanly — do not error. - **Sentinel last.** Complete the sentinel task as the final step, after team and worktree are gone.

---

Procedure

Step 1 — Find the sentinel task

Call TaskGet(taskId = 1) first. If the task exists and has metadata.role = "team-lead" and metadata.phase = "orchestration", that is the sentinel — store its ID as SENTINEL_TASK_ID and proceed to Step 2.

If task 1 does not match (or does not exist), fall back: call TaskList, then call TaskGet on each in_progress task until one matches metadata.role = "team-lead" and metadata.phase = "orchestration". Store its ID as SENTINEL_TASK_ID.

If no match is found after the full scan, no active pipeline is present. Tell the user:

No active pipeline found. Nothing to clean up.

Then stop — do not proceed further.

Step 2 — Delete the pipeline team

TeamDelete(name = "pipeline-team")

If the call fails because the team does not exist, treat it as a no-op and continue.

Step 3 — Remove the worktree

ExitWorktree(action = "remove")

This deletes the worktree immediately without prompting the user.

Step 4 — Complete the sentinel task

TaskUpdate(
  taskId   = <SENTINEL_TASK_ID>,
  status   = "completed",
  metadata = { completed_at: "<ISO 8601 timestamp>" }
)

Use the current UTC time for completed_at.

Step 5 — Confirm completion

Tell the user:

Pipeline teardown complete. Team deleted, worktree removed, sentinel task closed.