deployment-workflow

Generates rollback procedures, migration checklists, smoke tests, and release notes before deployment.

Updated May 21, 2026
One-click install
npx skills add https://github.com/CagesThrottleUs/private-ai-harness --skill deployment-workflow-cagesthrottleus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deployment-workflow
Source: https://github.com/CagesThrottleUs/private-ai-harness/tree/main/skills/deployment-workflow
Command: npx skills add https://github.com/CagesThrottleUs/private-ai-harness --skill deployment-workflow-cagesthrottleus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shipping a change without a tested rollback path, migration plan, or smoke test spec turns every deploy into a potential incident. This Skill produces all deployment artifacts before the PR is opened, so releases have a verified recovery path and objective go/no-go gates. ## Core Features & Use Cases - Deployment strategy selection: Recommends Rolling, Blue-Green, Canary, or Dark Launch based on system type and change risk, with automated canary analysis via Argo Rollouts, Flagger, or Kayenta. - Zero-downtime migration checklists: Applies the Expand-Contract pattern per database migration with batched backfill rules and per-phase rollback actions. - Rollback, smoke tests, and release notes: Writes a step-by-step rollback runbook, three-phase post-deploy smoke test spec, and Keep a Changelog release notes generated from Conventional Commits. - Use Case: Before merging a feature branch that adds an endpoint and a schema migration, run this Skill to produce the rollback procedure, migration checklist, smoke tests, and deploy runbook, then have the deployment-reviewer agent verify them before the PR opens. ## Quick Start Ask the AI to run the deployment workflow for the current branch to produce the rollback procedure, migration checklist, smoke tests, and release notes before opening the PR.

Frequently Asked Questions about deployment-workflow

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

FAQPage Schema
How do I create a rollback procedure before deploying?

Run this Skill before opening the PR. It writes a rollback document with trigger conditions, pre-rollback steps, platform-specific commands for Kubernetes, blue-green, or canary rollbacks, and a five-minute post-rollback verification checklist.

What is the expand-contract pattern for zero-downtime database migrations?

Expand-contract splits a breaking schema change into three deployments: expand adds the new nullable structure while code writes to both old and new, migrate backfills data in small batches, and contract removes the old structure only after code stops reading it.

How do I choose between rolling, blue-green, and canary deployments?

Choose based on change risk: rolling for stateless services, blue-green for stateful or database-heavy changes needing instant router-level rollback, and canary for high-traffic features needing gradual validation from 1% to 100% traffic.

Can canary rollbacks be automated instead of manually monitored?

Yes. The Skill requires an analysis definition enforced by the rollout controller, such as an Argo Rollouts AnalysisTemplate or Flagger MetricTemplate, which queries SLO-based SLIs at each traffic step and auto-aborts on threshold breaches.

When should the deployment workflow be skipped?

Skip it for documentation-only changes and config-only changes with no runtime effect. Any change touching user-facing behavior, database schema, endpoints, or runtime dependencies requires the full artifact set.

What happens if the error budget is exhausted before a release?

The release is blocked. Only P0 or security fixes ship with explicit reliability approval until the budget recovers, following the Google SRE error-budget policy that prevents feature velocity from silently degrading reliability.