windsurf-prod-checklist
Execute Windsurf production deployment checklist and rollback procedures.Use when deploying Windsurf integrations to production, preparing for launch,or implementing go-live procedures.Trigger with phrases like "windsurf production", "deploy windsurf","windsurf go-live", "windsurf launch checklist".
When & Why to Use This Skill
This Claude skill streamlines the production deployment of Windsurf integrations by providing a comprehensive, automated checklist and robust rollback procedures. It ensures high-availability releases through rigorous pre-deployment verification, infrastructure readiness checks, and controlled Kubernetes rollouts, significantly reducing the risk of human error during go-live events.
Use Cases
- Case 1: Executing a step-by-step production go-live checklist for Windsurf integrations, covering security audits, environment configuration, and API key management.
- Case 2: Managing gradual canary rollouts on Kubernetes (e.g., 10% to 100%) with integrated health monitoring and latency verification to ensure system stability.
- Case 3: Performing immediate emergency rollbacks using predefined kubectl commands when production error rates or performance metrics exceed safety thresholds.
- Case 4: Verifying infrastructure readiness and connectivity through automated health check endpoints and status monitoring before initiating deployment pipelines.
| name | windsurf-prod-checklist |
|---|---|
| description | | |
| allowed-tools | Read, Bash(kubectl:*), Bash(curl:*), Grep |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
Windsurf Production Checklist
Overview
Complete checklist for deploying Windsurf 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 Windsurf error types
- Rate limiting/backoff implemented
- Logging is production-appropriate
Step 3: Infrastructure Setup
- Health check endpoint includes Windsurf 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.windsurf.com
# Gradual rollout - start with canary (10%)
kubectl apply -f k8s/production.yaml
kubectl set image deployment/windsurf-integration app=image:new --record
kubectl rollout pause deployment/windsurf-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/windsurf-integration
kubectl rollout pause deployment/windsurf-integration
sleep 300
# Complete rollout to 100%
kubectl rollout resume deployment/windsurf-integration
kubectl rollout status deployment/windsurf-integration
Output
- Deployed Windsurf 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; windsurf: any }> {
const start = Date.now();
try {
await windsurfClient.ping();
return { status: 'healthy', windsurf: { connected: true, latencyMs: Date.now() - start } };
} catch (error) {
return { status: 'degraded', windsurf: { connected: false, latencyMs: Date.now() - start } };
}
}
Immediate Rollback
kubectl rollout undo deployment/windsurf-integration
kubectl rollout status deployment/windsurf-integration
Resources
Next Steps
For version upgrades, see windsurf-upgrade-migration.