ai-sprint-kit 1.1.0

package/templates/.claude/commands/deploy.md

@@ -0,0 +1,475 @@
+---
+description: Set up CI/CD pipeline and deployment automation
+argument-hint: [optional: platform (github|gitlab|vercel|railway)]
+---
+
+## Command: /deploy
+
+Set up automated CI/CD pipeline and configure deployment to your chosen platform.
+
+## Usage
+
+```
+/deploy
+/deploy --platform github
+/deploy --platform vercel
+/deploy --platform railway
+```
+
+## Workflow
+
+### 1. Assess Current Setup
+- Check existing CI/CD configuration
+- Identify deployment platform
+- Review infrastructure needs
+
+### 2. Platform Selection
+If not specified, suggest based on project:
+- **Next.js/React**: Vercel (recommended)
+- **Full-stack with DB**: Railway
+- **High traffic**: Cloudflare Workers
+- **Multi-service**: Render
+- **Custom infrastructure**: GitHub Actions + platform of choice
+
+### 3. Generate CI/CD Pipeline
+- Create GitHub Actions workflow (or GitLab CI)
+- Configure automated testing
+- Add security scanning
+- Set up deployment automation
+
+### 4. Configure Deployment
+- Set up deployment platform
+- Configure environment variables
+- Add health checks
+- Enable monitoring
+
+### 5. Test Deployment
+- Deploy to staging
+- Run smoke tests
+- Verify functionality
+- Deploy to production
+
+## Supported Platforms 2025
+
+### GitHub Actions (CI/CD)
+```yaml
+# .github/workflows/deploy.yml
+name: Deploy
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - run: npm ci
+      - run: npm test
+      - run: npm run build
+
+      - name: Deploy to Vercel
+        uses: amondnet/vercel-action@v25
+        with:
+          vercel-token: ${{ secrets.VERCEL_TOKEN }}
+          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
+          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
+          vercel-args: '--prod'
+```
+
+### Vercel (Next.js/React)
+```json
+// vercel.json
+{
+  "version": 2,
+  "framework": "nextjs",
+  "buildCommand": "npm run build",
+  "env": {
+    "NODE_ENV": "production"
+  },
+  "headers": [
+    {
+      "source": "/(.*)",
+      "headers": [
+        {"key": "X-Frame-Options", "value": "DENY"},
+        {"key": "X-Content-Type-Options", "value": "nosniff"}
+      ]
+    }
+  ]
+}
+```
+
+### Railway (Full-Stack)
+```toml
+# railway.toml
+[build]
+builder = "NIXPACKS"
+
+[deploy]
+startCommand = "npm start"
+healthcheckPath = "/health"
+restartPolicyType = "ON_FAILURE"
+
+[[services]]
+name = "web"
+```
+
+### Cloudflare Workers (Edge)
+```toml
+# wrangler.toml
+name = "app"
+main = "src/index.ts"
+compatibility_date = "2025-01-01"
+
+[env.production]
+routes = [{ pattern = "app.com/*", zone_name = "app.com" }]
+```
+
+## Complete CI/CD Pipeline
+
+```yaml
+# .github/workflows/ci-cd.yml
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+env:
+  NODE_VERSION: '20.x'
+
+jobs:
+  # Quality checks
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run type-check
+
+  # Tests
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+
+      - run: npm ci
+      - run: npm test -- --coverage
+
+      - name: Check coverage >= 80%
+        run: |
+          coverage=$(cat coverage/coverage-summary.json | jq '.total.lines.pct')
+          if (( $(echo "$coverage < 80" | bc -l) )); then
+            exit 1
+          fi
+
+  # Security scan
+  security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: snyk/actions/node@master
+        env:
+          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
+
+  # Build
+  build:
+    needs: [quality, test, security]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+
+      - run: npm ci
+      - run: npm run build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: build
+          path: dist/
+
+  # Deploy to production
+  deploy:
+    if: github.ref == 'refs/heads/main'
+    needs: [build]
+    runs-on: ubuntu-latest
+    environment: production
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+
+      - name: Deploy
+        run: |
+          # Platform-specific deployment
+          npm run deploy
+
+      - name: Health check
+        run: |
+          sleep 30
+          curl -f https://app.com/health || exit 1
+
+      - name: Rollback on failure
+        if: failure()
+        run: npm run rollback
+```
+
+## Environment Variables Setup
+
+### GitHub Secrets
+```bash
+# Add secrets to GitHub repository
+gh secret set DATABASE_URL
+gh secret set VERCEL_TOKEN
+gh secret set SNYK_TOKEN
+gh secret set STRIPE_SECRET_KEY
+```
+
+### .env.example Template
+```bash
+# Database
+DATABASE_URL=postgresql://user:pass@localhost/db
+
+# API Keys
+STRIPE_SECRET_KEY=sk_test_xxx
+SENDGRID_API_KEY=SG.xxx
+
+# Auth
+JWT_SECRET=your-secret-here
+
+# Monitoring
+SENTRY_DSN=https://xxx@sentry.io/xxx
+```
+
+## Deployment Checklist
+
+### Pre-Deployment
+- ✅ All tests passing
+- ✅ Security scan clean
+- ✅ Code reviewed
+- ✅ Coverage >80%
+- ✅ Secrets in environment (not code)
+- ✅ Health checks implemented
+- ✅ Rollback plan ready
+
+### Deployment
+- ✅ Deploy to staging first
+- ✅ Run smoke tests
+- ✅ Check logs/metrics
+- ✅ Verify health checks
+- ✅ Deploy to production
+- ✅ Monitor for 10 minutes
+
+### Post-Deployment
+- ✅ Verify functionality
+- ✅ Check error rates
+- ✅ Monitor performance
+- ✅ Update documentation
+
+## Monitoring Setup
+
+### Health Check Endpoint
+```typescript
+// app/api/health/route.ts
+export async function GET() {
+  const checks = {
+    database: await checkDatabase(),
+    redis: await checkRedis()
+  };
+
+  const healthy = Object.values(checks).every(c => c.healthy);
+
+  return Response.json({
+    status: healthy ? 'healthy' : 'degraded',
+    checks,
+    timestamp: new Date().toISOString()
+  }, {
+    status: healthy ? 200 : 503
+  });
+}
+```
+
+### Sentry (Error Tracking)
+```typescript
+import * as Sentry from '@sentry/node';
+
+Sentry.init({
+  dsn: process.env.SENTRY_DSN,
+  environment: process.env.NODE_ENV,
+  tracesSampleRate: 1.0
+});
+```
+
+## Rollback Strategy
+
+### Automatic Rollback
+```yaml
+- name: Health check after deploy
+  run: |
+    sleep 60
+    health=$(curl -s https://app.com/health | jq -r '.status')
+    if [ "$health" != "healthy" ]; then
+      echo "Deployment unhealthy, rolling back"
+      exit 1
+    fi
+
+- name: Rollback on failure
+  if: failure()
+  run: |
+    # Platform-specific rollback
+    vercel rollback
+    # or railway rollback
+    # or kubectl rollout undo
+```
+
+### Manual Rollback
+```bash
+# Vercel
+vercel rollback
+
+# Railway
+railway rollback
+
+# Kubernetes
+kubectl rollout undo deployment/app
+```
+
+## Platform-Specific Guides
+
+### Vercel Deployment
+```bash
+# Install Vercel CLI
+npm i -g vercel
+
+# Login
+vercel login
+
+# Link project
+vercel link
+
+# Deploy
+vercel --prod
+```
+
+### Railway Deployment
+```bash
+# Install Railway CLI
+npm i -g @railway/cli
+
+# Login
+railway login
+
+# Init project
+railway init
+
+# Deploy
+railway up
+```
+
+### Cloudflare Workers
+```bash
+# Install Wrangler
+npm i -g wrangler
+
+# Login
+wrangler login
+
+# Deploy
+wrangler deploy
+```
+
+## Security Configuration
+
+### Security Headers
+```typescript
+// middleware.ts
+export function middleware() {
+  const headers = new Headers();
+  headers.set('X-Frame-Options', 'DENY');
+  headers.set('X-Content-Type-Options', 'nosniff');
+  headers.set('Strict-Transport-Security', 'max-age=31536000');
+  return NextResponse.next({ headers });
+}
+```
+
+### Rate Limiting
+```typescript
+import rateLimit from 'express-rate-limit';
+
+const limiter = rateLimit({
+  windowMs: 15 * 60 * 1000, // 15 min
+  max: 100
+});
+
+app.use('/api/', limiter);
+```
+
+## Output
+
+After `/deploy` completion:
+
+✅ **CI/CD Pipeline Configured**
+- Automated testing
+- Security scanning
+- Build automation
+- Deployment automation
+
+✅ **Deployment Platform Set Up**
+- Environment variables configured
+- Health checks enabled
+- Monitoring integrated
+- Rollback tested
+
+✅ **Documentation Created**
+- Deployment guide
+- Environment setup
+- Rollback procedures
+- Monitoring access
+
+## Next Steps
+
+1. Push code to trigger deployment
+2. Monitor deployment in CI/CD
+3. Verify application health
+4. Set up alerts for errors
+5. Document any manual steps
+
+## Common Issues
+
+### Build Failures
+- Check Node.js version
+- Verify dependencies
+- Check build logs
+
+### Environment Variables
+- Ensure all secrets set
+- Check variable names
+- Verify access permissions
+
+### Health Check Fails
+- Check application logs
+- Verify database connection
+- Test health endpoint locally
+
+## Remember
+
+**Deployment should be:**
+- Automated (no manual steps)
+- Fast (<10 minutes)
+- Safe (can rollback)
+- Monitored (know if issues)
+- Repeatable (consistent every time)
+
+**Production is sacred - test in staging first.**