checklists
Release Readiness Checklist.
Release Process A comprehensive pre-release gate covering scope freeze, test execution, defect status, automation results, performance, security and accessibility sign-off, documentation, monitoring, rollback readiness, and stakeholder sign-off.
When to use this checklist
- As the final quality gate before a production release or major version bump
- At the end of a sprint or release cycle when the team is preparing to cut a branch
- After a hotfix to verify the fix is complete and no regression has been introduced
- When onboarding a new team that needs a structured release process
- As an audit checklist for a post-incident release after a production outage
A release is only as good as the checks run before it ships. This checklist walks through every exit criterion for a production deployment: scope and requirements alignment, test execution completeness, defect status, automation health, performance baselines, security and accessibility clearance, documentation and runbook readiness, monitoring and alerting configuration, and a validated rollback path. Complete it as a team — QA, engineering, and product — so sign-off is explicit and traceable.
0/32
Scope & Requirements Freeze
0/4Confirm the release scope is locked and all acceptance criteria are documented before testing begins.
Test Execution & Coverage
0/5Verify all planned tests have been executed and coverage targets are met.
Defect Status & Sign-off
0/4Confirm all blockers are resolved and outstanding defects are triaged to an acceptable risk level.
Automation Health
0/3Verify the automation suite is green, stable, and reflects the actual application state.
Performance & Load Checks
0/4Confirm the release does not introduce performance regressions relative to the previous version.
Security & Accessibility Sign-off
0/3Confirm security and accessibility gates have been met for this release.
Documentation & Runbooks
0/4Verify that release notes, API docs, and operational runbooks are complete before deployment.
Monitoring, Alerting & Rollback
0/5Confirm the team has visibility into the deployment and a tested path to revert if needed.
Common Bugs
Release regression suite run against a different build than what deploys
The QA team runs regression tests against build artifact v1.2.3-rc1, but the deployment pipeline deploys v1.2.3-rc2 (with a last-minute hotfix). The un-tested build ships. Always record the exact build hash in the sign-off document and verify it matches the deployment artifact.
Database migration takes 45 minutes on production, causing a multi-hour outage
The migration was tested on a 10,000-row staging database and took 3 seconds. Production has 50 million rows. The migration locks the table for 45 minutes. Always test migrations against a production-sized dataset and implement zero-downtime migration patterns (add column, backfill, rename).
Feature flag defaults to ON in production when it should be OFF
The new feature was gated behind a flag configured OFF in staging. In production, the flag config was not updated, and the default value was ON. The incomplete feature shipped to all users. Always explicitly set production flag state in the release runbook and verify it post-deploy.
Rollback invalidates existing user sessions — forces all users to log in again
The release included a session token format change. The rollback reverted the session handling code, but sessions created during the new version are now invalid. All active users are logged out simultaneously. Test rollback scenarios for session compatibility before releasing changes to auth.
Monitoring dashboards not updated — new endpoints have no visibility for 48 hours post-release
A new API endpoint is added but no alert or dashboard panel is created for it. An elevated error rate on the new endpoint goes undetected until users report issues. Always include dashboard and alert updates in the release checklist — treat observability as a feature, not an afterthought.
Recommended Tools
Automates the CI gate for the release branch — runs the full test suite, coverage check, SAST scan, and build artifact creation in a single pipeline.
Generates visual test execution reports showing pass/fail/skip with history trends — ideal for the sign-off step where stakeholders review test results.
Measures Core Web Vitals (LCP, CLS, INP) on the release candidate. Run via the Node CLI in CI to catch performance regressions before they reach production.
Load-tests the release candidate at expected peak traffic to validate API p95 response times and confirm rate limits hold.
Real-time error tracking post-release. Configure a release version tag so error rates can be compared pre- and post-deployment during the canary window.
// Related resources