@patricio0312rev/skillset 0.1.0

package/templates/ci-cd/caching-strategy-optimizer/ SKILL.md

@@ -0,0 +1,195 @@
+---
+name: caching-strategy-optimizer
+description: Optimizes CI/CD pipeline speed by implementing effective caching for dependencies, Docker layers, build outputs, and test results. Provides before/after performance metrics and best practices. Use for "CI caching", "pipeline optimization", "build speed", or "cache strategy".
+---
+
+# Caching Strategy Optimizer
+
+Dramatically speed up CI pipelines with intelligent caching.
+
+## Cache Key Strategy
+
+### Package Manager Caches
+
+```yaml
+# NPM - Hash package-lock.json
+- uses: actions/cache@v3
+  with:
+    path: ~/.npm
+    key: ${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}
+    restore-keys: |
+      ${{ runner.os }}-npm-
+
+# pnpm - More aggressive caching
+- uses: pnpm/action-setup@v2
+  with:
+    version: 8
+
+- uses: actions/cache@v3
+  with:
+    path: |
+      ~/.pnpm-store
+      node_modules
+    key: ${{ runner.os }}-pnpm-${{ hashFiles('**/pnpm-lock.yaml') }}
+    restore-keys: |
+      ${{ runner.os }}-pnpm-
+
+# Python pip
+- uses: actions/cache@v3
+  with:
+    path: ~/.cache/pip
+    key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+
+# Cargo/Rust
+- uses: actions/cache@v3
+  with:
+    path: |
+      ~/.cargo/bin/
+      ~/.cargo/registry/index/
+      ~/.cargo/registry/cache/
+      ~/.cargo/git/db/
+      target/
+    key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+```
+
+## Docker Layer Caching
+
+### Using Buildx
+
+```yaml
+- name: Set up Docker Buildx
+  uses: docker/setup-buildx-action@v3
+
+- name: Build with cache
+  uses: docker/build-push-action@v5
+  with:
+    context: .
+    cache-from: type=gha
+    cache-to: type=gha,mode=max
+```
+
+### Registry-based Cache
+
+```yaml
+- name: Build with registry cache
+  uses: docker/build-push-action@v5
+  with:
+    context: .
+    cache-from: type=registry,ref=myapp:buildcache
+    cache-to: type=registry,ref=myapp:buildcache,mode=max
+```
+
+## Build Output Caching
+
+```yaml
+# Next.js cache
+- uses: actions/cache@v3
+  with:
+    path: |
+      ${{ github.workspace }}/.next/cache
+    key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
+    restore-keys: |
+      ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
+      ${{ runner.os }}-nextjs-
+
+# Webpack cache
+- uses: actions/cache@v3
+  with:
+    path: node_modules/.cache/webpack
+    key: ${{ runner.os }}-webpack-${{ hashFiles('webpack.config.js') }}-${{ hashFiles('src/**') }}
+
+# TypeScript build cache
+- uses: actions/cache@v3
+  with:
+    path: |
+      dist
+      tsconfig.tsbuildinfo
+    key: ${{ runner.os }}-tsc-${{ hashFiles('**/*.ts') }}
+```
+
+## Test Results Caching
+
+```yaml
+# Jest cache
+- uses: actions/cache@v3
+  with:
+    path: /tmp/jest_rt
+    key: ${{ runner.os }}-jest-${{ hashFiles('**/*.test.ts') }}
+
+# Pytest cache
+- uses: actions/cache@v3
+  with:
+    path: .pytest_cache
+    key: ${{ runner.os }}-pytest-${{ hashFiles('**/*test*.py') }}
+```
+
+## Before/After Metrics
+
+```markdown
+## Before Optimization
+
+- Total time: 12 minutes
+- npm ci: 4 minutes
+- Build: 5 minutes
+- Tests: 3 minutes
+
+## After Caching
+
+- Total time: 3 minutes
+- npm ci: 30 seconds (cache hit)
+- Build: 1 minute (incremental)
+- Tests: 1.5 minutes (cache hit)
+
+**Improvement: 75% faster (12m → 3m)**
+```
+
+## Cache Hit Rate Monitoring
+
+```yaml
+- name: Check cache hit
+  id: cache
+  uses: actions/cache@v3
+  with:
+    path: node_modules
+    key: ${{ runner.os }}-deps-${{ hashFiles('package-lock.json') }}
+
+- name: Log cache status
+  run: |
+    if [ "${{ steps.cache.outputs.cache-hit }}" == "true" ]; then
+      echo "✅ Cache hit - saved $(date -u -d @$SECONDS +%M:%S)"
+    else
+      echo "❌ Cache miss - installing from scratch"
+    fi
+```
+
+## Best Practices
+
+1. **Precise keys**: Include all dependencies in hash
+2. **Restore keys**: Fallback to partial matches
+3. **Multiple paths**: Cache related files together
+4. **Size limits**: GitHub Actions limit is 10GB
+5. **Expiration**: Caches expire after 7 days
+6. **Mode=max**: Docker cache mode for better hits
+7. **Monitor hits**: Track cache effectiveness
+
+## Common Pitfalls
+
+❌ **Too generic keys**: `key: deps` (always hits)
+✅ **Specific keys**: `key: deps-${{ hashFiles('package-lock.json') }}`
+
+❌ **Missing restore-keys**: Cache miss on minor changes
+✅ **Restore keys**: Partial match fallback
+
+❌ **Caching node_modules with wrong lock file**
+✅ **Match lock file**: Hash the right lockfile
+
+## Output Checklist
+
+- [ ] Package manager cache configured
+- [ ] Build output cache
+- [ ] Docker layer cache (if applicable)
+- [ ] Test cache configured
+- [ ] Cache keys use file hashes
+- [ ] Restore keys for fallback
+- [ ] Before/after metrics documented
+- [ ] Cache hit monitoring

package/templates/ci-cd/deployment-checklist-generator/ SKILL.md

@@ -0,0 +1,381 @@
+---
+name: deployment-checklist-generator
+description: Creates comprehensive deployment checklists with pre-deployment checks, smoke tests, verification steps, and sign-off workflows. Use for "deployment checklist", "release verification", "deployment runbook", or "production readiness".
+---
+
+# Deployment Checklist Generator
+
+Ensure safe, reliable deployments with comprehensive checklists.
+
+## Pre-Deployment Checklist
+
+```markdown
+# Pre-Deployment Checklist
+
+## Code Quality
+
+- [ ] All CI checks passing
+- [ ] Code review approved (2+ reviewers)
+- [ ] No known critical bugs
+- [ ] Security scan passed
+- [ ] Performance tests passed
+
+## Dependencies
+
+- [ ] All dependencies up to date
+- [ ] No high/critical vulnerabilities
+- [ ] Bundle size within budget
+- [ ] Third-party services operational
+
+## Database
+
+- [ ] Migrations tested in staging
+- [ ] Backup completed
+- [ ] Rollback plan documented
+- [ ] Data migration scripts reviewed
+
+## Infrastructure
+
+- [ ] Servers have capacity
+- [ ] CDN cache invalidation plan
+- [ ] Load balancer configured
+- [ ] SSL certificates valid
+
+## Documentation
+
+- [ ] Changelog updated
+- [ ] API docs updated (if changed)
+- [ ] Deployment notes prepared
+- [ ] Rollback instructions ready
+
+## Communication
+
+- [ ] Stakeholders notified
+- [ ] Maintenance window scheduled (if needed)
+- [ ] Support team briefed
+- [ ] Status page prepared
+
+## Deployment Window
+
+- [ ] Off-peak hours selected
+- [ ] Team available for monitoring
+- [ ] Emergency contacts confirmed
+```
+
+## Deployment Workflow with Checks
+
+```yaml
+# .github/workflows/deploy.yml
+name: Deploy to Production
+
+on:
+  workflow_dispatch:
+
+jobs:
+  pre-deploy-checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check branch
+        run: |
+          if [ "${{ github.ref }}" != "refs/heads/main" ]; then
+            echo "❌ Can only deploy from main branch"
+            exit 1
+          fi
+
+      - name: Verify CI passed
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const checks = await github.rest.checks.listForRef({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              ref: context.sha,
+            });
+
+            const failed = checks.data.check_runs.filter(
+              check => check.conclusion === 'failure'
+            );
+
+            if (failed.length > 0) {
+              throw new Error(`CI checks failed: ${failed.map(c => c.name).join(', ')}`);
+            }
+
+      - name: Check deployment window
+        run: |
+          HOUR=$(date +%H)
+          if [ $HOUR -ge 9 ] && [ $HOUR -le 17 ]; then
+            echo "⚠️ Deploying during business hours"
+          else
+            echo "✅ Deploying outside business hours"
+          fi
+
+      - name: Verify staging deployment
+        run: |
+          if ! curl -f https://staging.myapp.com/health; then
+            echo "❌ Staging is not healthy"
+            exit 1
+          fi
+
+  deploy:
+    needs: pre-deploy-checks
+    runs-on: ubuntu-latest
+    environment:
+      name: production
+      url: https://myapp.com
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Backup database
+        run: ./scripts/backup-db.sh
+
+      - name: Deploy
+        run: ./scripts/deploy.sh production
+
+      - name: Run smoke tests
+        run: ./scripts/smoke-tests.sh production
+
+      - name: Update status page
+        run: |
+          curl -X POST https://statuspage.io/api/v1/incidents \
+            -H "Authorization: Bearer ${{ secrets.STATUSPAGE_TOKEN }}" \
+            -d '{"name":"Deployment Complete","status":"resolved"}'
+
+      - name: Create deployment record
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.repos.createDeployment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              ref: context.sha,
+              environment: 'production',
+              description: 'Production deployment',
+            });
+```
+
+## Smoke Test Script
+
+```bash
+#!/bin/bash
+# scripts/smoke-tests.sh
+
+ENVIRONMENT=$1
+BASE_URL="https://${ENVIRONMENT}.myapp.com"
+
+echo "🔍 Running smoke tests for $ENVIRONMENT..."
+
+FAILED=0
+
+# Test 1: Health endpoint
+echo "Test 1: Health check"
+if curl -f "$BASE_URL/health" | grep -q "ok"; then
+  echo "✅ Health check passed"
+else
+  echo "❌ Health check failed"
+  FAILED=1
+fi
+
+# Test 2: User authentication
+echo "Test 2: User login"
+TOKEN=$(curl -s -X POST "$BASE_URL/api/auth/login" \
+  -H "Content-Type: application/json" \
+  -d '{"email":"test@example.com","password":"test123"}' \
+  | jq -r '.token')
+
+if [ -n "$TOKEN" ] && [ "$TOKEN" != "null" ]; then
+  echo "✅ Login passed"
+else
+  echo "❌ Login failed"
+  FAILED=1
+fi
+
+# Test 3: Critical API endpoints
+echo "Test 3: API endpoints"
+ENDPOINTS=("/api/users" "/api/products" "/api/orders")
+
+for endpoint in "${ENDPOINTS[@]}"; do
+  STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
+    -H "Authorization: Bearer $TOKEN" \
+    "$BASE_URL$endpoint")
+
+  if [ "$STATUS" == "200" ]; then
+    echo "✅ $endpoint: $STATUS"
+  else
+    echo "❌ $endpoint: $STATUS"
+    FAILED=1
+  fi
+done
+
+# Test 4: Database connectivity
+echo "Test 4: Database check"
+if curl -f "$BASE_URL/api/health/db" | grep -q "connected"; then
+  echo "✅ Database connected"
+else
+  echo "❌ Database connection failed"
+  FAILED=1
+fi
+
+# Test 5: External services
+echo "Test 5: External services"
+SERVICES=("stripe" "sendgrid" "aws")
+
+for service in "${SERVICES[@]}"; do
+  if curl -f "$BASE_URL/api/health/$service" | grep -q "ok"; then
+    echo "✅ $service: connected"
+  else
+    echo "❌ $service: connection failed"
+    FAILED=1
+  fi
+done
+
+if [ $FAILED -eq 1 ]; then
+  echo "❌ Smoke tests failed"
+  exit 1
+fi
+
+echo "✅ All smoke tests passed"
+exit 0
+```
+
+## Post-Deployment Verification
+
+```markdown
+# Post-Deployment Verification
+
+## Immediate Checks (0-5 minutes)
+
+- [ ] Deployment completed successfully
+- [ ] All smoke tests passed
+- [ ] Health checks returning 200
+- [ ] No 5xx errors in logs
+- [ ] Application responding
+
+## Short-term Monitoring (5-30 minutes)
+
+- [ ] Error rate <1%
+- [ ] Response time p95 <500ms
+- [ ] CPU usage normal (<70%)
+- [ ] Memory usage stable
+- [ ] Database queries performing well
+
+## Feature Verification
+
+- [ ] Login/authentication working
+- [ ] Checkout flow functional
+- [ ] Search returning results
+- [ ] Email notifications sending
+- [ ] Payment processing working
+
+## Metrics Dashboard
+
+- [ ] Request volume normal
+- [ ] Success rate >99%
+- [ ] Latency within SLA
+- [ ] No spike in errors
+- [ ] User engagement stable
+
+## Long-term Monitoring (1-24 hours)
+
+- [ ] No user complaints
+- [ ] Support tickets normal
+- [ ] Revenue tracking normal
+- [ ] All scheduled jobs running
+- [ ] No memory leaks detected
+```
+
+## Sign-off Template
+
+```yaml
+- name: Request deployment approval
+  uses: trstringer/manual-approval@v1
+  with:
+    secret: ${{ secrets.GITHUB_TOKEN }}
+    approvers: tech-lead,ops-manager
+    minimum-approvals: 2
+    issue-title: "Approve Production Deployment"
+    issue-body: |
+      ## Deployment Details
+
+      **Version:** ${{ github.ref_name }}
+      **Commit:** ${{ github.sha }}
+      **Changes:** See [changelog](CHANGELOG.md)
+
+      ## Pre-deployment Checklist
+      - ✅ All CI checks passed
+      - ✅ Code review completed
+      - ✅ Security scan passed
+      - ✅ Staging verified
+
+      ## Approval Required
+      This deployment requires approval from tech lead and ops manager.
+
+      **Approve:** Comment "approve" or "lgtm"
+      **Reject:** Comment "reject" or "block"
+```
+
+## Monitoring Dashboard
+
+```markdown
+# Deployment Monitoring Dashboard
+
+## Key Metrics
+
+### Health
+
+- API Health: ✅ UP
+- Database: ✅ Connected
+- Cache: ✅ Connected
+
+### Performance
+
+- Requests/min: 1,234
+- Error rate: 0.2%
+- p50 latency: 120ms
+- p95 latency: 450ms
+- p99 latency: 1,200ms
+
+### Infrastructure
+
+- CPU: 45%
+- Memory: 62%
+- Disk: 38%
+
+### Business Metrics
+
+- Active users: 523
+- Successful checkouts: 89/hour
+- Revenue: $15,234/hour
+
+## Alerts
+
+No active alerts
+
+## Recent Deployments
+
+- v1.3.0: Deployed 5 minutes ago ✅
+- v1.2.9: Deployed 2 days ago ✅
+- v1.2.8: Rolled back 3 days ago ⚠️
+```
+
+## Best Practices
+
+1. **Automated checks**: Enforce via CI/CD
+2. **Manual review**: Critical deployments need approval
+3. **Smoke tests**: Verify key functionality
+4. **Gradual rollout**: Canary or blue-green
+5. **Monitoring**: Watch metrics for 30 minutes
+6. **Communication**: Keep stakeholders informed
+7. **Rollback ready**: One-click rollback available
+
+## Output Checklist
+
+- [ ] Pre-deployment checklist
+- [ ] Deployment workflow with gates
+- [ ] Smoke test script
+- [ ] Post-deployment verification
+- [ ] Sign-off workflow
+- [ ] Monitoring dashboard
+- [ ] Communication templates
+- [ ] Rollback instructions