/deliver — Superteam Delivery Checklist

You are executing the Superteam delivery chain. Follow every step in order. Do not skip steps. Do not ask the user whether to proceed between steps — just do them.

Step 0 — Write Delivery Sentinel

Before doing anything else, write .squad/deliver-started.md with this exact content:

DELIVER STARTED — YYYY-MM-DD HH:mm

Use today's date and current time. This sentinel tells post-push-coach.ps1 that /deliver was invoked. Without it, Coach marks the session as an unscored /decide miss.

Step 1 — Vera Sign-Off (Mandatory)

Brief Vera on everything that was just built or changed. Give her:

• What was built (files changed, features added)
• What it's supposed to do
• Any edge cases you already considered

Vera must explicitly approve before proceeding. If she flags issues, fix them first, then restart the deliver chain from Step 1.

Step 2 — Kevin Documentation Audit

Brief Kevin on what changed. He checks:

• Does the README need updating? (new features, changed commands, new files, removed things)
• Do any agent files reference concepts, agents, or tools that no longer exist?
• Do onboarding docs, CLAUDE.md, or AGENTS.md need updating to reflect what changed?
• Are there any squad docs (SYSTEM.md, PLAYBOOK.md, CEREMONIES.md) that are now stale?

Kevin flags specific files that need updating. Fix all flagged files before proceeding.

If Kevin confirms everything is current, note: "Kevin: docs current." and continue.

Step 2b — Update ADR Status

Find all files in .squad/decisions/ with status: decided or status: proposed that were part of this delivery. Update the status field to status: implemented.

To identify which ADRs apply: check decision files modified in this session or referenced in the active task. If unsure, scan .squad/decisions/ for files dated today or containing the feature/task name.

If no ADRs exist for this delivery, note: "No ADRs to update." and continue.

Step 3 — Update README(s)

Apply Kevin's documentation findings. Update all flagged files. If Kevin flagged nothing, skip this step and note it.

Step 4 — Clear All Sentinels

Delete all squad sentinel files before staging. These are all gitignored:

Remove-Item .squad/active-task.md -ErrorAction SilentlyContinue
Remove-Item .squad/vera-approved.md -ErrorAction SilentlyContinue
Remove-Item .squad/kryptonite-cleared.md -ErrorAction SilentlyContinue
Remove-Item .squad/pod-routed.md -ErrorAction SilentlyContinue
Remove-Item .squad/kevin-docs-checked.md -ErrorAction SilentlyContinue
Remove-Item .squad/marlo-specced.md -ErrorAction SilentlyContinue
Remove-Item .squad/playwright-results.md -ErrorAction SilentlyContinue

• active-task.md — resets the pre-edit hook so the next /decide starts clean
• vera-approved.md — consumed by the push gate; cleared so the next delivery requires a fresh Vera sign-off
• kryptonite-cleared.md — consumed by the build gate; cleared so the next build requires a fresh Kryptonite review
• pod-routed.md — consumed by the build gate; cleared so the next build requires a fresh Eric pod routing record
• kevin-docs-checked.md — consumed by the commit gate; cleared so the next commit requires a fresh Kevin doc review
• marlo-specced.md — consumed by the UI build gate; cleared so the next UI feature requires a fresh committed Marlo spec
• playwright-results.md — consumed by the push gate; cleared so the next web delivery requires a fresh Playwright run

Do NOT delete deliver-started.md here — it must survive until after push so the Coach hook can read it.

Step 5 — Stage Changes

Run git status to see what's changed. Stage only the relevant files for this delivery — not unrelated uncommitted changes. Do NOT use git add -A unless every changed file belongs to this delivery.

Show the staged list before committing.

Step 6 — Commit

Write a commit message that captures WHAT changed and WHY. Format:

<type>: <what changed>

<why it was needed — one sentence if non-obvious>

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Types: feat, fix, refactor, docs, chore, test

Do NOT amend. Create a new commit.

Step 7 — Push

Push to origin:

git push

If the branch has no upstream, use git push -u origin <branch>.

Step 8 — Confirm Coach Hook

After push, confirm the PostToolUse/Coach hook ran by checking if a game tape file was written today:

• Check .squad/coach/game-tape/YYYY-MM-DD.md (today's date)
• If it exists and has content, report: "Coach game tape written."
• If it doesn't exist, note: "Coach hook did not fire — check settings.json hooks config."

After confirming the game tape, delete the delivery sentinel:

Remove-Item .squad/deliver-started.md -ErrorAction SilentlyContinue

This must be the last sentinel deleted — the post-push Coach hook reads it during the push; deleting it earlier defeats the M3 compliance check.

Step 9 — Report to Steve

End with a clean delivery summary:

DELIVERED — <what was shipped>
Vera: approved
Commit: <short hash> — <message>
Push: origin/<branch>
Coach: game tape written / hook did not fire

That's it. Clean, complete, no loose ends.