Deploy Checklist
Generate comprehensive deployment checklists for safe, documented releases.
When to Use This Skill
- Before deploying a new release to any environment
- When preparing for production deployments
- When you need a documented rollback plan
- For compliance or audit requirements around deployments
- When onboarding team members to deployment processes
Input
Provide the following:
Target
- Service or application name
- Target environment (staging, production, etc.)
- Release version or tag
Scope
- Commits or PRs included in this release
- Features being released
- Bug fixes included
Strategy Preference (optional)
- Rolling update
- Blue-green
- Canary
- Or let the checklist recommend based on risk
Workflow
Step 1: Analyze Changes
Review what's being deployed:
- List commits since last deployment
- Identify database migrations
- Note configuration changes
- Check dependency updates
- Flag feature flag changes
Step 2: Assess Risk
Evaluate deployment risk:
- Breaking changes
- Migration complexity
- Rollback difficulty
- Blast radius
Step 3: Generate Pre-flight Checklist
Create verification items for:
- Code Readiness - tests pass, reviewed, merged
- Environment Readiness - resources available, configs updated
- Observability - dashboards ready, alerts configured
- Communication - stakeholders notified, runbook available
Step 4: Define Rollout Strategy
Based on risk assessment, recommend:
- Rollout type (rolling, blue-green, canary)
- Traffic progression (for canary)
- Rollout steps with verification gates
- Timeline estimate
Step 5: Create Verification Checklist
Define what to check after deployment:
- Immediate (0-5 min) - pods healthy, no errors
- Short-term (5-30 min) - metrics normal, features working
- Extended (30 min - 2 hr) - performance stable, no regressions
Step 6: Document Rollback Plan
For every deployment, include:
- Rollback trigger conditions
- Rollback commands/steps
- Rollback verification
- Communication plan if rollback needed
Output
Produce a deployment checklist following the template in references/deploy-checklist-template.md.
The checklist should include:
- Summary (service, environment, version, date)
- Changes included (features, fixes, migrations, dependencies)
- Pre-flight checklist
- Deployment strategy with steps
- Verification checklist by time window
- Rollback triggers and plan
Investigation Areas
| Area |
What to Check |
| Code |
Changes, migrations, config, dependencies, flags |
| Infrastructure |
Manifests, resources, scaling, env config |
| History |
Previous deployments, known issues, incidents |
Constraints
- Checklist only - this skill generates documentation, not executes deployments
- Always include rollback - every checklist must have a rollback plan
- Be specific - include actual commands, not just descriptions
- Risk-appropriate - match strategy complexity to deployment risk
Example
Example: API Service Production Deploy
Input:
- Service:
user-api
- Environment:
production
- Version:
v2.3.0
- Changes: 3 features, 1 migration, 2 bug fixes
Output Summary:
Deployment: user-api v2.3.0 → production
Risk Assessment: MEDIUM
- Database migration (additive, backward compatible)
- New authentication flow (feature flagged)
Strategy: Canary (10% → 50% → 100%)
Pre-flight:
✓ All tests passing
✓ Migration tested in staging
✓ Feature flag configured (disabled by default)
✓ Dashboards bookmarked
✓ On-call notified
Rollback Triggers:
- Error rate > 1%
- P99 latency > 500ms
- Migration failure
Rollback Command:
kubectl rollout undo deployment/user-api -n production
Begin by analyzing the changes included in this deployment before generating the checklist.
1---2name: deploy-checklist3description: Generate deployment checklists with pre-flight checks, rollout strategy, and verification steps. Analysis only - does not execute deployments.4license: MIT5compatibility:6 - runtime:any7allowed-tools:8 - Read9 - Glob10 - Grep11 - Bash(git:log)12 - Bash(git:diff)13 - Bash(git:show)14metadata:15 source: https://skillmd.com/skills/thoreinstein/deploy-checklist16 author: thoreinstein17 version: 1.0.018---1920# Deploy Checklist2122Generate comprehensive deployment checklists for safe, documented releases.2324## When to Use This Skill2526- Before deploying a new release to any environment27- When preparing for production deployments28- When you need a documented rollback plan29- For compliance or audit requirements around deployments30- When onboarding team members to deployment processes3132## Input3334Provide the following:35361. **Target**37 - Service or application name38 - Target environment (staging, production, etc.)39 - Release version or tag40412. **Scope**42 - Commits or PRs included in this release43 - Features being released44 - Bug fixes included45463. **Strategy Preference** (optional)47 - Rolling update48 - Blue-green49 - Canary50 - Or let the checklist recommend based on risk5152## Workflow5354### Step 1: Analyze Changes5556Review what's being deployed:57- List commits since last deployment58- Identify database migrations59- Note configuration changes60- Check dependency updates61- Flag feature flag changes6263### Step 2: Assess Risk6465Evaluate deployment risk:66- Breaking changes67- Migration complexity68- Rollback difficulty69- Blast radius7071### Step 3: Generate Pre-flight Checklist7273Create verification items for:74- **Code Readiness** - tests pass, reviewed, merged75- **Environment Readiness** - resources available, configs updated76- **Observability** - dashboards ready, alerts configured77- **Communication** - stakeholders notified, runbook available7879### Step 4: Define Rollout Strategy8081Based on risk assessment, recommend:82- Rollout type (rolling, blue-green, canary)83- Traffic progression (for canary)84- Rollout steps with verification gates85- Timeline estimate8687### Step 5: Create Verification Checklist8889Define what to check after deployment:90- **Immediate (0-5 min)** - pods healthy, no errors91- **Short-term (5-30 min)** - metrics normal, features working92- **Extended (30 min - 2 hr)** - performance stable, no regressions9394### Step 6: Document Rollback Plan9596For every deployment, include:97- Rollback trigger conditions98- Rollback commands/steps99- Rollback verification100- Communication plan if rollback needed101102## Output103104Produce a deployment checklist following the template in `references/deploy-checklist-template.md`.105106The checklist should include:107- Summary (service, environment, version, date)108- Changes included (features, fixes, migrations, dependencies)109- Pre-flight checklist110- Deployment strategy with steps111- Verification checklist by time window112- Rollback triggers and plan113114## Investigation Areas115116| Area | What to Check |117| ------------------ | ------------------------------------------------ |118| **Code** | Changes, migrations, config, dependencies, flags |119| **Infrastructure** | Manifests, resources, scaling, env config |120| **History** | Previous deployments, known issues, incidents |121122## Constraints123124- **Checklist only** - this skill generates documentation, not executes deployments125- **Always include rollback** - every checklist must have a rollback plan126- **Be specific** - include actual commands, not just descriptions127- **Risk-appropriate** - match strategy complexity to deployment risk128129## Example130131### Example: API Service Production Deploy132133**Input:**134- Service: `user-api`135- Environment: `production`136- Version: `v2.3.0`137- Changes: 3 features, 1 migration, 2 bug fixes138139**Output Summary:**140```141Deployment: user-api v2.3.0 → production142143Risk Assessment: MEDIUM144- Database migration (additive, backward compatible)145- New authentication flow (feature flagged)146147Strategy: Canary (10% → 50% → 100%)148149Pre-flight:150✓ All tests passing151✓ Migration tested in staging152✓ Feature flag configured (disabled by default)153✓ Dashboards bookmarked154✓ On-call notified155156Rollback Triggers:157- Error rate > 1%158- P99 latency > 500ms159- Migration failure160161Rollback Command:162kubectl rollout undo deployment/user-api -n production163```164165---166167Begin by analyzing the changes included in this deployment before generating the checklist.