[!IMPORTANT] Prepare and verify a staged or production deployment with rollback and smoke checks.
Instructions
When the user asks to perform this workflow, execute the following steps:
Deploy Release WorkflowGoal: 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.
- Migrations and feature flags are accounted for.
-
Prepare release:
- Identify version, environment, deploy command, and owner.
- Confirm secrets, config, queues, cron, and external services.
- Define rollback command or revert path.
-
Deploy:
- Run staging deploy first when available.
- 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:
- Send user-facing changes to
publish-notes. - Send process/quality findings to
retro-learn.
- Send user-facing changes to
Output Template
# Deployment Report: [Name]
## Release
## Environments
## Commands
## Smoke Checks
| Check | Result | Evidence |
| --- | --- | --- |
| [check] | [PASS/FAIL/BLOCKED] | [evidence] |
## Rollback
## Next Workflow
publish-notes | retro-learn