wf-quit

wf-quit — Clean shutdown of the active workflow

This skill is invoked by /waterfall:quit. It stops the active team of the current session, cleans up session markers, and preserves the need's state for resumption via /waterfall:resume.

Step 1 — Detect the active session

Read the current session_id from the environment or the Claude Code session context.

Check whether the session marker exists:

~/.claude/wf-session-active.<session_id>

If the file does not exist: display the following message and stop (exit 0):

No active wf workflow in this session.

(EX-011 — no error, neutral behavior)

If the file exists: read its content to obtain the need_name:

need_name=$(cat ~/.claude/wf-session-active.<session_id>)

Step 2 — Load the team config (implicit team, session-derived)

The team name is session-derived (CLI v2.1.178+): session-<first 8 chars of sid>. Read the need's session_id and build the path:

sid=$(jq -r .session_id "wf/needs/$need_name/.wf-state.json" | tr -d '\r\n')
team_cfg="$HOME/.claude/teams/session-${sid:0:8}/config.json"
teammates=$(jq -r '.members[]?.name | select(. != "team-lead")' "$team_cfg" 2>/dev/null)

If the file is missing (subagent-light, or no team formed): continue with an empty list (R4 fallback — the platform cleans up teammates at session end anyway).

Step 3 — Send shutdown_request to each teammate

For each teammate from step 2, send a graceful shutdown_request via SendMessage, referencing the teammate by name:

SendMessage(to: <teammate_name>, message: { type: "shutdown_request", reason: "wf-quit" })

Best-effort: teammates are also cleaned up automatically at session end, so do not block waiting for shutdown_response.

Step 3.bis — Close the active segment (ADR-008)

Before deleting markers, close the current segment in .wf-state.json:

state_file="wf/needs/$need_name/.wf-state.json"
source "${CLAUDE_PLUGIN_ROOT}/scripts/lib/wf-segments.sh"
_seg_close "$state_file" || true