Agent skill

deployment-checker

Pre-deployment validation checklist and automated readiness assessment.

Stars 232
Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/aiskillstore/marketplace/tree/main/skills/curiouslearner/deployment-checker

SKILL.md

Deployment Checker Skill

Pre-deployment validation checklist and automated readiness assessment.

Instructions

You are a deployment readiness expert. When invoked:

  1. Pre-Deployment Validation:

    • Code quality checks passed
    • All tests passing
    • Build successful
    • Dependencies updated and secure
    • Environment variables configured
    • Database migrations ready
  2. Security Checks:

    • No secrets in code
    • Security headers configured
    • Authentication/authorization tested
    • Input validation implemented
    • HTTPS enabled
    • Rate limiting configured
  3. Performance Validation:

    • Load testing completed
    • Resource limits configured
    • Caching strategies implemented
    • Database indexes optimized
    • CDN configured (if applicable)
  4. Infrastructure Checks:

    • Health checks configured
    • Monitoring and alerting set up
    • Logging configured
    • Backup strategy in place
    • Rollback plan documented
    • DNS and SSL configured
  5. Generate Checklist: Create deployment-ready report with go/no-go decision

Deployment Checklist

Pre-Deployment (Before Release)

Code Quality

  • All tests passing (unit, integration, e2e)
  • Code review completed and approved
  • Linting passed (no warnings)
  • Code coverage meets threshold (>80%)
  • No known critical bugs
  • Breaking changes documented
  • API contracts validated

Build & Dependencies

  • Build successful in CI/CD
  • Dependencies updated
  • Security vulnerabilities resolved
  • Bundle size within acceptable limits
  • Source maps generated (if applicable)
  • Docker images built and pushed

Database

  • Migrations tested in staging
  • Migration rollback plan ready
  • Backup created before migration
  • Database indexes optimized
  • Data validation scripts run
  • Connection pool configured

Environment Configuration

  • Environment variables documented
  • Secrets stored securely (not in code)
  • Feature flags configured
  • CORS settings verified
  • API keys rotated (if needed)
  • Third-party services configured

Security

  • Authentication tested
  • Authorization rules verified
  • Input validation implemented
  • SQL injection prevention verified
  • XSS prevention implemented
  • CSRF tokens configured
  • Security headers set
  • Rate limiting enabled
  • HTTPS enforced
  • Secrets manager configured

Performance

  • Load testing completed
  • Performance benchmarks met
  • Database query optimization done
  • Caching strategy implemented
  • CDN configured (if applicable)
  • Resource limits set
  • Auto-scaling configured

Deployment (During Release)

Infrastructure

  • Health check endpoints working
  • Monitoring dashboards ready
  • Alerting configured
  • Logging centralized
  • Error tracking enabled (Sentry, etc.)
  • Backup strategy verified
  • SSL certificates valid
  • DNS records updated
  • Load balancer configured

Deployment Strategy

  • Deployment method chosen (blue-green, canary, rolling)
  • Rollback plan documented
  • Database migration strategy defined
  • Downtime window communicated (if any)
  • Deployment runbook prepared
  • Staging deployment successful

Communication

  • Stakeholders notified
  • Change log prepared
  • Documentation updated
  • Support team briefed
  • Maintenance window scheduled (if needed)
  • Status page updated

Post-Deployment (After Release)

Validation

  • Smoke tests passed
  • Health checks green
  • Error rates normal
  • Response times acceptable
  • Database migrations completed
  • Feature flags validated

Monitoring

  • Application logs reviewed
  • Error tracking checked
  • Performance metrics reviewed
  • User feedback monitored
  • Resource usage normal
  • Alerts configured and tested

Documentation

  • Release notes published
  • API documentation updated
  • Known issues documented
  • Rollback procedure tested
  • Incident response plan ready

Usage Examples

@deployment-checker
@deployment-checker --environment production
@deployment-checker --checklist
@deployment-checker --automated
@deployment-checker --report

Automated Checks Script

Node.js Example

javascript
// deployment-check.js
const chalk = require('chalk');

class DeploymentChecker {
  constructor() {
    this.checks = [];
    this.passed = 0;
    this.failed = 0;
  }

  async runChecks() {
    console.log(chalk.bold('\nšŸš€ Deployment Readiness Check\n'));

    await this.checkTests();
    await this.checkBuild();
    await this.checkDependencies();
    await this.checkEnvironment();
    await this.checkSecurity();
    await this.checkDatabase();

    this.printSummary();
    return this.failed === 0;
  }

  async checkTests() {
    console.log(chalk.blue('šŸ“‹ Running Tests...'));
    try {
      await this.exec('npm test');
      this.pass('All tests passing');
    } catch (error) {
      this.fail('Tests failed', error.message);
    }
  }

  async checkBuild() {
    console.log(chalk.blue('\nšŸ”Ø Building Application...'));
    try {
      await this.exec('npm run build');
      this.pass('Build successful');
    } catch (error) {
      this.fail('Build failed', error.message);
    }
  }

  async checkDependencies() {
    console.log(chalk.blue('\nšŸ“¦ Checking Dependencies...'));
    try {
      const result = await this.exec('npm audit --audit-level=high');
      if (result.includes('0 vulnerabilities')) {
        this.pass('No high/critical vulnerabilities');
      } else {
        this.fail('Security vulnerabilities found');
      }
    } catch (error) {
      this.fail('Dependency check failed', error.message);
    }
  }

  async checkEnvironment() {
    console.log(chalk.blue('\nšŸŒ Checking Environment...'));

    const required = [
      'DATABASE_URL',
      'JWT_SECRET',
      'API_KEY',
      'REDIS_URL'
    ];

    for (const envVar of required) {
      if (process.env[envVar]) {
        this.pass(`${envVar} is set`);
      } else {
        this.fail(`${envVar} is missing`);
      }
    }
  }

  async checkSecurity() {
    console.log(chalk.blue('\nšŸ”’ Security Checks...'));

    // Check for secrets in code
    try {
      const result = await this.exec('git secrets --scan');
      this.pass('No secrets found in code');
    } catch (error) {
      this.fail('Secrets detected in code');
    }

    // Check HTTPS
    if (process.env.FORCE_HTTPS === 'true') {
      this.pass('HTTPS enforced');
    } else {
      this.fail('HTTPS not enforced');
    }
  }

  async checkDatabase() {
    console.log(chalk.blue('\nšŸ’¾ Database Checks...'));

    // Check migrations are up to date
    try {
      await this.exec('npm run db:check-migrations');
      this.pass('Database migrations ready');
    } catch (error) {
      this.fail('Database migration issues');
    }
  }

  pass(message) {
    console.log(chalk.green(`  āœ“ ${message}`));
    this.passed++;
  }

  fail(message, details = '') {
    console.log(chalk.red(`  āœ— ${message}`));
    if (details) {
      console.log(chalk.gray(`    ${details}`));
    }
    this.failed++;
  }

  printSummary() {
    console.log(chalk.bold('\nšŸ“Š Summary\n'));
    console.log(chalk.green(`  Passed: ${this.passed}`));
    console.log(chalk.red(`  Failed: ${this.failed}`));

    if (this.failed === 0) {
      console.log(chalk.green.bold('\nāœ… READY FOR DEPLOYMENT\n'));
    } else {
      console.log(chalk.red.bold('\nāŒ NOT READY FOR DEPLOYMENT\n'));
      process.exit(1);
    }
  }

  async exec(command) {
    const { execSync } = require('child_process');
    return execSync(command, { encoding: 'utf8' });
  }
}

// Run checks
const checker = new DeploymentChecker();
checker.runChecks();

Deployment Report Template

markdown
# Deployment Readiness Report

**Environment**: Production
**Date**: 2024-01-15
**Version**: v2.3.0
**Release Manager**: @username

---

## Overall Status

🟢 **READY FOR DEPLOYMENT**

**Score**: 95/100
- āœ… Critical checks: 10/10
- āœ… High priority: 18/20
- āš ļø  Medium priority: 28/30
- āœ… Low priority: 39/40

---

## Critical Checks (10/10) āœ…

- āœ… All tests passing (1,234 tests, 0 failures)
- āœ… Build successful
- āœ… No critical vulnerabilities
- āœ… Database migrations tested
- āœ… Environment variables configured
- āœ… HTTPS enabled
- āœ… Health checks working
- āœ… Rollback plan documented
- āœ… Monitoring configured
- āœ… Staging deployment successful

---

## High Priority (18/20) āœ…

- āœ… Code review approved
- āœ… Security scan passed
- āœ… Performance benchmarks met
- āœ… Load testing completed
- āœ… Error tracking enabled
- āœ… Rate limiting configured
- āœ… Backup strategy verified
- āœ… SSL certificates valid
- āš ļø  API documentation needs update (2 endpoints)
- āš ļø  Cache warming script not tested

---

## Medium Priority (28/30) āš ļø

- āœ… Linting passed
- āœ… Code coverage: 87% (target: 80%)
- āœ… Bundle size: 245KB (within limit)
- āš ļø  Minor performance issue in search endpoint
- āš ļø  1 TODO comment in critical path

---

## Test Results

**Unit Tests**: āœ… 856 passed, 0 failed
**Integration Tests**: āœ… 234 passed, 0 failed
**E2E Tests**: āœ… 144 passed, 0 failed
**Total**: 1,234 tests in 2m 34s

**Coverage**:
- Statements: 87.4%
- Branches: 82.1%
- Functions: 89.3%
- Lines: 86.8%

---

## Security Scan Results

**Dependencies**: āœ… No critical/high vulnerabilities
**Secrets Scan**: āœ… No secrets detected
**HTTPS**: āœ… Enforced
**Security Headers**: āœ… Configured
- X-Frame-Options: DENY
- X-Content-Type-Options: nosniff
- Strict-Transport-Security: max-age=31536000

**Authentication**: āœ… Tested
**Rate Limiting**: āœ… 100 req/15min per IP

---

## Performance Metrics

**Load Test Results** (10,000 concurrent users):
- Average Response Time: 234ms āœ… (target: <500ms)
- P95 Response Time: 456ms āœ… (target: <1s)
- P99 Response Time: 789ms āœ… (target: <2s)
- Error Rate: 0.02% āœ… (target: <0.1%)
- Throughput: 12,345 req/s āœ…

**Database**:
- Query Response Time: <50ms āœ…
- Connection Pool: Configured (min: 5, max: 50) āœ…
- Indexes: Optimized āœ…

---

## Infrastructure Status

**Health Checks**: āœ… All passing
- /health: 200 OK (5ms)
- /ready: 200 OK (8ms)
- Database: Connected
- Redis: Connected
- External APIs: Reachable

**Monitoring**: āœ… Configured
- Application metrics: Datadog
- Error tracking: Sentry
- Logging: CloudWatch
- Uptime monitoring: Pingdom

**Alerts Configured**:
- Error rate > 1%
- Response time P95 > 1s
- CPU > 80%
- Memory > 85%
- Database connections > 45

---

## Database Migrations

**Status**: āœ… Ready

Migrations to apply:
1. `20240115_add_user_preferences` - Tested āœ…
2. `20240115_create_notifications_table` - Tested āœ…

**Rollback Plan**: āœ… Documented
**Backup**: āœ… Created (15GB, 2024-01-15 10:00 UTC)

---

## Deployment Plan

**Strategy**: Blue-Green Deployment
**Estimated Duration**: 15 minutes
**Downtime**: None
**Rollback Time**: 2 minutes

**Steps**:
1. Deploy to green environment
2. Run smoke tests
3. Switch 10% traffic to green
4. Monitor for 10 minutes
5. Switch 50% traffic to green
6. Monitor for 10 minutes
7. Switch 100% traffic to green
8. Keep blue environment for 24h (quick rollback)

---

## Action Items Before Deployment

### Must Fix (Blockers)
- None āœ…

### Should Fix (Recommended)
- āš ļø  Update API documentation for new endpoints
- āš ļø  Test cache warming script

### Nice to Have
- Consider adding more E2E tests for edge cases
- Update changelog with latest changes

---

## Risk Assessment

**Overall Risk**: 🟢 Low

**Identified Risks**:
1. **Database Migration** (Low Risk)
   - Mitigation: Tested in staging, rollback plan ready

2. **Traffic Spike** (Low Risk)
   - Mitigation: Load tested, auto-scaling configured

3. **Third-Party API** (Medium Risk)
   - Mitigation: Circuit breaker implemented, fallback configured

---

## Rollback Plan

**Trigger Conditions**:
- Error rate > 5%
- Response time P95 > 2s
- Critical functionality broken

**Rollback Steps**:
1. Switch traffic back to blue environment (30 seconds)
2. Investigate issue
3. Fix and redeploy

**Data Rollback**:
- Database backup available (15 minutes to restore)
- Migration rollback scripts tested

---

## Communication Plan

**Notifications Sent**:
- āœ… Engineering team
- āœ… Product team
- āœ… Support team
- āœ… Stakeholders

**Status Page**: Updated
**Changelog**: Ready to publish
**Documentation**: Updated

---

## Sign-Off

**Technical Lead**: āœ… Approved - @tech-lead
**QA**: āœ… Approved - @qa-lead
**DevOps**: āœ… Approved - @devops-lead
**Product**: āœ… Approved - @product-manager

---

## Final Recommendation

🟢 **APPROVED FOR DEPLOYMENT**

All critical checks passed. Minor issues identified do not block deployment.
Recommend proceeding with deployment as scheduled.

**Scheduled Deployment**: 2024-01-15 14:00 UTC
**Deployment Window**: 14:00 - 14:30 UTC

Best Practices

Blue-Green Deployment

  • Zero downtime
  • Instant rollback
  • Full testing before switch
  • Keep old environment for quick revert

Canary Deployment

  • Gradual rollout (1% → 10% → 50% → 100%)
  • Monitor metrics at each stage
  • Automatic rollback on errors
  • Low risk

Rolling Deployment

  • Update instances one by one
  • No downtime
  • Automatic health checks
  • Slower than blue-green

Database Migrations

  • Always test in staging first
  • Create rollback scripts
  • Backup before migration
  • Avoid breaking changes when possible
  • Use feature flags for schema changes

Notes

  • Never deploy on Fridays (unless critical)
  • Always have a rollback plan
  • Monitor closely for first hour after deployment
  • Document everything
  • Automate as much as possible
  • Test in production-like environment
  • Use feature flags for gradual rollout
  • Keep deployments small and frequent
  • Have team available during deployment
  • Celebrate successful deployments!

Expand your agent's capabilities with these related and highly-rated skills.

aiskillstore/marketplace

perigon-backend

Perigon ASP.NET Core + EF Core + Aspire conventions

232 15
Explore
aiskillstore/marketplace

perigon-agent

Pointers for Copilot/agents to apply Perigon conventions

232 15
Explore
aiskillstore/marketplace

perigon-angular

Angular 21+ standalone/Material/signal conventions for Perigon WebApp

232 15
Explore
aiskillstore/marketplace

fastapi-mastery

Comprehensive FastAPI development skill covering REST API creation, routing, request/response handling, validation, authentication, database integration, middleware, and deployment. Use when working with FastAPI projects, building APIs, implementing CRUD operations, setting up authentication/authorization, integrating databases (SQL/NoSQL), adding middleware, handling WebSockets, or deploying FastAPI applications. Triggered by requests involving .py files with FastAPI code, API endpoint creation, Pydantic models, or FastAPI-specific features.

232 15
Explore
aiskillstore/marketplace

context7-efficient

Token-efficient library documentation fetcher using Context7 MCP with 86.8% token savings through intelligent shell pipeline filtering. Fetches code examples, API references, and best practices for JavaScript, Python, Go, Rust, and other libraries. Use when users ask about library documentation, need code examples, want API usage patterns, are learning a new framework, need syntax reference, or troubleshooting with library-specific information. Triggers include questions like "Show me React hooks", "How do I use Prisma", "What's the Next.js routing syntax", or any request for library/framework documentation.

232 15
Explore
aiskillstore/marketplace

browser-use

Browser automation using Playwright MCP. Navigate websites, fill forms, click elements, take screenshots, and extract data. Use when tasks require web browsing, form submission, web scraping, UI testing, or any browser interaction.

232 15
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results