release-rollback

Plan rollback and forward-fix actions for production releases across code, schema, flags, caches, jobs, and integrations.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/machenjie/rd-skills --skill release-rollback-machenjie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-rollback
Source: https://github.com/machenjie/rd-skills/tree/main/src/foundation/capabilities/release-rollback
Command: npx skills add https://github.com/machenjie/rd-skills --skill release-rollback-machenjie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents chaotic incident-driven recovery by helping release owners pre-plan how to rollback or forward-recover every changed surface—code, configuration, database, feature flags, caches, jobs, and external integrations—using measurable triggers and a validated runbook.

Core Features & Use Cases

  • Per-surface rollback planning: Defines independent rollback methods for code, schema, config, flags, caches, background jobs, and external integrations instead of assuming a single “redeploy previous version” is sufficient.
  • Database rollback strategy: Specifies reversible migrations with tested DOWN scripts or, when not reversible, requires an explicit forward-fix plan reviewed before production deployment.
  • Mixed-version compatibility sequencing: Ensures expand-contract ordering so the deployment avoids the unsafe state (new code + old schema) during rolling and canary/blue-green phases.
  • Measurable rollback triggers: Converts rollback decisions into thresholds tied to monitoring metrics, including trigger duration and measurement tool expectations.

Quick Start

Use the release-rollback skill to generate a complete rollback runbook for your next production release, including changed-surface actions, rollback triggers, decision owner, mixed-version sequencing, and post-rollback validation.

Frequently Asked Questions about release-rollback

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a rollback strategy for database schema changes during a production release?

Database rollback strategy requires specifying reversible migrations with tested DOWN scripts, or an explicit forward-fix plan reviewed before production deployment when migrations are not reversible.

What's the best way to define measurable rollback triggers for a canary deployment?

Measurable rollback triggers are defined by converting rollback decisions into specific thresholds tied to monitoring metrics, including trigger duration and measurement tool expectations for your canary deployment.

How do you ensure mixed-version compatibility during rolling or blue-green deployments?

Mixed-version compatibility uses expand-contract ordering to ensure deployments avoid the unsafe state of new code running against an old schema during rolling and canary or blue-green deployment phases.

Why is redeploying the previous version not enough for a complete production rollback?

Redeploying previous code is insufficient because a complete rollback requires independent recovery methods for configuration, feature flags, caches, background jobs, and external integrations, plus a structured post-rollback validation checklist.

Do I need a rollback runbook for external integrations and feature flags?

Yes, rollback runbooks require documented feature flag safe defaults and explicit external provider reversal steps to ensure all changed surfaces are recovered safely during emergency reversal scenarios.

When do I need to use release-rollback for my deployment safety planning?

Release-rollback is needed for production and shared-environment deployments, including canary or rolling strategies, schema changes, and emergency reversal scenarios for previously promoted releases to prevent chaotic incident-driven recovery.