Deploy Release Skill
[!IMPORTANT]
Prepare and verify a staged or production deployment with rollback and smoke checks.
Optional args: slug=, ticket=<id/url>, mode=interactive|autonomous|channel, channel=, auto_continue=true|false, profile=business|hybrid|technical.
Instructions
When the user asks to perform this workflow, execute the following steps:
Deploy Release Workflow
Goal: Ship verified work with explicit deployment steps, smoke checks, and rollback criteria.
Steps
- Confirm readiness:
- Verification report is PASS or accepted with documented risk.
- Required approvals are present, and production carries a named release owner's authorization.
- Migrations and feature flags are accounted for.
release_confidence is high, or medium with documented risk; low means NO-GO unless the release owner overrides in writing.
- Prepare release:
- Identify version, environment, deploy command, and owner.
- Confirm secrets, config, queues, cron, and external services.
- Define rollback command or revert path.
- Environment tier: dev deploys freely; staging deploys behind the smoke gate; production is prepared by the agent and authorized by the named release owner through the guardrail approval gate.
- Deploy:
- Run staging deploy first when available.
- Rehearse the rollback in staging before promoting to production.
- Run smoke checks before promotion.
- Promote only when smoke checks pass.
- Monitor:
- Check logs, metrics, errors, latency, and core user flows.
- Stop or roll back on defined failure signals.
- Route:
- User-facing notes ->
publish-notes.
- Process and standards feedback ->
retro-learn.
Runtime Contract
- Use once verification/UAT signoff is PASS and a release window is open.
- Required inputs: verification report plus release version, environment, and rollback path.
- Return BLOCKED when required approvals, migrations, or rollback path are unresolved, or when a production deploy has no named authorizer.
Handoff Payload
slug, release_confidence, release verdict (GO/NO-GO/ROLLED-BACK), smoke check results, rollback path, outcome report, next workflow.
Blocking Questions
- Ask max 3 at a time with a recommended default and 2-3 options.
Output Template
# Deployment Report: [Name]
## Release Verdict
GO | NO-GO | ROLLED-BACK
## Release
## Environments
## Commands
## Smoke Checks
| Check | Result | Evidence |
| --- | --- | --- |
| [check] | [PASS/FAIL/BLOCKED] | [evidence] |
## Rollback
## Outcome Report
feature_status: implemented | blocked
requirement_trace: BRD-OBJ-* -> REQ-* -> AC-* -> SRS-* -> evidence
completed_evidence: []; missing_evidence: []; decision_needed: []; recommended_next_workflow: publish-notes | retro-learn
## Next Workflow
publish-notes | retro-learn
## Cost Report
Call `get_session_cost(workflow="deploy-release")` before final handoff.
1---2name: deploy-release-23description: Prepare and verify a staged or production deployment with rollback and smoke checks.4---5# Deploy Release Skill67> [!IMPORTANT]8> Prepare and verify a staged or production deployment with rollback and smoke checks.910Optional args: slug=<feature>, ticket=<id/url>, mode=interactive|autonomous|channel, channel=<id>, auto_continue=true|false, profile=business|hybrid|technical.1112## Instructions1314When the user asks to perform this workflow, execute the following steps:151617# Deploy Release Workflow1819Goal: Ship verified work with explicit deployment steps, smoke checks, and rollback criteria.2021## Steps22231. Confirm readiness:24 - Verification report is PASS or accepted with documented risk.25 - Required approvals are present, and production carries a named release owner's authorization.26 - Migrations and feature flags are accounted for.27 - `release_confidence` is `high`, or `medium` with documented risk; `low` means NO-GO unless the release owner overrides in writing.282. Prepare release:29 - Identify version, environment, deploy command, and owner.30 - Confirm secrets, config, queues, cron, and external services.31 - Define rollback command or revert path.32 - Environment tier: dev deploys freely; staging deploys behind the smoke gate; production is prepared by the agent and authorized by the named release owner through the guardrail approval gate.333. Deploy:34 - Run staging deploy first when available.35 - Rehearse the rollback in staging before promoting to production.36 - Run smoke checks before promotion.37 - Promote only when smoke checks pass.384. Monitor:39 - Check logs, metrics, errors, latency, and core user flows.40 - Stop or roll back on defined failure signals.415. Route:42 - User-facing notes -> `publish-notes`.43 - Process and standards feedback -> `retro-learn`.4445## Runtime Contract46- Use once verification/UAT signoff is PASS and a release window is open.47- Required inputs: verification report plus release version, environment, and rollback path.48- Return BLOCKED when required approvals, migrations, or rollback path are unresolved, or when a production deploy has no named authorizer.49## Handoff Payload50- `slug`, `release_confidence`, release verdict (GO/NO-GO/ROLLED-BACK), smoke check results, rollback path, outcome report, next workflow.51## Blocking Questions52- Ask max 3 at a time with a recommended default and 2-3 options.5354## Output Template5556```md57# Deployment Report: [Name]5859## Release Verdict60GO | NO-GO | ROLLED-BACK6162## Release6364## Environments6566## Commands6768## Smoke Checks6970| Check | Result | Evidence |71| --- | --- | --- |72| [check] | [PASS/FAIL/BLOCKED] | [evidence] |7374## Rollback7576## Outcome Report77feature_status: implemented | blocked78requirement_trace: BRD-OBJ-* -> REQ-* -> AC-* -> SRS-* -> evidence79completed_evidence: []; missing_evidence: []; decision_needed: []; recommended_next_workflow: publish-notes | retro-learn8081## Next Workflow8283publish-notes | retro-learn8485## Cost Report86Call `get_session_cost(workflow="deploy-release")` before final handoff.87```88