@patricio0312rev/skillset 0.1.0

package/templates/ci-cd/release-automation-builder/ SKILL.md

@@ -0,0 +1,281 @@
+---
+name: release-automation-builder
+description: Automates releases and package publishing with changesets or semantic-release. Handles versioning, changelog generation, git tags, and release notes. Use for "release automation", "semantic versioning", "package publishing", or "changelog generation".
+---
+
+# Release Automation Builder
+
+Automate releases with versioning, changelogs, and publishing.
+
+## Using Changesets
+
+### Setup
+
+```bash
+npm install -D @changesets/cli
+npx changeset init
+```
+
+### Workflow
+
+```yaml
+# .github/workflows/release.yml
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - run: npm ci
+
+      - name: Create Release Pull Request or Publish
+        uses: changesets/action@v1
+        with:
+          publish: npm run release
+          commit: "chore: release packages"
+          title: "chore: release packages"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+
+### Package Scripts
+
+```json
+{
+  "scripts": {
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish"
+  }
+}
+```
+
+## Using Semantic Release
+
+### Configuration
+
+```javascript
+// .releaserc.js
+module.exports = {
+  branches: ["main"],
+  plugins: [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    "@semantic-release/npm",
+    "@semantic-release/github",
+    [
+      "@semantic-release/git",
+      {
+        assets: ["CHANGELOG.md", "package.json"],
+        message:
+          "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}",
+      },
+    ],
+  ],
+};
+```
+
+### Workflow
+
+```yaml
+# .github/workflows/release.yml
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - run: npm ci
+      - run: npm run build
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release
+```
+
+## Versioning Strategy
+
+### Semantic Versioning (SemVer)
+
+```
+MAJOR.MINOR.PATCH
+
+1.0.0 → 1.0.1  (patch - bug fix)
+1.0.1 → 1.1.0  (minor - new feature)
+1.1.0 → 2.0.0  (major - breaking change)
+```
+
+### Conventional Commits
+
+```
+feat: add new feature (minor bump)
+fix: fix bug (patch bump)
+perf: performance improvement (patch bump)
+docs: update docs (no bump)
+chore: maintenance (no bump)
+
+feat!: breaking change (major bump)
+fix!: breaking bug fix (major bump)
+```
+
+## Changelog Generation
+
+```markdown
+# Changelog
+
+## [2.1.0] - 2024-01-15
+
+### Added
+
+- New dashboard widget (#123)
+- Export to PDF feature (#125)
+
+### Fixed
+
+- Memory leak in data processing (#124)
+- Typo in error message (#126)
+
+### Changed
+
+- Updated dependencies
+
+## [2.0.0] - 2024-01-01
+
+### Breaking Changes
+
+- Removed deprecated API endpoints
+- Changed authentication method
+
+### Migration Guide
+
+See MIGRATION.md for upgrade instructions
+```
+
+## Docker Image Publishing
+
+```yaml
+docker-release:
+  runs-on: ubuntu-latest
+  needs: test
+  if: github.ref == 'refs/heads/main'
+  steps:
+    - uses: actions/checkout@v4
+
+    - name: Get version
+      id: version
+      run: echo "version=$(cat package.json | jq -r '.version')" >> $GITHUB_OUTPUT
+
+    - name: Login to Docker Hub
+      uses: docker/login-action@v3
+      with:
+        username: ${{ secrets.DOCKER_USERNAME }}
+        password: ${{ secrets.DOCKER_PASSWORD }}
+
+    - name: Build and push
+      uses: docker/build-push-action@v5
+      with:
+        context: .
+        push: true
+        tags: |
+          mycompany/myapp:latest
+          mycompany/myapp:${{ steps.version.outputs.version }}
+```
+
+## NPM Publishing
+
+```yaml
+publish:
+  runs-on: ubuntu-latest
+  needs: test
+  if: github.event_name == 'release'
+  steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-node@v4
+      with:
+        node-version: "20"
+        registry-url: "https://registry.npmjs.org"
+
+    - run: npm ci
+    - run: npm run build
+
+    - name: Publish to npm
+      run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+
+## GitHub Release Notes
+
+````yaml
+- name: Create GitHub Release
+  uses: actions/create-release@v1
+  env:
+    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  with:
+    tag_name: v${{ steps.version.outputs.version }}
+    release_name: Release ${{ steps.version.outputs.version }}
+    body: |
+      ## What's Changed
+      ${{ steps.changelog.outputs.content }}
+
+      ## Installation
+      ```bash
+      npm install mypackage@${{ steps.version.outputs.version }}
+      ```
+    draft: false
+    prerelease: false
+````
+
+## Best Practices
+
+1. **Conventional commits**: Standardize commit format
+2. **Protected branches**: Prevent direct pushes to main
+3. **Automated versioning**: Let tools determine versions
+4. **Changelogs**: Auto-generate from commits
+5. **Git tags**: Tag every release
+6. **Release notes**: Include migration guides
+7. **Dry run**: Test releases in staging
+
+## Output Checklist
+
+- [ ] Changesets or semantic-release configured
+- [ ] Versioning strategy documented
+- [ ] Changelog generation automated
+- [ ] Git tagging automated
+- [ ] Release notes template
+- [ ] NPM publishing (if package)
+- [ ] Docker publishing (if applicable)
+- [ ] Protected branch rules

package/templates/ci-cd/rollback-workflow-builder/ SKILL.md

@@ -0,0 +1,372 @@
+---
+name: rollback-workflow-builder
+description: Creates safe rollback procedures for deployments with automated workflows, rollback runbooks, version management, and incident response. Use for "rollback automation", "deployment recovery", "incident response", or "production rollback".
+---
+
+# Rollback Workflow Builder
+
+Build safe, fast rollback mechanisms for production deployments.
+
+## Manual Rollback Workflow
+
+```yaml
+# .github/workflows/rollback.yml
+name: Rollback
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version to rollback to (e.g., v1.2.3 or previous)"
+        required: true
+        type: string
+      environment:
+        description: "Environment to rollback"
+        required: true
+        type: choice
+        options:
+          - staging
+          - production
+      reason:
+        description: "Reason for rollback"
+        required: true
+        type: string
+
+jobs:
+  rollback:
+    runs-on: ubuntu-latest
+    environment: ${{ github.event.inputs.environment }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.inputs.version }}
+
+      - name: Verify version exists
+        run: |
+          if ! git rev-parse ${{ github.event.inputs.version }} >/dev/null 2>&1; then
+            echo "❌ Version ${{ github.event.inputs.version }} not found"
+            exit 1
+          fi
+          echo "✅ Version ${{ github.event.inputs.version }} exists"
+
+      - name: Get current version
+        id: current
+        run: |
+          CURRENT=$(git describe --tags --abbrev=0)
+          echo "version=$CURRENT" >> $GITHUB_OUTPUT
+          echo "Current version: $CURRENT"
+
+      - name: Confirm rollback
+        run: |
+          echo "🔄 Rolling back from ${{ steps.current.outputs.version }} to ${{ github.event.inputs.version }}"
+          echo "Environment: ${{ github.event.inputs.environment }}"
+          echo "Reason: ${{ github.event.inputs.reason }}"
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - run: npm ci
+      - run: npm run build
+
+      - name: Deploy rollback
+        run: |
+          ./scripts/deploy.sh ${{ github.event.inputs.environment }}
+        env:
+          DEPLOY_TOKEN: ${{ secrets.DEPLOY_TOKEN }}
+
+      - name: Verify deployment
+        run: |
+          ./scripts/health-check.sh ${{ github.event.inputs.environment }}
+
+      - name: Create incident issue
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: `Rollback: ${context.payload.inputs.environment} to ${context.payload.inputs.version}`,
+              body: `## Rollback Details
+              
+              **Environment:** ${context.payload.inputs.environment}
+              **From:** ${{ steps.current.outputs.version }}
+              **To:** ${context.payload.inputs.version}
+              **Reason:** ${context.payload.inputs.reason}
+              **Triggered by:** @${context.actor}
+              **Time:** ${new Date().toISOString()}
+              
+              ## Next Steps
+              - [ ] Verify rollback successful
+              - [ ] Investigate root cause
+              - [ ] Create fix
+              - [ ] Update postmortem
+              `,
+              labels: ['incident', 'rollback']
+            })
+```
+
+## Automated Rollback on Failure
+
+```yaml
+deploy:
+  runs-on: ubuntu-latest
+  steps:
+    - name: Deploy
+      id: deploy
+      run: ./scripts/deploy.sh production
+      continue-on-error: true
+
+    - name: Verify deployment
+      id: verify
+      if: steps.deploy.outcome == 'success'
+      run: ./scripts/health-check.sh production
+      continue-on-error: true
+
+    - name: Auto-rollback on failure
+      if: steps.deploy.outcome == 'failure' || steps.verify.outcome == 'failure'
+      run: |
+        echo "⚠️ Deployment failed, initiating automatic rollback"
+        PREVIOUS_VERSION=$(git describe --tags --abbrev=0 HEAD^)
+        ./scripts/deploy.sh production $PREVIOUS_VERSION
+
+        # Verify rollback
+        if ./scripts/health-check.sh production; then
+          echo "✅ Rollback successful"
+        else
+          echo "❌ Rollback failed - manual intervention required"
+          exit 1
+        fi
+```
+
+## Kubernetes Rollback
+
+```yaml
+rollback-k8s:
+  runs-on: ubuntu-latest
+  steps:
+    - name: Setup kubectl
+      uses: azure/setup-kubectl@v3
+
+    - name: Configure kubectl
+      run: |
+        echo "${{ secrets.KUBECONFIG }}" > kubeconfig
+        export KUBECONFIG=kubeconfig
+
+    - name: Rollback deployment
+      run: |
+        kubectl rollout undo deployment/myapp -n production
+        kubectl rollout status deployment/myapp -n production --timeout=5m
+
+    - name: Get rollback revision
+      run: |
+        kubectl rollout history deployment/myapp -n production
+```
+
+## Docker Image Rollback
+
+```yaml
+- name: Rollback to previous image
+  run: |
+    # Get previous image tag
+    PREVIOUS_TAG=$(docker inspect myapp:latest | jq -r '.[0].ContainerConfig.Labels.previous_tag')
+
+    # Retag previous as latest
+    docker pull myapp:$PREVIOUS_TAG
+    docker tag myapp:$PREVIOUS_TAG myapp:latest
+    docker push myapp:latest
+
+    # Restart containers
+    docker-compose pull
+    docker-compose up -d
+```
+
+## Database Migration Rollback
+
+```yaml
+- name: Rollback database migrations
+  run: |
+    # Get migration to rollback to
+    CURRENT=$(npm run migrate:current)
+    TARGET=${{ github.event.inputs.migration }}
+
+    echo "Rolling back from $CURRENT to $TARGET"
+    npm run migrate:down -- --to=$TARGET
+
+    # Verify rollback
+    AFTER=$(npm run migrate:current)
+    if [ "$AFTER" != "$TARGET" ]; then
+      echo "❌ Migration rollback failed"
+      exit 1
+    fi
+  env:
+    DATABASE_URL: ${{ secrets.DATABASE_URL }}
+```
+
+## Rollback Runbook
+
+````markdown
+# Production Rollback Runbook
+
+## When to Rollback
+
+Rollback if:
+
+- Critical bugs affecting >10% of users
+- Data integrity issues
+- Security vulnerabilities
+- Performance degradation >50%
+- Error rate >5%
+
+## Before Rollback
+
+1. **Assess impact**: Check monitoring dashboards
+2. **Identify version**: Determine last known good version
+3. **Notify team**: Post in #incidents Slack channel
+4. **Enable maintenance mode** (if possible)
+
+## Rollback Steps
+
+### Automated Rollback (Preferred)
+
+1. Go to Actions → Rollback workflow
+2. Select environment (staging/production)
+3. Enter target version (e.g., v1.2.3 or "previous")
+4. Enter reason for rollback
+5. Click "Run workflow"
+6. Monitor progress in Actions tab
+
+### Manual Rollback (Emergency)
+
+```bash
+# 1. SSH to production server
+ssh production
+
+# 2. Check current version
+docker ps | grep myapp
+
+# 3. Pull previous version
+docker pull myapp:v1.2.3
+
+# 4. Update docker-compose
+vim docker-compose.yml
+# Change image: myapp:latest to myapp:v1.2.3
+
+# 5. Deploy
+docker-compose up -d
+
+# 6. Verify
+curl https://api.myapp.com/health
+
+# 7. Check logs
+docker logs myapp -f
+```
+````
+
+## After Rollback
+
+1. **Verify**: Run smoke tests
+2. **Monitor**: Watch error rates for 15 minutes
+3. **Notify**: Update #incidents with status
+4. **Disable maintenance mode**
+5. **Create incident ticket**
+6. **Schedule postmortem**
+
+## Rollback Verification
+
+- [ ] Health check returns 200
+- [ ] Error rate <1%
+- [ ] Response time p95 <500ms
+- [ ] Key features working (login, checkout, etc.)
+- [ ] Database connectivity OK
+
+## Communication Template
+
+```
+🔄 ROLLBACK IN PROGRESS
+
+Environment: Production
+From: v1.3.0
+To: v1.2.3
+Reason: Critical bug in checkout flow
+Status: In progress
+ETA: 5 minutes
+
+Updates: #incidents
+```
+
+## Common Issues
+
+### Issue: Rollback Fails
+
+**Symptom:** Deployment doesn't start
+**Fix:** Check logs, verify version exists, ensure secrets are valid
+
+### Issue: Database Incompatibility
+
+**Symptom:** App starts but can't read data
+**Fix:** May need to rollback migrations first
+
+### Issue: Traffic Not Routing
+
+**Symptom:** Users still see new version
+**Fix:** Clear CDN cache, check load balancer config
+
+````
+
+## Health Check Script
+
+```bash
+#!/bin/bash
+# scripts/health-check.sh
+
+ENVIRONMENT=$1
+BASE_URL="https://${ENVIRONMENT}.myapp.com"
+
+echo "Running health checks for $ENVIRONMENT..."
+
+# API health
+if ! curl -f "$BASE_URL/api/health" > /dev/null 2>&1; then
+  echo "❌ API health check failed"
+  exit 1
+fi
+
+# Database connection
+if ! curl -f "$BASE_URL/api/health/db" > /dev/null 2>&1; then
+  echo "❌ Database health check failed"
+  exit 1
+fi
+
+# Key endpoints
+ENDPOINTS=("/api/users" "/api/products" "/api/orders")
+for endpoint in "${ENDPOINTS[@]}"; do
+  if ! curl -f "$BASE_URL$endpoint" > /dev/null 2>&1; then
+    echo "❌ Endpoint $endpoint health check failed"
+    exit 1
+  fi
+done
+
+echo "✅ All health checks passed"
+exit 0
+````
+
+## Best Practices
+
+1. **Fast rollback**: <5 minutes to previous version
+2. **Automated**: One-click rollback workflow
+3. **Verified**: Health checks after rollback
+4. **Documented**: Clear runbook
+5. **Tested**: Practice rollbacks regularly
+6. **Monitored**: Alert on failures
+7. **Communicated**: Notify stakeholders
+
+## Output Checklist
+
+- [ ] Manual rollback workflow
+- [ ] Automated rollback on failure
+- [ ] Platform-specific rollback (K8s/Docker)
+- [ ] Database rollback procedure
+- [ ] Rollback runbook documented
+- [ ] Health check scripts
+- [ ] Communication templates
+- [ ] Incident issue automation