wf-finalize

WF: Finalize

Gate Check

cat .claude/.workflow-state/guardian-passed.json

If the file does not exist: STOP — "Guardian check not complete. Run Step 5 (wf-guardian) first."

Load TICKET, TEAM_LEADER_NAME, featureBranch, mode from state files.

---

Your Task

Clean up everything, push the branch, and hand off to the user.

Order is mandatory: shut down agents BEFORE removing sentinel BEFORE emitting session.end.

---

Checklist

1. Shut Down All Agents

Send shutdown_request to every active agent on the team. Check wave-<N>-spawned.json files for agent names if unsure who is running:

SendMessage(to: "<agent-name>", message: {"type": "shutdown_request"})

Wait for each to acknowledge or time out (30s max per agent).

2. Remove Sentinel File

rm -f .claude/.workflow-active

3. Clean Remaining Worktrees

git worktree list --porcelain \
  | grep "worktree.*<worktreeDir>/<TICKET>" \
  | awk '{print $2}' \
  | xargs -r -I{} git worktree remove --force {}

git branch --list "<workPrefix>/<TICKET>/*" \
  | xargs -r git branch -D

4. Push Feature Branch

git push origin <featureBranch>

5. Create PR (if requested or strict mode)

Ask the user: "Create a PR for <featureBranch>? (y/n)"

If yes:

gh pr create \
  --title "<TICKET>: <feature summary>" \
  --body "$(cat << 'EOF'
## Summary

<bullet list of tasks completed>

## Changes

<files modified>

## Test plan

- [ ] QA passed all tasks
- [ ] Codebase Guardian passed
- [ ] Wave fence passed
EOF
)" \
  --base <baseBranch>

6. Compile & Write Run Report

Read ./progress/<TICKET>/events.jsonl and compile metrics from it.

From agent.spawned events — extract per-agent rows:

• agent: agent name
• model: model field from event data (if present)
• role: role field from event data (if present)
• start: timestamp of the agent.spawned event (HH:MM)
• duration: difference between agent.spawned and the matching agent.completed event
• input / output / cache_read / cache_write: token fields from event data (if present, else —)
• skills: skills field from event data (if present, else —)