Back to list
Harery

phase-07-deployment-release

by Harery

Enterprise 8-Phase Software Development Lifecycle Framework with Quality Gates, Multi-Agent Orchestration, and AI-Assisted Development using Claude Code. Perfect for regulated industries (HIPAA, SOC 2, PCI DSS, SOX, GDPR).

1🍴 0📅 Jan 22, 2026

SKILL.md


name: "phase_07_deployment_release" description: "Deploy validated build to production. Deployment strategy, pre-deployment checklist, staging deployment, production deployment, post-deployment validation, rollback planning, release documentation, and release closure." phase: 7 phase_name: "Deployment & Release" owner: "DevOps Lead" secondary_owner: "Technical Lead" participants: ["DevOps", "SRE", "Tech Lead", "QA Lead", "Security Lead", "Product Owner", "Project Manager"] entry_criteria: [ "Functional tests passing", "Integration tests passing", "Performance tests meeting SLAs", "Security tests passing", "Compliance validation complete", "UAT signed off", "Go/no-go approval received" ] exit_criteria: [ "Staging deployment successful", "Production deployment successful", "Post-deployment validation passing", "Monitoring and alerting active", "Release documentation published", "Stakeholders notified", "Rollback plan tested", "Release closure completed" ] estimated_duration: "1 week" dependencies: ["phase_06_quality_security"] outputs: [ "Deployment Plan", "Staging Deployment", "Production Deployment", "Release Notes", "Deployment Runbook", "Rollback Plan", "Monitoring Dashboards", "Release Sign-off" ] next_phase: "phase_08_operations_maintenance"

Phase 7: Deployment & Release

The Moment of Truth (With a Safety Net)

Welcome to Phase 7 - the culmination of all your hard work. You've planned, designed, coded, tested, and validated. Now it's time to put your software into production where real users can benefit from it.

This might feel nerve-wracking, but here's the truth: If you've done Phases 1-6 well, Phase 7 is the easiest part. You're not hoping for success - you're executing a well-planned deployment.

The mindset here: Deploy confidently, monitor closely, rollback gracefully if needed.


What You'll Achieve

By the end of this phase, you'll have:

  • Your software running in production
  • Users actually using what you built
  • Monitoring that tells you what's happening
  • A rollback plan (just in case)
  • Documentation that helps everyone understand what changed

What happens next: Phase 8 will focus on keeping everything running smoothly and continuously improving.


Who's Driving This Phase?

RoleWhat They're Responsible For
DevOps LeadYour deployment choreographer - making sure the dance goes smoothly
SREYour production guardian - watching for issues and ready to respond
Tech LeadTechnical validation - is what we deployed what we thought we deployed?
QA LeadFinal quality checks before and after deployment
Security LeadSecurity validation - is production as secure as staging?
Product OwnerRelease coordinator - making sure everyone knows what's happening and when

The Deployment Journey

Deployment isn't a single event - it's a carefully orchestrated process with multiple checkpoints.

Strategy → Staging → Validation → Production → Monitoring → Documentation → Closure

Each step builds confidence. Skip a step, and you're deploying on hope, not on preparation.

Step 1: Deployment Strategy (Plan Your Approach)

Time needed: 1 week Led by: DevOps Lead

Choose Your Deployment Style

Not all deployments are created equal. The right strategy depends on your system, your users, and your risk tolerance.

Deployment Strategies Explained

How it works: You maintain two identical production environments (blue and green). You deploy to the inactive one, test it, then switch traffic over.

Best for:

  • Zero-downtime requirements
  • Quick rollback capabilities
  • When you can afford double infrastructure costs

Pros:

  • Instant rollback (just switch traffic back)
  • Zero downtime if done right
  • Easy to test before going live

Cons:

  • Expensive (two full production environments)
  • Database migrations can be tricky
  • Requires careful traffic switching

Example: Deploy a new version of your API to green, run smoke tests, switch the load balancer to green. If issues arise, switch back to blue.

How it works: You gradually roll out the new version to a small subset of users, monitor for issues, and gradually increase if all looks good.

Best for:

  • Risk mitigation
  • When you're unsure about user acceptance
  • When you want to validate with real traffic

Pros:

  • Catches issues before affecting everyone
  • Gradual increase in confidence
  • Easy to rollback (just stop the rollout)

Cons:

  • More complex infrastructure
  • Need good monitoring (canary is useless if you can't detect issues)
  • Longer deployment timeframe

Example: Deploy new version to 5% of users, monitor error rates and performance. If stable after 1 hour, increase to 25%, then 50%, then 100%.

How it works: You incrementally replace instances of the old version with the new version, one or a few at a time.

Best for:

  • Large-scale deployments
  • When you have many instances behind a load balancer
  • When you want minimal infrastructure overhead

Pros:

  • No extra infrastructure needed
  • Gradual rollout (canary-like)
  • Easy to stop if issues arise

Cons:

  • Slower than blue-green
  • Running two versions simultaneously (compatibility concerns)
  • Rollback takes time (have to roll back each instance)

Example: In a 10-instance cluster, deploy to 2 instances, monitor, then deploy to 2 more, and so on.

How it works: You take the system down, deploy everything, and bring it back up.

Best for:

  • Simple systems with minimal complexity
  • Systems that can tolerate maintenance windows
  • When other strategies are overkill

Pros:

  • Simple to orchestrate
  • No compatibility concerns (everything changes at once)
  • Fast deployment (downtime is the main cost)

Cons:

  • Downtime is required
  • Risky (if something goes wrong, everything is down)
  • Rollback is slow (have to redeploy old version)

Example: Deploy during a scheduled maintenance window (e.g., Sunday 2-4 AM when traffic is minimal).

What You'll Have

Expected Output:

  • Deployment strategy document (which approach and why)
  • Deployment schedule (when it will happen)
  • Rollback strategy (how to undo if needed)
  • Communication plan (who needs to know what and when)
  • Deployment runbook (step-by-step instructions)

Who Approves:

  • DevOps Lead owns the strategy
  • SRE validates operability
  • Tech Lead validates technical approach
  • Product Owner validates the schedule

Step 2: Pre-Deployment Checklist (Ready, Set, Wait)

Time needed: 1 week Led by: DevOps + SRE

The Final Checks Before Production

This is your pre-flight checklist. Every item matters. Skip one, and you're rolling the dice.

Pre-Deployment Checklist

  • Staging environment matches production - Same specs, same configuration, same data (anonymized)
  • Monitoring and alerting configured - Dashboards ready, alerts tested, on-call assigned
  • Log aggregation active - Logs are being collected and can be searched
  • Backup procedures verified - Backups are running, restores have been tested
  • Rollback procedures tested - You've actually rolled back in staging (don't test in production!)
  • Security scan passed - No new vulnerabilities introduced
  • Compliance check passed - All controls are in place
  • Documentation complete - Runbooks, release notes, known issues documented
  • Stakeholders notified - Everyone who needs to know has been told
  • Deployment window confirmed - Time slot booked, conflicts avoided

Staging matches production: If staging is smaller or configured differently, staging success doesn't guarantee production success.

Monitoring and alerting: Without monitoring, you're deploying blind. You won't know if something is wrong until users complain.

Log aggregation: When issues happen (and they will), logs are your evidence. If you can't find the logs, you can't debug.

Backup procedures verified: A backup you haven't tested is not a backup - it's a hope. Test restores before you need them.

Rollback procedures tested: Rollbacks are stressful. Don't figure out how to rollback during an emergency. Practice when the stakes are low.

Security scan passed: A deployment that introduces a critical vulnerability is worse than no deployment at all.

Compliance check passed: Regulatory penalties are more expensive than delayed deployments.

Documentation complete: In the heat of an incident, you don't have time to figure things out. Documentation is your calm guide.

Stakeholders notified: Surprises are fun for birthdays, not for deployments. Manage expectations.

Deployment window confirmed: Deploying during peak traffic is asking for trouble. Pick your moment wisely.

What You'll Have

Expected Output:

  • Completed pre-deployment checklist
  • Staging validation report
  • Monitoring configuration validation
  • Backup verification results
  • Rollback test results

Who Approves:

  • DevOps validates deployment readiness
  • SRE validates operational readiness
  • Security Lead validates security readiness
  • QA Lead validates quality readiness

Step 3: Staging Deployment (The Dress Rehearsal)

Time needed: 1 week Led by: DevOps

Deploy to Staging First

Staging is your dress rehearsal. If something goes wrong here, you fix it and try again. If something goes wrong in production, you're in a hurry.

The Staging Process

  1. Deploy the build - Use the same process you'll use in production
  2. Run smoke tests - Quick checks that basic functionality works
  3. Run full regression tests - Comprehensive test suite
  4. Run performance tests - Confirm performance is acceptable
  5. Validate security - Quick security scan
  6. Validate monitoring - Are metrics being collected? Are dashboards working?
  7. Conduct stakeholder demo - Show stakeholders what's being deployed
  8. Fix any issues - Don't carry problems forward to production

A staging failure is a gift - it's a production failure you avoided.

When Staging Fails:

  1. Stop (don't proceed to production)
  2. Diagnose (what's the issue?)
  3. Fix (address the root cause, not just symptoms)
  4. Retest (confirm the fix works)
  5. Redeploy to staging (try again)
  6. Only proceed to production after staging passes

Never, ever skip staging. The time you save isn't worth the risk.

What You'll Have

Expected Output:

  • Staging deployment complete
  • Staging test results (smoke, regression, performance)
  • Staging validation report
  • Issue fixes (if any were found)

Who Approves:

  • DevOps confirms deployment complete
  • QA confirms tests passing
  • SRE confirms staging operations look good
  • Product Owner gives approval to proceed to production

Step 4: Production Deployment (Showtime)

Time needed: Deployment window (varies by strategy) Led by: DevOps Lead

The Big Moment

This is it - your software is going to production. If you've prepared well, this should be boring. Boring is good. Exciting deployments are usually bad deployments.

Before You Deploy

  1. Pre-deployment briefing - Gather the team, review the plan, confirm roles
  2. Final checklist review - One last pass through the checklist
  3. On-call confirmation - Who's watching? Who's responding if something breaks?
  4. Stakeholder notification - "Deployment starting now, expect X minutes of Y"

During Deployment

  1. Execute the deployment - Follow the runbook step by step
  2. Monitor each step - Watch for errors, watch the metrics
  3. Communicate progress - Keep stakeholders updated
  4. Be ready to rollback - If triggers are hit, don't hesitate

After Deployment

  1. Run smoke tests - Confirm basic functionality works
  2. Monitor health metrics - Error rates, response times, throughput
  3. Monitor user feedback - Support channels, social media, error reports
  4. Celebrate (briefly) - You did it! (But stay vigilant)

DevOps Lead:

  • Executes the deployment
  • Monitors deployment logs
  • Makes rollback decisions if needed
  • Coordinates technical response

SRE:

  • Monitors production metrics
  • Watches for anomalies
  • Ready to respond to incidents
  • Documents any issues

Tech Lead:

  • Validates technical correctness
  • Available for technical questions
  • Helps diagnose issues if they arise
  • Approves the deployment from a technical perspective

QA Lead:

  • Runs post-deployment tests
  • Validates quality gates
  • Monitors for quality issues
  • Available to triage bugs

Security Lead:

  • Monitors security telemetry
  • Watches for security anomalies
  • Available to respond to security incidents
  • Validates security controls are in place

Product Owner:

  • Communicates with stakeholders
  • Monitors user feedback
  • Makes business decisions if issues arise
  • Provides go/no-go for proceeding

Pro tip: Have a war room (virtual or physical) where everyone is available during the deployment window. Fast communication saves time when issues arise.

What You'll Have

Expected Output:

  • Production deployment complete
  • Deployment execution log (what happened, when)
  • Smoke test results
  • System health metrics (baseline for comparison)
  • Deployment notification sent

Who Approves:

  • DevOps confirms deployment complete
  • SRE confirms production is healthy
  • Tech Lead validates technical success
  • Product Owner approves the release

Step 5: Post-Deployment Validation (Did It Work?)

Time needed: 1-2 weeks (validation period) Led by: SRE + QA Lead

The Validation Period

Deployment isn't complete when the last bit of code is deployed. It's complete after you've validated that everything is working correctly.

What to Validate

  1. Smoke tests pass - Basic functionality works
  2. Health checks pass - All systems report healthy
  3. Metrics are normal - Error rates, response times, throughput are within expected ranges
  4. Features work - All deployed features function as intended
  5. Integrations work - External connections are functioning
  6. Security controls are active - No new vulnerabilities, encryption working
  7. Compliance controls are in place - Audit logs, access controls, data protection
  8. Users are happy - No surge in complaints, support tickets

Performance Degradation:

  • Slower response times than staging (different data volumes, different load patterns)
  • Database queries that were fast in staging are slow in production
  • Cache misses (cold cache after deployment)

Integration Failures:

  • API keys that work in staging but not production (different credentials)
  • Rate limiting that wasn't hit in staging
  • Third-party services that behave differently in production

Data Issues:

  • Migration scripts that worked on staging data but fail on production data
  • Data corruption during migration
  • Inconsistent data between services

Configuration Issues:

  • Environment variables not set in production
  • Feature flags in wrong state
  • Logging levels too verbose (or not verbose enough)

User Experience Issues:

  • Browser compatibility (staging used Chrome, users use Safari)
  • Mobile devices behave differently
  • Accessibility tools fail

Pro tip: Keep the deployment rollback window open for at least 24-48 hours. If major issues are found, rollback is still an option.

What You'll Have

Expected Output:

  • Post-deployment test results
  • System health report
  • Performance validation report
  • Security validation report
  • User feedback summary
  • Issue log (if any issues found)

Who Approves:

  • SRE confirms operational health
  • QA Lead confirms quality
  • Security Lead confirms security
  • Product Owner confirms user acceptance

Step 6: Rollback Planning (Hope for the Best, Plan for the Rest)

Time needed: Planned during strategy, executed if needed Led by: DevOps + SRE

Why Rollback Planning Matters

A rollback plan is like insurance - you hope you never need it, but you're really glad you have it when you do.

Rollback Triggers

Trigger TypeExampleAction
CriticalSystem down, data corruption, security breachImmediate rollback (within minutes)
HighMajor feature broken, performance severely degradedRollback within 1 hour
MediumMinor issues, workaround availableMonitor, decide within 4 hours
LowCosmetic issues, documentation gapsFix in place (no rollback)

Do This:

  • Document the rollback procedure in detail (step-by-step)
  • Test rollback in staging (confirm it works)
  • Time your rollback (know how long it takes)
  • Communicate during rollback (don't leave stakeholders wondering)
  • Post-rollback analysis (why did we rollback? what do we fix?)

Avoid This:

  • Hesitating (if triggers are hit, rollback quickly)
  • Rolling forward to a "new" fix (untested code in production is worse)
  • Skipping the rollback test (don't test during the emergency)
  • Failing to communicate (silence during incidents breeds distrust)

Rollback Decision Tree:

Issue detected → Is it critical? → YES: Rollback immediately
                 → NO: Can we fix quickly? → YES: Fix in place
                                          → NO: Rollback, fix, redeploy

Remember: Rolling back isn't failure. It's wisdom. Deploying broken software and keeping it in production? That's failure.

What You'll Have

Expected Output:

  • Rollback plan (documented procedure)
  • Rollback test results (from staging)
  • Rollback execution log (if rollback was needed)
  • Post-rollback analysis (if rollback was needed)

Who Approves:

  • DevOps owns the rollback procedure
  • Tech Lead validates technical rollback
  • Security Lead validates security during rollback

Step 7: Release Documentation (Tell Your Story)

Time needed: 1 week Led by: Tech Lead + Product Owner

Document the Release

Your users (current and future) need to know what changed, why it changed, and how it affects them.

What to Document

  • Release notes - User-facing summary of changes
  • New features - What's new and exciting
  • Enhancements - Improvements to existing features
  • Bug fixes - What bugs were squashed
  • Known issues - What isn't perfect (transparency builds trust)
  • Upgrade instructions - How users should upgrade (if applicable)
  • Configuration changes - Any new settings or defaults
  • API changes - Breaking changes, new endpoints, deprecations
  • Migration guides - How to move from old versions to new

Do This:

  • Write for your users (not for developers)
  • Focus on benefits, not features (users care about what they can do, not how you built it)
  • Use plain language (avoid jargon, explain technical terms)
  • Include visuals (screenshots, gifs, videos)
  • Organize by category (features, fixes, known issues)
  • Link to documentation (for detailed information)

Example:

## Release 2.5.0 - January 20, 2026

### What's New
- **Dark Mode** - Easier on the eyes, easier on the battery
- **Faster Search** - Results appear as you type
- **Mobile Improvements** - Better experience on phones and tablets

### Bug Fixes
- Fixed login issue on Safari browsers
- Fixed crash when uploading large files
- Fixed notification delivery delays

### Known Issues
- Dark mode not available on older browsers (Chrome <90)
- Search may be slow for very large accounts (working on it)

### Upgrade Instructions
No action required - the update will be applied automatically.

### Need Help?
Contact support@example.com or view our documentation at docs.example.com

Avoid This:

  • Technical jargon that users don't understand
  • Lists of internal changes that don't affect users
  • Missing known issues (transparency is better)
  • Walls of text (format for readability)

Pro tip: Your release notes are often the first thing users see after an update. Make them helpful, not confusing.

What You'll Have

Expected Output:

  • Release notes (user-facing)
  • Feature documentation (detailed technical docs)
  • Upgrade guide (how to upgrade, if applicable)
  • Configuration guide (new settings, changed defaults)
  • API documentation (if APIs changed)
  • Known issues document (transparent disclosure)

Who Approves:

  • Tech Lead validates technical documentation
  • Product Owner validates user-facing documentation
  • QA Lead confirms test coverage is documented

Step 8: Release Closure (Celebrate and Learn)

Time needed: 1 week Led by: Project Manager

Close the Release

You've deployed, validated, and documented. Now it's time to close the chapter and prepare for ongoing operations.

Closure Activities

  1. Post-release review - What went well? What didn't?
  2. Lessons learned - What would you do differently next time?
  3. Metrics update - How did reality compare to plans?
  4. Financial closeout - Track actual costs vs. budget
  5. Stakeholder sign-off - Formal acceptance of the release
  6. Archive artifacts - Store documentation, reports, records
  7. Celebrate - Recognize the team's hard work

Technical:

  • Did the deployment go as planned?
  • Were there any surprises?
  • How long did it take vs. estimated?
  • Did we rollback? Why?
  • What metrics improved or degraded?

Process:

  • Was the pre-deployment checklist effective?
  • Did monitoring catch issues?
  • Was communication effective?
  • Did everyone know their roles?
  • What would make the next deployment smoother?

People:

  • Was the team prepared?
  • Was there enough training?
  • Was stress managed effectively?
  • Did the team feel supported?
  • What would improve team experience?

Business:

  • Are users happy with the release?
  • Did we meet business objectives?
  • Was the release timely?
  • Was it worth the investment?
  • What's the ROI so far?

Pro tip: Hold the review while memories are fresh (within a week of deployment), but after the validation period is complete (after you know if there are major issues).

What You'll Have

Expected Output:

  • Post-release review document
  • Lessons learned report
  • Project closure report
  • Stakeholder sign-off
  • Project archive (all artifacts stored)

Who Approves:

  • Project Manager closes the release
  • Product Owner accepts the release
  • Executive Sponsor approves closure

Quality Gates: Is the Release Complete?

Before declaring the release complete, confirm:

  • Staging deployment successful - Dress rehearsal went well
  • Production deployment successful - Software is live
  • Post-deployment validation passing - Everything works as expected
  • Monitoring and alerting active - You can see what's happening
  • Release documentation published - Users know what changed
  • Stakeholders notified - Everyone who needs to know has been told
  • Rollback plan tested - You can undo if needed (even if you didn't need to)
  • Release closure completed - Chapter closed, lessons learned

If anything is missing: Complete it before considering the release done. Incomplete releases have a way of becoming problems later.


Deployment Metrics: Track Your Success

MetricWhat It Tells YouTargetActual
Deployment TimeHow long deployments take<30 minutesTBD
Rollback TimeHow fast you can undo<15 minutesTBD
Error RatePercentage of failed requests<0.1%TBD
Response Time (p95)95th percentile response time<200msTBD
AvailabilityUptime percentage>99.9%TBD
Critical IncidentsProduction incidents post-deployment0TBD

Remember: Metrics are for learning, not blame. Use them to improve future deployments.


Communication Plan: Keep Everyone Informed

StageWho to NotifyWhenWhat to Say
Deployment ScheduledAll stakeholders2 weeks before"We're deploying X on Y date. Expect Z."
Staging CompleteAll stakeholders1 week before"Staging successful. Production deployment on track for Y."
Production ImminentAll stakeholders24 hours before"Deployment happening tomorrow at Y. Brief downtime expected."
Production CompleteAll stakeholdersImmediately after"Deployment complete. System is live. Monitoring in progress."
Validation CompleteAll stakeholders1-2 weeks after"Validation period complete. No major issues. Release successful."
Release ClosedAll stakeholdersAfter closure"Release closed. Lessons learned documented. Next release planned for Y."

Pro tip: Over-communication is better than under-communication. When in doubt, tell people.


Words of Encouragement

Deployment day can feel stressful. There's a lot at stake, and everyone is watching. But remember:

You've prepared for this.

  • Phases 1-6 were all preparation for this moment
  • Your testing has caught the obvious issues
  • Your staging deployment gave you a dress rehearsal
  • Your rollback plan is your safety net

You're not alone.

  • Your team is with you
  • Your monitoring is watching
  • Your runbooks are guiding
  • Your stakeholders are supporting

You'll learn from this.

  • Every deployment teaches you something
  • Every issue makes you better
  • Every success builds confidence

Deploy with confidence, not with fingers crossed.


What's Next

With the release closed, you'll move to Phase 8: Operations & Maintenance. There, you'll focus on keeping everything running smoothly, monitoring for issues, and continuously improving.

Think of Phase 7 as the birth, and Phase 8 as the parenting. The hard work of bringing something into the world is done, but the ongoing care is just beginning.

Next up: Operations, monitoring, incidents, and continuous improvement.


Previous Phase: Phase 6: Quality & Security Validation Next Phase: Phase 8: Operations & Maintenance



Version 1.0.0 | OCTALUME Enterprise Lifecycle Framework

Score

Total Score

75/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

+10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon