retellai-prod-checklist
Execute Retell AI production deployment checklist and rollback procedures.Use when deploying Retell AI integrations to production, preparing for launch,or implementing go-live procedures.Trigger with phrases like "retellai production", "deploy retellai","retellai go-live", "retellai launch checklist".
When & Why to Use This Skill
This Claude skill streamlines the production deployment of Retell AI integrations by providing a comprehensive checklist and automated rollback procedures. It ensures high reliability through pre-deployment configuration, code quality verification, and gradual canary rollouts using Kubernetes, helping developers minimize downtime and manage go-live risks effectively.
Use Cases
- Executing a controlled canary rollout for Retell AI services to monitor traffic and error rates before full production deployment.
- Performing pre-flight health checks and connectivity tests to ensure production API keys and webhook endpoints are correctly configured.
- Rapidly initiating rollback procedures using kubectl to restore service stability during deployment failures or high-latency incidents.
- Standardizing the go-live process with a comprehensive checklist that includes security audits, logging verification, and incident runbook preparation.
| name | retellai-prod-checklist |
|---|---|
| description | | |
| allowed-tools | Read, Bash(kubectl:*), Bash(curl:*), Grep |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
Retell AI Production Checklist
Overview
Complete checklist for deploying Retell AI integrations to production.
Prerequisites
- Staging environment tested and verified
- Production API keys available
- Deployment pipeline configured
- Monitoring and alerting ready
Instructions
Step 1: Pre-Deployment Configuration
- Production API keys in secure vault
- Environment variables set in deployment platform
- API key scopes are minimal (least privilege)
- Webhook endpoints configured with HTTPS
- Webhook secrets stored securely
Step 2: Code Quality Verification
- All tests passing (
npm test) - No hardcoded credentials
- Error handling covers all Retell AI error types
- Rate limiting/backoff implemented
- Logging is production-appropriate
Step 3: Infrastructure Setup
- Health check endpoint includes Retell AI connectivity
- Monitoring/alerting configured
- Circuit breaker pattern implemented
- Graceful degradation configured
Step 4: Documentation Requirements
- Incident runbook created
- Key rotation procedure documented
- Rollback procedure documented
- On-call escalation path defined
Step 5: Deploy with Gradual Rollout
# Pre-flight checks
curl -f https://staging.example.com/health
curl -s https://status.retellai.com
# Gradual rollout - start with canary (10%)
kubectl apply -f k8s/production.yaml
kubectl set image deployment/retellai-integration app=image:new --record
kubectl rollout pause deployment/retellai-integration
# Monitor canary traffic for 10 minutes
sleep 600
# Check error rates and latency before continuing
# If healthy, continue rollout to 50%
kubectl rollout resume deployment/retellai-integration
kubectl rollout pause deployment/retellai-integration
sleep 300
# Complete rollout to 100%
kubectl rollout resume deployment/retellai-integration
kubectl rollout status deployment/retellai-integration
Output
- Deployed Retell AI integration
- Health checks passing
- Monitoring active
- Rollback procedure documented
Error Handling
| Alert | Condition | Severity |
|---|---|---|
| API Down | 5xx errors > 10/min | P1 |
| High Latency | p99 > 5000ms | P2 |
| Rate Limited | 429 errors > 5/min | P2 |
| Auth Failures | 401/403 errors > 0 | P1 |
Examples
Health Check Implementation
async function healthCheck(): Promise<{ status: string; retellai: any }> {
const start = Date.now();
try {
await retellaiClient.ping();
return { status: 'healthy', retellai: { connected: true, latencyMs: Date.now() - start } };
} catch (error) {
return { status: 'degraded', retellai: { connected: false, latencyMs: Date.now() - start } };
}
}
Immediate Rollback
kubectl rollout undo deployment/retellai-integration
kubectl rollout status deployment/retellai-integration
Resources
Next Steps
For version upgrades, see retellai-upgrade-migration.