Source version 1.0.0
Published
Initial: Initial published snapshot.
Published version comparison
1.0.0 → 2.0.0
1.0.0Published
Initial: Initial published snapshot.
2.0.0Published
Major: Replace the legacy CI/CD Deployment Safety Checklist Generator template with a domain-specific input, evidence, authority, safety, workflow, output, and verification contract.
CI/CD Deployment Safety Checklist Generator
CI/CD Deployment Safety Checklist Generator
Use Codex to inspect CI/CD pipelines, deployment scripts, release risks, migration behavior, secrets, health checks, rollback paths, and production readiness.
Use Codex to perform an evidence-based review of supplied CI/CD workflows, deployment scripts, migration behavior, configuration controls, observability, rollback readiness, and release verification plans without implying that production actions occurred.
Reviewing CI/CD pipelines with Codex to identify release risks, strengthen deployment gates, plan rollback steps, and verify production readiness.
Generate a traceable, release-specific safety checklist and risk register that helps developers and release managers identify blocking evidence gaps, define deployment and rollback gates, and prepare human approval for a production release.
CI/CD Pipeline Review Deployment Safety Checklist Rollback Planning Migration Safety Review Production Readiness Checks Release Verification
CI/CD Pipeline Review Deployment Safety Checklist Rollback Planning Migration Safety Review Production Readiness Checks Release Verification
Repository context Deployment pipeline files Hosting platform Release process Deployment environments Branching or merge strategy Environment variables and secrets Database migration behavior Build and test commands Health checks Post-deployment monitoring Rollback method Known deployment risks Definition of done
Repository and release scope Pipeline and deployment artifacts Platform and environment topology Migration and stateful workload details Verification and observability evidence Rollback and governance requirements
Paste this into Codex with your CI/CD workflow files, deployment scripts, hosting details, release notes, migration behavior, test commands, health checks, monitoring setup, and rollback method. Use the output before your next production deployment.
Open Codex, paste this prompt, and replace every variable with release-specific information. Provide the relevant repository files or excerpts, CI/CD workflows, deployment scripts, manifests, migration plans, command output, monitoring evidence, rollback documentation, and approval rules that Codex is permitted to inspect. Redact secret values and sensitive production data. Then run the prompt. Review proposed commands before executing them, provide real execution evidence separately if available, and require an authorized human to make any production decision.
A small SaaS team deploys through GitHub Actions and wants Codex to inspect the pipeline before launching billing changes. The prompt creates a release safety checklist covering tests, migrations, secrets, health checks, rollback steps, and post-deployment monitoring.
A SaaS team preparing billing changes supplies Codex with its GitHub Actions workflows, deployment script, environment topology, migration plan, test logs, health-check definitions, monitoring thresholds, and rollback runbook. Codex maps the artifact path, identifies evidence gaps and billing-related release gates, evaluates schema compatibility and rollback constraints, and returns a checklist whose actual-result fields remain unverified unless the team supplied corresponding run evidence.
Expert
Expert
Codex
Codex
coding
coding
codex ci-cd deployment-safety release-checklist pipeline-review rollback-plan production-readiness migration-safety secrets-review verification
codex ci-cd deployment-safety release-checklist pipeline-review rollback-plan production-readiness migration-safety secrets-review verification
Codex CI/CD Deployment Safety Checklist Prompt
Codex CI/CD Deployment Safety Checklist Generator
Use Codex to review CI/CD pipelines, release risks, migrations, secrets, health checks, rollback steps, and deployment safety.
Use Codex to review CI/CD evidence, migrations, release gates, observability, verification, and rollback readiness without unsupported completion claims.
Removed Added Unchanged context
You are an expert release engineer specializing in CI/CD pipelines, production release safety, rollback planning, migration safety, secrets handling, health checks, monitoring, and incident prevention. Your task is to inspect the provided CI/CD setup and create a practical deployment safety checklist that helps prevent avoidable release failures before production deployment. ## Context Use the context below. If any item is missing, clearly list it under “Missing Context” and make a conservative assumption before continuing. Repository context: [Repository context] Deployment pipeline files: [Deployment pipeline files] Hosting platform: [Hosting platform] Release process: [Release process] Deployment environments: [Deployment environments] Branching or merge strategy: [Branching or merge strategy] Environment variables and secrets: [Environment variables and secrets] Database migration behavior: [Database migration behavior] Build and test commands: [Build and test commands] Health checks: [Health checks] Post-deployment monitoring: [Post-deployment monitoring] Rollback method: [Rollback method] Known deployment risks: [Known deployment risks] Definition of done: [Definition of done] ## Important Constraints * Do not invent repository facts, deployment behavior, environment variables, secrets, policies, monitoring tools, or test results. * Separate confirmed evidence from assumptions. * Do not recommend production deployment if critical safety information is missing. * Pay special attention to migrations, secrets, permissions, queues, caches, scheduled jobs, external APIs, payment flows, and user-facing routes. * Include human review gates for high-risk releases such as billing, authentication, permissions, data deletion, migrations, security, customer-facing changes, or infrastructure changes. * Prefer small, practical release-safety improvements over broad rewrites. * Do not expose secret values. Refer only to secret names or configuration keys. * Make every recommendation specific to the provided files, deployment process, and hosting environment. ## Step-by-Step Task Instructions 1. Review the deployment pipeline. Inspect: * CI/CD workflow files * Build steps * Test steps * Deployment commands * Environment selection * Branch or tag triggers * Manual approval gates * Secrets usage * Cache behavior * Artifact handling * Notifications Review the supplied release materials and produce an evidence-traceable CI/CD deployment safety assessment. Use Codex to inspect the repository and only files, text, command output, and repository context that are actually supplied or available in the current session. Do not imply access to a repository, CI provider, cloud account, secrets store, database, monitoring system, or production environment unless that access is demonstrably available. 2. Identify release risks. Look for: Inputs * Missing tests * Weak pre-deployment checks * Unsafe migration timing * Missing rollback path * Missing health checks * Missing monitoring * Missing manual approval * Secrets exposure risk * Environment mismatch * Deployment order problems * Queue, cache, or cron risks * External API dependency risks Repository and release scope: [Repository and release scope] Pipeline and deployment artifacts: [Pipeline and deployment artifacts] Platform and environment topology: [Platform and environment topology] Migration and stateful workload details: [Migration and stateful workload details] Verification and observability evidence: [Verification and observability evidence] Rollback and governance requirements: [Rollback and governance requirements] 3. Assess migration safety. Review: Input expectations * Whether migrations are reversible * Whether migrations are backward compatible * Whether deployment and migration order is safe * Whether rollback would break schema compatibility * Whether data backup or snapshot is needed * Whether long-running migrations could affect users The repository and release scope should identify the change set, affected services, release reference, critical user flows, external dependencies, and known high-risk changes such as billing, authentication, authorization, data deletion, or infrastructure changes. Pipeline and deployment artifacts should include relevant workflow files, reusable workflows, deployment scripts, manifests, infrastructure definitions, build configuration, test commands, and release instructions. Platform and environment topology should describe environments, promotion flow, deployment strategy, runtime components, regions, traffic routing, queues, caches, scheduled jobs, and secret or identity mechanisms without exposing secret values. Migration and stateful workload details should cover schema and data migrations, compatibility assumptions, expected duration, locking risk, backups, restoration, and interactions with workers or older application versions. Verification and observability evidence should provide health checks, smoke tests, dashboards, alerts, logs, service-level indicators, prior command output, and acceptance thresholds. Rollback and governance requirements should identify rollback or roll-forward procedures, approval owners, change windows, incident contacts, communication requirements, and the release definition of done. 4. Assess secrets and configuration safety. Review: Input and evidence rules * Required environment variables * Missing or risky secrets * Production vs staging differences * Secret exposure risks in logs * Configuration drift risks * Whether deployment depends on undocumented values 1. Create an input ledger before drawing conclusions. Classify each needed item as supplied, observed in an accessible artifact, conflicting, missing, or not applicable. Cite file paths and line ranges when available; otherwise cite the supplied input section or evidence item. 2. Never invent workflow behavior, provider settings, branch protection, environment rules, test outcomes, secret values, migration reversibility, backup validity, monitoring coverage, approvals, or production state. 3. If inputs conflict, record both claims, identify their sources, explain the safety consequence, and request the authoritative source. Do not silently choose one. 4. If a critical fact is missing, mark the affected conclusion unverified and make the release disposition Blocked when safe deployment depends on that fact. Noncritical gaps may receive a clearly labeled conservative hypothesis, but a hypothesis is not evidence. 5. Treat documentation as evidence of an intended process, not proof that a control ran. Treat configuration as evidence of a configured control, not proof of successful execution. Treat logs, CI run records, signed approvals, artifact metadata, command output, or monitoring observations as execution evidence only when their source and release relevance are supplied. 6. Use these work-state labels consistently: Requested for work the user asked for; Proposed for changes or commands not applied; Executed only for an action actually performed in the current session; Unavailable when access or capability is absent; Unverified when evidence is insufficient. Every claim that something was tested, fixed, deployed, rolled back, approved, or verified must include execution evidence. Otherwise label it Proposed or Unverified. 7. Bind every material piece of evidence to the exact release under review. A passing test, approval, artifact, log entry, monitoring observation, or prior deployment from another commit, branch, artifact digest, environment, configuration state, or execution window is not evidence for this release unless a traceable relationship is supplied. Record the commit, release reference, artifact identity, target environment, and evidence timestamp where available. 5. Build a pre-deployment checklist. Include: Authority and safeguards * Code review checks * Test checks * Build checks * Migration checks * Secrets checks * Environment checks * Backup checks * Monitoring checks * Approval checks * Communication checks Unless [Rollback and governance requirements] expressly restrict access, permit read-only repository inspection and non-mutating diagnostics within the workspace actually available to Codex. 6. Build a deployment checklist. Include: Treat file edits, mutating commands, pipeline or configuration changes, database writes or migrations, secret rotation, infrastructure changes, deployment, rollback, production access, and external side effects as unauthorized unless expressly approved. * Deployment command or pipeline trigger * Order of operations * Required human approvals * What to watch during deployment * What should pause the release * What should stop the release * Who should be available during deployment Do not deploy, merge, approve, rotate secrets, alter infrastructure, run migrations, modify production data, disable controls, or trigger rollback. If a read-only check against a production target is expressly authorized and Codex has demonstrable access, limit it to a clearly non-mutating command against the stated target. Record the exact command, target, exit status, relevant output, time, and limitations. 7. Build a post-deployment verification checklist. Include: Never run destructive, state-changing, costly, financially consequential, or irreversibly production-affecting commands within this prompt. Otherwise provide commands as Proposed and do not fabricate output. * Health check URLs * Smoke tests * Login or authentication checks * Critical user-flow checks * API checks * Queue or background job checks * Log checks * Error-rate checks * Payment or billing checks, if applicable * Database or data-integrity checks Do not reproduce secret values, tokens, credentials, private keys, customer data, or sensitive log content. Refer to secret names or redacted identifiers only. Flag excessive permissions, untrusted code paths with secret access, unsafe pull-request triggers, command injection surfaces, unpinned third-party actions, mutable artifacts, and credential persistence. Human approval remains mandatory for production release decisions and for changes involving billing, identity, permissions, security controls, destructive data operations, non-backward-compatible migrations, or infrastructure replacement. 8. Build a rollback checklist. Include: Focused review workflow * Rollback trigger conditions * Code rollback steps * Migration rollback or mitigation steps * Configuration rollback * Cache or queue rollback considerations * Monitoring after rollback * User communication if needed * Final confirmation that service is stable 1. Trace the failure modes and map the delivery path from source trigger to production: event and branch or tag filters, pull-request trust boundary, build, tests, artifact creation, provenance or digest handling, promotion, environment selection, deployment, verification, and rollback. Identify reusable workflows and dependencies that can alter this path. 2. Inspect trigger and concurrency safety. Check accidental production triggers, skipped required jobs, path-filter blind spots, duplicate deployments, cancellation behavior, race conditions, environment locks, release serialization, and whether the deployed commit or artifact is uniquely identified. 3. Inspect identity, permissions, and supply-chain controls. Check least-privilege workflow permissions, OIDC or credential scope where evidenced, secret availability by event and environment, masking and log exposure, dependency or action pinning, artifact integrity, provenance, retention, and separation between build and deploy authority. 4. Inspect build and test gates. Trace dependency installation, lockfile enforcement, deterministic builds, static checks, unit and integration tests, security checks where required, failure propagation, retry behavior, test exclusions, coverage of critical flows, and whether the exact promoted artifact passed the cited checks. 5. Inspect environment and deployment correctness. Check staging-to-production parity, configuration validation, immutable artifact promotion, deployment strategy, traffic shifting, readiness versus liveness semantics, timeout behavior, partial failure across services or regions, infrastructure ordering, external API dependencies, maintenance requirements, and idempotency of repeated deployment attempts. 6. Inspect migration and stateful-component safety. Evaluate expand-and-contract compatibility, application and migration order, mixed-version operation, transaction and lock behavior, table rewrites, long-running backfills, retry and resume behavior, data validation, queue payload compatibility, worker draining, cron overlap, cache-key or serialization changes, backup freshness, restore evidence, and whether rollback would leave code and schema compatible. Treat an unproven destructive or irreversible migration as a blocking risk. 7. Inspect observability and release control. Check that health endpoints test meaningful dependencies without leaking data; smoke tests cover critical user journeys; dashboards and alerts identify error rate, latency, saturation, queue lag, failed jobs, database health, and business-critical signals; thresholds, observation windows, owners, and escalation paths are defined. 8. Build rollback and roll-forward logic. Define measurable triggers, decision owner, last known good artifact, code and configuration restoration, schema mitigation, traffic restoration, queue and cache handling, external side-effect reconciliation, user communication, and post-recovery verification. Do not call rollback viable without evidence that required artifacts, procedures, permissions, and schema compatibility exist. 9. Prioritize findings using impact and likelihood rated Low, Medium, High, or Critical. Distinguish release blockers from required follow-ups and optional hardening. Prefer the smallest control that materially reduces the identified risk; do not recommend broad platform rewrites without evidence that they are necessary. Base impact and likelihood on release-specific evidence. Do not infer likelihood solely from generic industry experience or the theoretical existence of a failure mode. When the available evidence cannot support a defensible likelihood rating, mark likelihood Unverified, explain the uncertainty, and state what evidence is needed. 9. Recommend pipeline improvements. Suggest small improvements that reduce risk, such as: Output contract: required CI/CD safety deliverable * Required status checks * Manual approval gates * Staging deployment before production * Automated smoke tests * Safer migration strategy * Better secret validation * Better deployment notifications * Better rollback documentation * Release notes or changelog checks * Post-release monitoring automation Produce the following task-specific sections in markdown. 10. Produce final release guidance. State clearly: A. Review basis and evidence ledger * Whether the release appears safe, risky, or blocked * What must be fixed before deployment * What should be monitored after deployment * What a human reviewer must confirm * What the safest next action is Provide a table with Evidence ID, item or artifact, source locator, relevance to this release, evidence class, and status. Evidence class must distinguish intended process, static configuration, and execution evidence. Follow it with missing and conflicting inputs, their consequences, and the exact evidence needed to resolve each one. ## Output Format B. Delivery-path map ### Executive Summary Describe the evidenced path from trigger to production in order. For every stage list trigger or input, responsible workflow or script, output artifact or state transition, environment, controlling gate, and evidence ID. Mark inferred or unknown transitions explicitly. ### Missing Context C. Risk register ### Pipeline Risk Review Provide Finding ID, delivery stage, failure mode, supporting evidence IDs, impact, likelihood, severity, affected environment or service, release consequence, required mitigation, owner or approver if supplied, and state. Include concrete findings for triggers, permissions, secrets, artifact integrity, tests, environment drift, deployment ordering, migrations, stateful workers, health checks, monitoring, and rollback when relevant. Do not create findings unsupported by the supplied architecture; record missing evidence instead. ### Migration Safety Review D. Release gate checklist ### Secrets and Configuration Review Create ordered Pre-deployment, Deployment, and Post-deployment gates. Each checklist row must contain Gate ID, check, reason, execution target, method or proposed command, expected observation, supplied actual observation, evidence ID, pass criterion, stop or pause condition, responsible human, and state. Leave actual observation as Not supplied unless real output exists. Commands must identify assumptions and must not expose secrets or mutate production. ### Pre-Deployment Checklist Include, where applicable, confirmation of the exact commit and immutable artifact; required CI results; configuration-key presence without values; environment and identity target; backup and restoration evidence; backward-compatible migration sequence; worker, queue, cache, and scheduler coordination; approval and communication gates; deployment progress; health and readiness; critical API and user-flow smoke tests; error, latency, saturation, queue, database, and business-signal thresholds; and an observation window. ### Deployment Checklist E. Migration and stateful-workload decision record ### Post-Deployment Verification Checklist State the proposed sequence for application versions, schema changes, backfills, workers, queues, caches, and scheduled jobs. Document compatibility across old code, new code, old schema, and new schema; lock and duration concerns; abort criteria; backup or restoration prerequisites; data-integrity reconciliation; and rollback versus roll-forward constraints. For each conclusion cite evidence or mark it Unverified. ### Rollback Checklist F. Rollback readiness record ### Recommended Pipeline Improvements Provide rollback trigger, decision owner, code or artifact action, configuration action, database mitigation, traffic action, queue and cache handling, external side-effect reconciliation, communications, verification check, expected observation, and evidence. Identify the point after which rollback becomes unsafe and a roll-forward is required. Mark readiness Unverified if no tested procedure or equivalent execution evidence is supplied. ### Verification Commands and Manual Checks G. Verification plan and evidence requirements ### Human Review Gates For each proposed verification, give the exact non-destructive command or manual action, target environment, prerequisite, expected observation, acceptance threshold, failure interpretation, evidence to retain, and current work state. Reconcile the deployed release identity with the reviewed commit and artifact digest. Reconcile migration version and data checks with the expected release state. Reconcile health and smoke-test results with monitoring over the stated observation window. Never populate actual results unless they were supplied or executed with recorded evidence. ### Final Release Recommendation H. Release disposition ## Verification Choose exactly one disposition: Blocked, Conditional candidate for human approval, or Ready for human approval. This is advice, not approval or authorization to deploy. Before finalizing, confirm that: List the decisive evidence, unresolved blockers, conditions that must be satisfied, required human gates, monitoring obligations, and safest next action. A disposition of Ready for human approval requires traceable evidence that required tests passed for the reviewed release artifact, the deployment target is identified, migration and configuration prerequisites are satisfied, meaningful health and smoke checks have acceptance thresholds, observability and escalation are active, and rollback or roll-forward is operationally credible. If any required evidence is missing, use Blocked or Conditional candidate for human approval. * The checklist covers tests, migrations, secrets, health checks, monitoring, and rollback paths. * All risky assumptions are clearly labeled. * No secret values are exposed. * The release recommendation is based on the provided context. * Human review gates are included for high-risk changes. * The output is specific enough for a developer or release manager to use before deployment. Keep every section concise and proportional to the release’s actual scope and risk. Do not repeat the same evidence across multiple sections unnecessarily. Where a section or control area is genuinely not applicable, retain the heading, state Not applicable, and explain briefly why using the supplied release evidence. Never omit the evidence ledger, risk register, release gates, release disposition, or completion-integrity distinctions. ## Final Instruction to Begin Final integrity check Begin now. If required context is missing, list the missing items first. Otherwise, inspect the provided CI/CD and deployment context and produce the full release safety checklist in the requested markdown format. Before returning the deliverable, confirm that every material conclusion cites evidence or is marked Unverified; every proposed command has a target and expected observation; every completion claim has execution evidence; no secret value appears; migration, stateful components, artifact identity, monitoring, and rollback were addressed when applicable; and the disposition does not exceed the available evidence or human authority.