Agent skill

production-readiness-skill

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/production-readiness-skill

SKILL.md

Production Readiness Skill

Overview

Expertise in preparing AI-augmented teams and solutions for enterprise production deployment, including scalability, reliability, monitoring, and operational excellence requirements.

Core Production Requirements

Scalability Framework

Team Scaling Considerations:

  • Horizontal Scaling: Adding more AI-augmented team members
  • Vertical Scaling: Increasing AI tool capabilities and usage
  • Geographic Scaling: Distributed teams and time zone considerations
  • Workload Scaling: Handling peak demand and variable capacity needs

Technology Scaling Requirements:

  • API Rate Limits: Managing token usage and cost scaling
  • Infrastructure Capacity: Compute, storage, and network requirements
  • Integration Scaling: API gateway and service mesh considerations
  • Data Volume: Handling increased data processing requirements

Reliability Standards

Service Level Agreements (SLAs)

markdown
## AI Tool SLA Framework

### Availability Requirements
- **Core AI Tools**: 99.9% uptime (8.77 hours downtime/year)
- **Development Tools**: 99.5% uptime (43.8 hours downtime/year)
- **Support Systems**: 99.0% uptime (87.6 hours downtime/year)

### Performance Standards
- **Response Time**: <2 seconds for code completion
- **Batch Processing**: <5 minutes for documentation generation
- **API Calls**: <500ms for individual requests
- **Concurrent Users**: Support 100+ simultaneous developers

### Support Requirements
- **Response Time**: 4 hours for critical issues
- **Resolution Time**: 24 hours for high-priority items
- **Escalation Path**: Clear vendor and internal escalation procedures
- **Communication**: Status page and proactive notifications

Backup and Recovery

markdown
## Business Continuity Plan

### Data Backup Strategy
- **Code Repositories**: Real-time replication with 30-day retention
- **AI Model Outputs**: Daily backups with 7-day retention
- **Configuration Data**: Version-controlled with Git history
- **Documentation**: Automated daily snapshots

### Recovery Procedures
- **RTO (Recovery Time Objective)**: 4 hours for critical systems
- **RPO (Recovery Point Objective)**: 1 hour maximum data loss
- **Failover Process**: Documented procedures with regular testing
- **Communication Plan**: Stakeholder notification procedures

Monitoring and Observability

Performance Monitoring

markdown
## AI System Monitoring Framework

### Key Metrics to Track
| Metric Category | Specific Metrics | Alert Thresholds | Dashboard |
|-----------------|------------------|------------------|-----------|
| **Performance** | Response time, throughput, error rates | >2s response, >5% errors | Real-time |
| **Usage** | Daily active users, API calls, token consumption | >80% quota usage | Daily |
| **Quality** | Code acceptance rate, bug detection accuracy | <70% acceptance | Weekly |
| **Cost** | Cost per transaction, budget utilization | >90% budget | Monthly |
| **Security** | Failed logins, unusual access patterns | >10 failed attempts | Immediate |

### Monitoring Tools Stack
- **Application Performance**: New Relic, DataDog, or AppDynamics
- **Infrastructure Monitoring**: Prometheus + Grafana
- **Log Aggregation**: ELK Stack (Elasticsearch, Logstash, Kibana)
- **Error Tracking**: Sentry or Rollbar
- **Cost Monitoring**: Cloud vendor native tools + custom dashboards

Production Deployment Checklist

Pre-Production Validation

markdown
## Production Readiness Checklist

### Technical Validation ✅
- [ ] All AI tools tested in staging environment
- [ ] Performance benchmarks meet SLA requirements
- [ ] Security scan completed with no critical vulnerabilities
- [ ] Load testing completed for expected concurrent users
- [ ] Integration testing with all enterprise systems
- [ ] Disaster recovery procedures tested and documented
- [ ] Monitoring and alerting configured and tested

### Operational Readiness ✅
- [ ] Support team trained on AI tool troubleshooting
- [ ] Incident response procedures documented
- [ ] Escalation paths defined and communicated
- [ ] Vendor support contracts in place
- [ ] Internal knowledge base created
- [ ] Change management process established
- [ ] Regular maintenance schedule defined

### Business Readiness ✅
- [ ] Executive sign-off obtained
- [ ] Budget approval for ongoing operational costs
- [ ] Legal and compliance review completed
- [ ] Risk assessment approved by stakeholders
- [ ] Training program completed for all users
- [ ] Communication plan executed
- [ ] Success metrics and KPIs defined

### Security and Compliance ✅
- [ ] Security audit completed
- [ ] Compliance requirements verified
- [ ] Data protection measures implemented
- [ ] Access controls configured
- [ ] Audit logging enabled
- [ ] Incident response team trained
- [ ] Business continuity plan tested

Enterprise Integration Patterns

Identity and Access Management

markdown
## IAM Integration Strategy

### Authentication Standards
- **Single Sign-On (SSO)**: SAML 2.0 or OIDC integration
- **Multi-Factor Authentication**: Required for all AI tool access
- **Role-Based Access Control**: Map to existing enterprise roles
- **Directory Integration**: Active Directory or LDAP synchronization

### Authorization Framework
```json
{
  "roles": {
    "ai_developer": {
      "tools": ["github_copilot", "code_review_ai"],
      "permissions": ["read", "write", "execute"],
      "limits": { "daily_tokens": 100000 }
    },
    "ai_team_lead": {
      "tools": ["all_developer_tools", "analytics_dashboard"],
      "permissions": ["read", "write", "execute", "admin"],
      "limits": { "daily_tokens": 500000 }
    },
    "ai_admin": {
      "tools": ["all_tools"],
      "permissions": ["all"],
      "limits": { "unlimited": true }
    }
  }
}

Network and Security Architecture

markdown
## Network Security Requirements

### Connectivity Patterns
- **API Gateway**: Centralized entry point for all AI services
- **VPN/Private Link**: Secure connectivity to cloud AI services
- **Proxy Configuration**: Corporate proxy compatibility
- **Firewall Rules**: Specific ports and protocols for AI tools

### Data Flow Security
- **Encryption In-Transit**: TLS 1.3 minimum for all communications
- **Encryption At-Rest**: AES-256 for stored data and model outputs
- **Secrets Management**: Integration with enterprise vault solutions
- **Certificate Management**: PKI integration for SSL certificates

Operational Excellence Framework

Change Management Process

markdown
## Production Change Management

### Change Types
1. **Standard Changes**: Pre-approved, low-risk updates
2. **Normal Changes**: Require CAB approval and scheduling
3. **Emergency Changes**: Critical fixes with expedited approval

### Change Approval Process

Change Request → Technical Review → Risk Assessment → CAB Approval → Implementation → Validation → Documentation


### Change Scheduling
- **Maintenance Windows**: Weekly 4-hour windows (Saturdays 2-6 AM)
- **Deployment Slots**: Pre-scheduled monthly deployment windows
- **Rollback Windows**: 2-hour rollback capability for all changes
- **Communication**: 72-hour advance notice for major changes

Incident Management

markdown
## Incident Response Framework

### Severity Classification
| Severity | Impact | Response Time | Resolution Time |
|----------|--------|---------------|-----------------|
| **Sev 1** | Complete outage | 15 minutes | 4 hours |
| **Sev 2** | Major functionality degraded | 30 minutes | 8 hours |
| **Sev 3** | Minor functionality impacted | 2 hours | 24 hours |
| **Sev 4** | Low impact issues | 4 hours | 72 hours |

### Escalation Matrix
- **L1**: Internal support team (0-30 minutes)
- **L2**: AI tool vendor support (30-120 minutes)
- **L3**: Internal engineering team (2-8 hours)
- **L4**: Vendor engineering team (8+ hours)

Scalability Planning

Capacity Planning Models

markdown
## Scalability Projections

### User Growth Model
- **Year 1**: 50-100 developers (pilot to full deployment)
- **Year 2**: 100-300 developers (enterprise rollout)
- **Year 3**: 300-1000 developers (full organization)

### Infrastructure Scaling
- **Compute**: Auto-scaling groups with 2x headroom
- **Storage**: 30% annual growth projection
- **Network**: 10x current capacity for peak usage
- **API Limits**: Negotiated enterprise rates with vendors

### Cost Scaling Model
- **Fixed Costs**: Infrastructure and base licensing
- **Variable Costs**: Per-user licensing and usage-based pricing
- **Economies of Scale**: Volume discounts at 500+ users
- **Optimization**: Regular cost optimization reviews

Best Practices

Production Deployment Do's and Don'ts

✅ Do:

  • Implement comprehensive monitoring before go-live
  • Conduct thorough load testing with realistic scenarios
  • Create detailed rollback procedures for all changes
  • Establish clear communication channels and escalation paths
  • Document all configurations and maintain version control
  • Regular disaster recovery testing
  • Implement gradual rollout with canary deployments

❌ Don't:

  • Skip security testing or compliance validation
  • Deploy without proper backup and recovery procedures
  • Ignore performance monitoring and alerting
  • Make changes without proper change management approval
  • Deploy during critical business periods
  • Skip user training and change management
  • Forget to update documentation after changes

Performance Optimization

markdown
## Production Performance Guidelines

### Resource Optimization
- **Right-sizing**: Regular review of resource utilization
- **Caching Strategy**: Implement multi-level caching for frequently accessed data
- **Connection Pooling**: Optimize database and API connections
- **Content Delivery**: Use CDN for static content and global distribution

### Cost Optimization
- **Reserved Instances**: Pre-pay for predictable workloads
- **Spot Instances**: Use for non-critical batch processing
- **Auto-scaling**: Scale based on actual demand patterns
- **Resource Scheduling**: Shutdown non-production resources during off-hours

Tools & Skills Integration

  • #risk-assessment: For production risk analysis
  • #financial-modeling: For cost optimization and ROI analysis
  • #technical-writing: For clear operational documentation
  • #document-structure: For organized operational frameworks
  • #change-management: For production adoption strategies

Quality Assurance

  • All production deployments must pass security audit
  • Performance benchmarks must meet or exceed SLA requirements
  • Disaster recovery procedures must be tested quarterly
  • Monitoring and alerting must be validated with synthetic tests
  • Documentation must be updated before production deployment
  • Change management approval required for all production changes

This production readiness skill ensures AI-augmented teams can confidently deploy and operate at enterprise scale while maintaining security, reliability, and performance standards.

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

Didn't find tool you were looking for?

Be as detailed as possible for better results