Resource 05 · Release evidence

Pre-deploy checklist runner

Run a release-focused review across tests, migrations, configuration, secrets, monitoring, rollback, and operational ownership.

Copyable AI skillPracticalYours to use

What it examines

A focused review with evidence boundaries.

The skill is intentionally read-only. It separates confirmed findings from missing evidence and never treats an absent file as proof that a control exists.

01

Change scope and release owner

02

Automated checks and critical-path tests

03

Database migrations and compatibility

04

Configuration and secret readiness

05

Observability and alert routing

06

Rollback and recovery evidence

Run the skill

Paste it into your AI coding assistant.

Open the repository in your preferred coding assistant, give it read access to the project, then paste this instruction. Review its evidence before acting on any recommendation.

Download .md

Act as the release engineer responsible for a go/no-go decision on the current change. Inspect the repository, current diff, and checked-in CI/deployment configuration. Do not modify files, install dependencies, deploy, run migrations, contact production, rotate secrets, or alter persistent data.

Optional context from me may follow: target environment, release window, change/ticket, intended behavior, critical workflows, owners, and acceptable downtime. If absent, infer cautiously from the diff and state the assumptions.

Procedure
1. Define the release unit. Report branch/commit when available, changed files, affected services, dependency/lockfile changes, schema/data migrations, infrastructure/configuration changes, feature flags, API/events/contracts, and generated artifacts. Separate relevant changes from unrelated working-tree changes.
2. Explain intent and blast radius. For every changed boundary, identify callers, consumers, data touched, permissions, money/entitlements, external integrations, background jobs, and user journeys. Flag changes whose intended behavior cannot be determined.
3. Discover verification commands from package manifests, task runners, CI workflows, and contributor docs. Run only existing safe local lint, format-check, type-check, build, unit, and integration commands that do not require production access or destructive services. Record command, duration if available, exit code, failures, and what was skipped. Never convert “not run” into “pass.”
4. Review tests by behavior. Confirm changed critical paths have success, denial, invalid-input, retry/duplicate, concurrency, and rollback/compatibility coverage where relevant. Detect tests that assert mocks or snapshots without proving the changed boundary.
5. Review migrations and compatibility. Check expand/migrate/contract order, old/new application coexistence, locks and runtime, defaults/backfills, nullability, indexes, irreversible transformations, queue/event schema compatibility, mobile/client version skew, and downgrade behavior.
6. Review configuration and secrets. Identify every new variable, permission, key, endpoint, flag, scheduled job, and infrastructure dependency; prove validation/default behavior and environment parity without printing values.
7. Review operational readiness. Verify health/readiness checks, structured telemetry, correlation, dashboards/queries, alert owner, safe rollout mechanism, feature flag or traffic control, capacity impact, backup/restore relevance, and an executable rollback or forward-fix path.
8. Define release invariants: the small set of measurable conditions that must remain true during and after rollout—for example authorization denials, transaction reconciliation, error rate, latency, queue age, data counts, or job completion.

Decision rules
- NO-GO: any unresolved Critical/High risk involving security, tenant isolation, money, irreversible data, incompatible migration/contract, no safe rollback for a high-impact change, failing required check, or unknown behavior on a critical path.
- CONDITIONAL GO: no critical blocker; bounded risks have explicit mitigations, owners, deadlines, and measurable acceptance/rollback criteria.
- GO: required checks pass, compatibility and rollback are credible, observability can detect failure, and the critical path is evidenced.

Output exactly these sections
1. Release decision — GO / CONDITIONAL GO / NO-GO, confidence, release unit, top reason.
2. Change and blast-radius map — changed component, intended behavior, downstream consumers, data/permission impact, evidence.
3. Verification results — command, result, exit code, evidence covered, limitation. Include skipped/unavailable checks.
4. Blocking findings — severity, evidence, failure scenario, business impact, smallest resolution, objective recheck.
5. Non-blocking follow-up — owner role, deadline relative to release, and acceptance criterion.
6. Migration and compatibility plan — pre-deploy, deploy, post-deploy, old/new coexistence, rollback/forward-fix, data verification.
7. Release runbook — ordered steps with owner role and hold points. Do not execute it.
8. Observation plan — metric/query/log, baseline, threshold, observation window, owner, and action.
9. Rollback decision — precise triggers, latest safe decision point, procedure, data implications, and verification after rollback.
10. Open owner questions — only questions whose answers can change the decision.

Keep the output specific to this diff. Avoid generic checklist filler. A green build is evidence, not proof of production safety; a failed or unavailable check must remain visible in the decision.

Expected output

A decision-ready result, not a vague code review.

Use the result as a starting point. High-risk findings still need human review before production changes are made.

  1. 01A go/no-go recommendation
  2. 02Blocking checks separated from follow-up work
  3. 03Commands and evidence reviewed
  4. 04Rollback trigger and procedure
  5. 05Named post-release observations

Choose the next useful step

Use the result to ask a better engineering question.

The skill gives you a structured first pass. A senior review turns the evidence into an accountable decision.

Scroll to Top