
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).
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?
| Role | What They're Responsible For |
|---|---|
| DevOps Lead | Your deployment choreographer - making sure the dance goes smoothly |
| SRE | Your production guardian - watching for issues and ready to respond |
| Tech Lead | Technical validation - is what we deployed what we thought we deployed? |
| QA Lead | Final quality checks before and after deployment |
| Security Lead | Security validation - is production as secure as staging? |
| Product Owner | Release 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
- Deploy the build - Use the same process you'll use in production
- Run smoke tests - Quick checks that basic functionality works
- Run full regression tests - Comprehensive test suite
- Run performance tests - Confirm performance is acceptable
- Validate security - Quick security scan
- Validate monitoring - Are metrics being collected? Are dashboards working?
- Conduct stakeholder demo - Show stakeholders what's being deployed
- 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:
- Stop (don't proceed to production)
- Diagnose (what's the issue?)
- Fix (address the root cause, not just symptoms)
- Retest (confirm the fix works)
- Redeploy to staging (try again)
- 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
- Pre-deployment briefing - Gather the team, review the plan, confirm roles
- Final checklist review - One last pass through the checklist
- On-call confirmation - Who's watching? Who's responding if something breaks?
- Stakeholder notification - "Deployment starting now, expect X minutes of Y"
During Deployment
- Execute the deployment - Follow the runbook step by step
- Monitor each step - Watch for errors, watch the metrics
- Communicate progress - Keep stakeholders updated
- Be ready to rollback - If triggers are hit, don't hesitate
After Deployment
- Run smoke tests - Confirm basic functionality works
- Monitor health metrics - Error rates, response times, throughput
- Monitor user feedback - Support channels, social media, error reports
- 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
- Smoke tests pass - Basic functionality works
- Health checks pass - All systems report healthy
- Metrics are normal - Error rates, response times, throughput are within expected ranges
- Features work - All deployed features function as intended
- Integrations work - External connections are functioning
- Security controls are active - No new vulnerabilities, encryption working
- Compliance controls are in place - Audit logs, access controls, data protection
- 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 Type | Example | Action |
|---|---|---|
| Critical | System down, data corruption, security breach | Immediate rollback (within minutes) |
| High | Major feature broken, performance severely degraded | Rollback within 1 hour |
| Medium | Minor issues, workaround available | Monitor, decide within 4 hours |
| Low | Cosmetic issues, documentation gaps | Fix 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
- Post-release review - What went well? What didn't?
- Lessons learned - What would you do differently next time?
- Metrics update - How did reality compare to plans?
- Financial closeout - Track actual costs vs. budget
- Stakeholder sign-off - Formal acceptance of the release
- Archive artifacts - Store documentation, reports, records
- 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
| Metric | What It Tells You | Target | Actual |
|---|---|---|---|
| Deployment Time | How long deployments take | <30 minutes | TBD |
| Rollback Time | How fast you can undo | <15 minutes | TBD |
| Error Rate | Percentage of failed requests | <0.1% | TBD |
| Response Time (p95) | 95th percentile response time | <200ms | TBD |
| Availability | Uptime percentage | >99.9% | TBD |
| Critical Incidents | Production incidents post-deployment | 0 | TBD |
Remember: Metrics are for learning, not blame. Use them to improve future deployments.
Communication Plan: Keep Everyone Informed
| Stage | Who to Notify | When | What to Say |
|---|---|---|---|
| Deployment Scheduled | All stakeholders | 2 weeks before | "We're deploying X on Y date. Expect Z." |
| Staging Complete | All stakeholders | 1 week before | "Staging successful. Production deployment on track for Y." |
| Production Imminent | All stakeholders | 24 hours before | "Deployment happening tomorrow at Y. Brief downtime expected." |
| Production Complete | All stakeholders | Immediately after | "Deployment complete. System is live. Monitoring in progress." |
| Validation Complete | All stakeholders | 1-2 weeks after | "Validation period complete. No major issues. Release successful." |
| Release Closed | All stakeholders | After 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
Based on repository quality metrics
SKILL.mdファイルが含まれている
ライセンスが設定されている
100文字以上の説明がある
GitHub Stars 100以上
1ヶ月以内に更新
10回以上フォークされている
オープンIssueが50未満
プログラミング言語が設定されている
1つ以上のタグが設定されている
Reviews
Reviews coming soon
