wf-release

name: wf-release description: This skill should only be used when the user uses the word workflow and asks to release or ship changes with a release checklist, verification, and clean handoff/pickup boundaries.

Purpose

Ship changes safely with a minimal release checklist, changelog/release notes, and post-release verification.

Prefer prd.json as the source of truth for what shipped (user story IDs + acceptance criteria). plan.md may exist for rollout/rollback notes, but it’s optional.

Inputs

Plan/PRD acceptance criteria (prefer prd.json)
Release scope + rollout constraints
Monitoring + rollback requirements
Target repo + branch/PR

Outputs

Release notes / changelog entry / post-release notes (as needed)
GO/NO-GO decision with verification evidence
Optional learning entry via compound-docs

Steps

(Recommended) Pickup if starting fresh thread / resuming

Invoke pickup if repo/branch/PR state is not fresh.

Confirm scope + rollout shape Capture:

what is shipping (and what is not)
rollout strategy (flags, staged, canary)
rollback steps (including data)
monitors to watch
link to prd.json (and plan.md if present)

Pre-release verification (mandatory)

Run verify skill.
If verify fails: NO-GO unless user explicitly accepts risk.

Release artefacts

Draft release notes / changelog entry (keep it short, user-facing)
Prefer listing shipped stories by ID (US-xxx) from prd.json
Note any operator actions (migrations, flags, config)

Post-release verification

State what to check after deploy (smoke checks + metrics)
If available, record evidence (screenshots/logs)

Compound (recommended when non-trivial)

If anything surprising happened (flaky tests, rollout gotcha, weird failure mode): suggest compound-docs

Context boundary (recommended) If handing off to another agent/person or switching workflows:

invoke handoff
recommend new thread for next work: /new then pickup

Verification

Verify skill run pre-release (required).

Go/No-Go

GO if verify is green, rollback plan exists, and monitors listed.
NO-GO otherwise.