claude-flow 3.28.0 → 3.30.0

package/.claude/agents/github/release-swarm.md

@@ -1,551 +1,551 @@
----
-name: release-swarm
-description: |
-  Orchestrate complex software releases using AI swarms that handle everything from changelog generation to multi-platform deployment
-tools: Bash, Read, Write, Edit, TodoWrite, TodoRead, Task, mcp__github__create_pull_request, mcp__github__merge_pull_request, mcp__github__create_branch, mcp__github__push_files, mcp__github__create_issue, mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, mcp__claude-flow__parallel_execute, mcp__claude-flow__load_balance
----
-
-# Release Swarm - Intelligent Release Automation
-
-## Overview
-Orchestrate complex software releases using AI swarms that handle everything from changelog generation to multi-platform deployment.
-
-## Core Features
-
-### 1. Release Planning
-```bash
-# Plan next release using gh CLI
-# Get commit history since last release
-LAST_TAG=$(gh release list --limit 1 --json tagName -q '.[0].tagName')
-COMMITS=$(gh api repos/:owner/:repo/compare/${LAST_TAG}...HEAD --jq '.commits')
-
-# Get merged PRs
-MERGED_PRS=$(gh pr list --state merged --base main --json number,title,labels,mergedAt \
-  --jq ".[] | select(.mergedAt > \"$(gh release view $LAST_TAG --json publishedAt -q .publishedAt)\")")  
-
-# Plan release with commit analysis
-npx ruv-swarm github release-plan \
-  --commits "$COMMITS" \
-  --merged-prs "$MERGED_PRS" \
-  --analyze-commits \
-  --suggest-version \
-  --identify-breaking \
-  --generate-timeline
-```
-
-### 2. Automated Versioning
-```bash
-# Smart version bumping
-npx ruv-swarm github release-version \
-  --strategy "semantic" \
-  --analyze-changes \
-  --check-breaking \
-  --update-files
-```
-
-### 3. Release Orchestration
-```bash
-# Full release automation with gh CLI
-# Generate changelog from PRs and commits
-CHANGELOG=$(gh api repos/:owner/:repo/compare/${LAST_TAG}...HEAD \
-  --jq '.commits[].commit.message' | \
-  npx ruv-swarm github generate-changelog)
-
-# Create release draft
-gh release create v2.0.0 \
-  --draft \
-  --title "Release v2.0.0" \
-  --notes "$CHANGELOG" \
-  --target main
-
-# Run release orchestration
-npx ruv-swarm github release-create \
-  --version "2.0.0" \
-  --changelog "$CHANGELOG" \
-  --build-artifacts \
-  --deploy-targets "npm,docker,github"
-
-# Publish release after validation
-gh release edit v2.0.0 --draft=false
-
-# Create announcement issue
-gh issue create \
-  --title "🎉 Released v2.0.0" \
-  --body "$CHANGELOG" \
-  --label "announcement,release"
-```
-
-## Release Configuration
-
-### Release Config File
-```yaml
-# .github/release-swarm.yml
-version: 1
-release:
-  versioning:
-    strategy: semantic
-    breaking-keywords: ["BREAKING", "!"]
-    
-  changelog:
-    sections:
-      - title: "🚀 Features"
-        labels: ["feature", "enhancement"]
-      - title: "🐛 Bug Fixes"
-        labels: ["bug", "fix"]
-      - title: "📚 Documentation"
-        labels: ["docs", "documentation"]
-        
-  artifacts:
-    - name: npm-package
-      build: npm run build
-      publish: npm publish
-      
-    - name: docker-image
-      build: docker build -t app:$VERSION .
-      publish: docker push app:$VERSION
-      
-    - name: binaries
-      build: ./scripts/build-binaries.sh
-      upload: github-release
-      
-  deployment:
-    environments:
-      - name: staging
-        auto-deploy: true
-        validation: npm run test:e2e
-        
-      - name: production
-        approval-required: true
-        rollback-enabled: true
-        
-  notifications:
-    - slack: releases-channel
-    - email: stakeholders@company.com
-    - discord: webhook-url
-```
-
-## Release Agents
-
-### Changelog Agent
-```bash
-# Generate intelligent changelog with gh CLI
-# Get all merged PRs between versions
-PRS=$(gh pr list --state merged --base main --json number,title,labels,author,mergedAt \
-  --jq ".[] | select(.mergedAt > \"$(gh release view v1.0.0 --json publishedAt -q .publishedAt)\")")  
-
-# Get contributors
-CONTRIBUTORS=$(echo "$PRS" | jq -r '[.author.login] | unique | join(", ")')
-
-# Get commit messages
-COMMITS=$(gh api repos/:owner/:repo/compare/v1.0.0...HEAD \
-  --jq '.commits[].commit.message')
-
-# Generate categorized changelog
-CHANGELOG=$(npx ruv-swarm github changelog \
-  --prs "$PRS" \
-  --commits "$COMMITS" \
-  --contributors "$CONTRIBUTORS" \
-  --from v1.0.0 \
-  --to HEAD \
-  --categorize \
-  --add-migration-guide)
-
-# Save changelog
-echo "$CHANGELOG" > CHANGELOG.md
-
-# Create PR with changelog update
-gh pr create \
-  --title "docs: Update changelog for v2.0.0" \
-  --body "Automated changelog update" \
-  --base main
-```
-
-**Capabilities:**
-- Semantic commit analysis
-- Breaking change detection
-- Contributor attribution
-- Migration guide generation
-- Multi-language support
-
-### Version Agent
-```bash
-# Determine next version
-npx ruv-swarm github version-suggest \
-  --current v1.2.3 \
-  --analyze-commits \
-  --check-compatibility \
-  --suggest-pre-release
-```
-
-**Logic:**
-- Analyzes commit messages
-- Detects breaking changes
-- Suggests appropriate bump
-- Handles pre-releases
-- Validates version constraints
-
-### Build Agent
-```bash
-# Coordinate multi-platform builds
-npx ruv-swarm github release-build \
-  --platforms "linux,macos,windows" \
-  --architectures "x64,arm64" \
-  --parallel \
-  --optimize-size
-```
-
-**Features:**
-- Cross-platform compilation
-- Parallel build execution
-- Artifact optimization
-- Dependency bundling
-- Build caching
-
-### Test Agent
-```bash
-# Pre-release testing
-npx ruv-swarm github release-test \
-  --suites "unit,integration,e2e,performance" \
-  --environments "node:16,node:18,node:20" \
-  --fail-fast false \
-  --generate-report
-```
-
-### Deploy Agent
-```bash
-# Multi-target deployment
-npx ruv-swarm github release-deploy \
-  --targets "npm,docker,github,s3" \
-  --staged-rollout \
-  --monitor-metrics \
-  --auto-rollback
-```
-
-## Advanced Features
-
-### 1. Progressive Deployment
-```yaml
-# Staged rollout configuration
-deployment:
-  strategy: progressive
-  stages:
-    - name: canary
-      percentage: 5
-      duration: 1h
-      metrics:
-        - error-rate < 0.1%
-        - latency-p99 < 200ms
-        
-    - name: partial
-      percentage: 25
-      duration: 4h
-      validation: automated-tests
-      
-    - name: full
-      percentage: 100
-      approval: required
-```
-
-### 2. Multi-Repo Releases
-```bash
-# Coordinate releases across repos
-npx ruv-swarm github multi-release \
-  --repos "frontend:v2.0.0,backend:v2.1.0,cli:v1.5.0" \
-  --ensure-compatibility \
-  --atomic-release \
-  --synchronized
-```
-
-### 3. Hotfix Automation
-```bash
-# Emergency hotfix process
-npx ruv-swarm github hotfix \
-  --issue 789 \
-  --target-version v1.2.4 \
-  --cherry-pick-commits \
-  --fast-track-deploy
-```
-
-## Release Workflows
-
-### Standard Release Flow
-```yaml
-# .github/workflows/release.yml
-name: Release Workflow
-on:
-  push:
-    tags: ['v*']
-
-jobs:
-  release-swarm:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          
-      - name: Setup GitHub CLI
-        run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
-          
-      - name: Initialize Release Swarm
-        run: |
-          # Get release tag and previous tag
-          RELEASE_TAG=${{ github.ref_name }}
-          PREV_TAG=$(gh release list --limit 2 --json tagName -q '.[1].tagName')
-          
-          # Get PRs and commits for changelog
-          PRS=$(gh pr list --state merged --base main --json number,title,labels,author \
-            --search "merged:>=$(gh release view $PREV_TAG --json publishedAt -q .publishedAt)")
-          
-          npx ruv-swarm github release-init \
-            --tag $RELEASE_TAG \
-            --previous-tag $PREV_TAG \
-            --prs "$PRS" \
-            --spawn-agents "changelog,version,build,test,deploy"
-            
-      - name: Generate Release Assets
-        run: |
-          # Generate changelog from PR data
-          CHANGELOG=$(npx ruv-swarm github release-changelog \
-            --format markdown)
-          
-          # Update release notes
-          gh release edit ${{ github.ref_name }} \
-            --notes "$CHANGELOG"
-          
-          # Generate and upload assets
-          npx ruv-swarm github release-assets \
-            --changelog \
-            --binaries \
-            --documentation
-            
-      - name: Upload Release Assets
-        run: |
-          # Upload generated assets to GitHub release
-          for file in dist/*; do
-            gh release upload ${{ github.ref_name }} "$file"
-          done
-          
-      - name: Publish Release
-        run: |
-          # Publish to package registries
-          npx ruv-swarm github release-publish \
-            --platforms all
-          
-          # Create announcement issue
-          gh issue create \
-            --title "🚀 Released ${{ github.ref_name }}" \
-            --body "See [release notes](https://github.com/${{ github.repository }}/releases/tag/${{ github.ref_name }})" \
-            --label "announcement"
-```
-
-### Continuous Deployment
-```bash
-# Automated deployment pipeline
-npx ruv-swarm github cd-pipeline \
-  --trigger "merge-to-main" \
-  --auto-version \
-  --deploy-on-success \
-  --rollback-on-failure
-```
-
-## Release Validation
-
-### Pre-Release Checks
-```bash
-# Comprehensive validation
-npx ruv-swarm github release-validate \
-  --checks "
-    version-conflicts,
-    dependency-compatibility,
-    api-breaking-changes,
-    security-vulnerabilities,
-    performance-regression,
-    documentation-completeness
-  " \
-  --block-on-failure
-```
-
-### Compatibility Testing
-```bash
-# Test backward compatibility
-npx ruv-swarm github compat-test \
-  --previous-versions "v1.0,v1.1,v1.2" \
-  --api-contracts \
-  --data-migrations \
-  --generate-report
-```
-
-### Security Scanning
-```bash
-# Security validation
-npx ruv-swarm github release-security \
-  --scan-dependencies \
-  --check-secrets \
-  --audit-permissions \
-  --sign-artifacts
-```
-
-## Monitoring & Rollback
-
-### Release Monitoring
-```bash
-# Monitor release health
-npx ruv-swarm github release-monitor \
-  --version v2.0.0 \
-  --metrics "error-rate,latency,throughput" \
-  --alert-thresholds \
-  --duration 24h
-```
-
-### Automated Rollback
-```bash
-# Configure auto-rollback
-npx ruv-swarm github rollback-config \
-  --triggers '{
-    "error-rate": ">5%",
-    "latency-p99": ">1000ms",
-    "availability": "<99.9%"
-  }' \
-  --grace-period 5m \
-  --notify-on-rollback
-```
-
-### Release Analytics
-```bash
-# Analyze release performance
-npx ruv-swarm github release-analytics \
-  --version v2.0.0 \
-  --compare-with v1.9.0 \
-  --metrics "adoption,performance,stability" \
-  --generate-insights
-```
-
-## Documentation
-
-### Auto-Generated Docs
-```bash
-# Update documentation
-npx ruv-swarm github release-docs \
-  --api-changes \
-  --migration-guide \
-  --example-updates \
-  --publish-to "docs-site,wiki"
-```
-
-### Release Notes
-```markdown
-<!-- Auto-generated release notes template -->
-# Release v2.0.0
-
-## 🎉 Highlights
-- Major feature X with 50% performance improvement
-- New API endpoints for feature Y
-- Enhanced security with feature Z
-
-## 🚀 Features
-### Feature Name (#PR)
-Detailed description of the feature...
-
-## 🐛 Bug Fixes
-### Fixed issue with... (#PR)
-Description of the fix...
-
-## 💥 Breaking Changes
-### API endpoint renamed
-- Before: `/api/old-endpoint`
-- After: `/api/new-endpoint`
-- Migration: Update all client calls...
-
-## 📈 Performance Improvements
-- Reduced memory usage by 30%
-- API response time improved by 200ms
-
-## 🔒 Security Updates
-- Updated dependencies to patch CVE-XXXX
-- Enhanced authentication mechanism
-
-## 📚 Documentation
-- Added examples for new features
-- Updated API reference
-- New troubleshooting guide
-
-## 🙏 Contributors
-Thanks to all contributors who made this release possible!
-```
-
-## Best Practices
-
-### 1. Release Planning
-- Regular release cycles
-- Feature freeze periods
-- Beta testing phases
-- Clear communication
-
-### 2. Automation
-- Comprehensive CI/CD
-- Automated testing
-- Progressive rollouts
-- Monitoring and alerts
-
-### 3. Documentation
-- Up-to-date changelogs
-- Migration guides
-- API documentation
-- Example updates
-
-## Integration Examples
-
-### NPM Package Release
-```bash
-# NPM package release
-npx ruv-swarm github npm-release \
-  --version patch \
-  --test-all \
-  --publish-beta \
-  --tag-latest-on-success
-```
-
-### Docker Image Release
-```bash
-# Docker multi-arch release
-npx ruv-swarm github docker-release \
-  --platforms "linux/amd64,linux/arm64" \
-  --tags "latest,v2.0.0,stable" \
-  --scan-vulnerabilities \
-  --push-to "dockerhub,gcr,ecr"
-```
-
-### Mobile App Release
-```bash
-# Mobile app store release
-npx ruv-swarm github mobile-release \
-  --platforms "ios,android" \
-  --build-release \
-  --submit-review \
-  --staged-rollout
-```
-
-## Emergency Procedures
-
-### Hotfix Process
-```bash
-# Emergency hotfix
-npx ruv-swarm github emergency-release \
-  --severity critical \
-  --bypass-checks security-only \
-  --fast-track \
-  --notify-all
-```
-
-### Rollback Procedure
-```bash
-# Immediate rollback
-npx ruv-swarm github rollback \
-  --to-version v1.9.9 \
-  --reason "Critical bug in v2.0.0" \
-  --preserve-data \
-  --notify-users
-```
-
+---
+name: release-swarm
+description: |
+  Orchestrate complex software releases using AI swarms that handle everything from changelog generation to multi-platform deployment
+tools: Bash, Read, Write, Edit, TodoWrite, TodoRead, Task, mcp__github__create_pull_request, mcp__github__merge_pull_request, mcp__github__create_branch, mcp__github__push_files, mcp__github__create_issue, mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, mcp__claude-flow__parallel_execute, mcp__claude-flow__load_balance
+---
+
+# Release Swarm - Intelligent Release Automation
+
+## Overview
+Orchestrate complex software releases using AI swarms that handle everything from changelog generation to multi-platform deployment.
+
+## Core Features
+
+### 1. Release Planning
+```bash
+# Plan next release using gh CLI
+# Get commit history since last release
+LAST_TAG=$(gh release list --limit 1 --json tagName -q '.[0].tagName')
+COMMITS=$(gh api repos/:owner/:repo/compare/${LAST_TAG}...HEAD --jq '.commits')
+
+# Get merged PRs
+MERGED_PRS=$(gh pr list --state merged --base main --json number,title,labels,mergedAt \
+  --jq ".[] | select(.mergedAt > \"$(gh release view $LAST_TAG --json publishedAt -q .publishedAt)\")")  
+
+# Plan release with commit analysis
+npx ruv-swarm github release-plan \
+  --commits "$COMMITS" \
+  --merged-prs "$MERGED_PRS" \
+  --analyze-commits \
+  --suggest-version \
+  --identify-breaking \
+  --generate-timeline
+```
+
+### 2. Automated Versioning
+```bash
+# Smart version bumping
+npx ruv-swarm github release-version \
+  --strategy "semantic" \
+  --analyze-changes \
+  --check-breaking \
+  --update-files
+```
+
+### 3. Release Orchestration
+```bash
+# Full release automation with gh CLI
+# Generate changelog from PRs and commits
+CHANGELOG=$(gh api repos/:owner/:repo/compare/${LAST_TAG}...HEAD \
+  --jq '.commits[].commit.message' | \
+  npx ruv-swarm github generate-changelog)
+
+# Create release draft
+gh release create v2.0.0 \
+  --draft \
+  --title "Release v2.0.0" \
+  --notes "$CHANGELOG" \
+  --target main
+
+# Run release orchestration
+npx ruv-swarm github release-create \
+  --version "2.0.0" \
+  --changelog "$CHANGELOG" \
+  --build-artifacts \
+  --deploy-targets "npm,docker,github"
+
+# Publish release after validation
+gh release edit v2.0.0 --draft=false
+
+# Create announcement issue
+gh issue create \
+  --title "🎉 Released v2.0.0" \
+  --body "$CHANGELOG" \
+  --label "announcement,release"
+```
+
+## Release Configuration
+
+### Release Config File
+```yaml
+# .github/release-swarm.yml
+version: 1
+release:
+  versioning:
+    strategy: semantic
+    breaking-keywords: ["BREAKING", "!"]
+    
+  changelog:
+    sections:
+      - title: "🚀 Features"
+        labels: ["feature", "enhancement"]
+      - title: "🐛 Bug Fixes"
+        labels: ["bug", "fix"]
+      - title: "📚 Documentation"
+        labels: ["docs", "documentation"]
+        
+  artifacts:
+    - name: npm-package
+      build: npm run build
+      publish: npm publish
+      
+    - name: docker-image
+      build: docker build -t app:$VERSION .
+      publish: docker push app:$VERSION
+      
+    - name: binaries
+      build: ./scripts/build-binaries.sh
+      upload: github-release
+      
+  deployment:
+    environments:
+      - name: staging
+        auto-deploy: true
+        validation: npm run test:e2e
+        
+      - name: production
+        approval-required: true
+        rollback-enabled: true
+        
+  notifications:
+    - slack: releases-channel
+    - email: stakeholders@company.com
+    - discord: webhook-url
+```
+
+## Release Agents
+
+### Changelog Agent
+```bash
+# Generate intelligent changelog with gh CLI
+# Get all merged PRs between versions
+PRS=$(gh pr list --state merged --base main --json number,title,labels,author,mergedAt \
+  --jq ".[] | select(.mergedAt > \"$(gh release view v1.0.0 --json publishedAt -q .publishedAt)\")")  
+
+# Get contributors
+CONTRIBUTORS=$(echo "$PRS" | jq -r '[.author.login] | unique | join(", ")')
+
+# Get commit messages
+COMMITS=$(gh api repos/:owner/:repo/compare/v1.0.0...HEAD \
+  --jq '.commits[].commit.message')
+
+# Generate categorized changelog
+CHANGELOG=$(npx ruv-swarm github changelog \
+  --prs "$PRS" \
+  --commits "$COMMITS" \
+  --contributors "$CONTRIBUTORS" \
+  --from v1.0.0 \
+  --to HEAD \
+  --categorize \
+  --add-migration-guide)
+
+# Save changelog
+echo "$CHANGELOG" > CHANGELOG.md
+
+# Create PR with changelog update
+gh pr create \
+  --title "docs: Update changelog for v2.0.0" \
+  --body "Automated changelog update" \
+  --base main
+```
+
+**Capabilities:**
+- Semantic commit analysis
+- Breaking change detection
+- Contributor attribution
+- Migration guide generation
+- Multi-language support
+
+### Version Agent
+```bash
+# Determine next version
+npx ruv-swarm github version-suggest \
+  --current v1.2.3 \
+  --analyze-commits \
+  --check-compatibility \
+  --suggest-pre-release
+```
+
+**Logic:**
+- Analyzes commit messages
+- Detects breaking changes
+- Suggests appropriate bump
+- Handles pre-releases
+- Validates version constraints
+
+### Build Agent
+```bash
+# Coordinate multi-platform builds
+npx ruv-swarm github release-build \
+  --platforms "linux,macos,windows" \
+  --architectures "x64,arm64" \
+  --parallel \
+  --optimize-size
+```
+
+**Features:**
+- Cross-platform compilation
+- Parallel build execution
+- Artifact optimization
+- Dependency bundling
+- Build caching
+
+### Test Agent
+```bash
+# Pre-release testing
+npx ruv-swarm github release-test \
+  --suites "unit,integration,e2e,performance" \
+  --environments "node:16,node:18,node:20" \
+  --fail-fast false \
+  --generate-report
+```
+
+### Deploy Agent
+```bash
+# Multi-target deployment
+npx ruv-swarm github release-deploy \
+  --targets "npm,docker,github,s3" \
+  --staged-rollout \
+  --monitor-metrics \
+  --auto-rollback
+```
+
+## Advanced Features
+
+### 1. Progressive Deployment
+```yaml
+# Staged rollout configuration
+deployment:
+  strategy: progressive
+  stages:
+    - name: canary
+      percentage: 5
+      duration: 1h
+      metrics:
+        - error-rate < 0.1%
+        - latency-p99 < 200ms
+        
+    - name: partial
+      percentage: 25
+      duration: 4h
+      validation: automated-tests
+      
+    - name: full
+      percentage: 100
+      approval: required
+```
+
+### 2. Multi-Repo Releases
+```bash
+# Coordinate releases across repos
+npx ruv-swarm github multi-release \
+  --repos "frontend:v2.0.0,backend:v2.1.0,cli:v1.5.0" \
+  --ensure-compatibility \
+  --atomic-release \
+  --synchronized
+```
+
+### 3. Hotfix Automation
+```bash
+# Emergency hotfix process
+npx ruv-swarm github hotfix \
+  --issue 789 \
+  --target-version v1.2.4 \
+  --cherry-pick-commits \
+  --fast-track-deploy
+```
+
+## Release Workflows
+
+### Standard Release Flow
+```yaml
+# .github/workflows/release.yml
+name: Release Workflow
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  release-swarm:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          
+      - name: Setup GitHub CLI
+        run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
+          
+      - name: Initialize Release Swarm
+        run: |
+          # Get release tag and previous tag
+          RELEASE_TAG=${{ github.ref_name }}
+          PREV_TAG=$(gh release list --limit 2 --json tagName -q '.[1].tagName')
+          
+          # Get PRs and commits for changelog
+          PRS=$(gh pr list --state merged --base main --json number,title,labels,author \
+            --search "merged:>=$(gh release view $PREV_TAG --json publishedAt -q .publishedAt)")
+          
+          npx ruv-swarm github release-init \
+            --tag $RELEASE_TAG \
+            --previous-tag $PREV_TAG \
+            --prs "$PRS" \
+            --spawn-agents "changelog,version,build,test,deploy"
+            
+      - name: Generate Release Assets
+        run: |
+          # Generate changelog from PR data
+          CHANGELOG=$(npx ruv-swarm github release-changelog \
+            --format markdown)
+          
+          # Update release notes
+          gh release edit ${{ github.ref_name }} \
+            --notes "$CHANGELOG"
+          
+          # Generate and upload assets
+          npx ruv-swarm github release-assets \
+            --changelog \
+            --binaries \
+            --documentation
+            
+      - name: Upload Release Assets
+        run: |
+          # Upload generated assets to GitHub release
+          for file in dist/*; do
+            gh release upload ${{ github.ref_name }} "$file"
+          done
+          
+      - name: Publish Release
+        run: |
+          # Publish to package registries
+          npx ruv-swarm github release-publish \
+            --platforms all
+          
+          # Create announcement issue
+          gh issue create \
+            --title "🚀 Released ${{ github.ref_name }}" \
+            --body "See [release notes](https://github.com/${{ github.repository }}/releases/tag/${{ github.ref_name }})" \
+            --label "announcement"
+```
+
+### Continuous Deployment
+```bash
+# Automated deployment pipeline
+npx ruv-swarm github cd-pipeline \
+  --trigger "merge-to-main" \
+  --auto-version \
+  --deploy-on-success \
+  --rollback-on-failure
+```
+
+## Release Validation
+
+### Pre-Release Checks
+```bash
+# Comprehensive validation
+npx ruv-swarm github release-validate \
+  --checks "
+    version-conflicts,
+    dependency-compatibility,
+    api-breaking-changes,
+    security-vulnerabilities,
+    performance-regression,
+    documentation-completeness
+  " \
+  --block-on-failure
+```
+
+### Compatibility Testing
+```bash
+# Test backward compatibility
+npx ruv-swarm github compat-test \
+  --previous-versions "v1.0,v1.1,v1.2" \
+  --api-contracts \
+  --data-migrations \
+  --generate-report
+```
+
+### Security Scanning
+```bash
+# Security validation
+npx ruv-swarm github release-security \
+  --scan-dependencies \
+  --check-secrets \
+  --audit-permissions \
+  --sign-artifacts
+```
+
+## Monitoring & Rollback
+
+### Release Monitoring
+```bash
+# Monitor release health
+npx ruv-swarm github release-monitor \
+  --version v2.0.0 \
+  --metrics "error-rate,latency,throughput" \
+  --alert-thresholds \
+  --duration 24h
+```
+
+### Automated Rollback
+```bash
+# Configure auto-rollback
+npx ruv-swarm github rollback-config \
+  --triggers '{
+    "error-rate": ">5%",
+    "latency-p99": ">1000ms",
+    "availability": "<99.9%"
+  }' \
+  --grace-period 5m \
+  --notify-on-rollback
+```
+
+### Release Analytics
+```bash
+# Analyze release performance
+npx ruv-swarm github release-analytics \
+  --version v2.0.0 \
+  --compare-with v1.9.0 \
+  --metrics "adoption,performance,stability" \
+  --generate-insights
+```
+
+## Documentation
+
+### Auto-Generated Docs
+```bash
+# Update documentation
+npx ruv-swarm github release-docs \
+  --api-changes \
+  --migration-guide \
+  --example-updates \
+  --publish-to "docs-site,wiki"
+```
+
+### Release Notes
+```markdown
+<!-- Auto-generated release notes template -->
+# Release v2.0.0
+
+## 🎉 Highlights
+- Major feature X with 50% performance improvement
+- New API endpoints for feature Y
+- Enhanced security with feature Z
+
+## 🚀 Features
+### Feature Name (#PR)
+Detailed description of the feature...
+
+## 🐛 Bug Fixes
+### Fixed issue with... (#PR)
+Description of the fix...
+
+## 💥 Breaking Changes
+### API endpoint renamed
+- Before: `/api/old-endpoint`
+- After: `/api/new-endpoint`
+- Migration: Update all client calls...
+
+## 📈 Performance Improvements
+- Reduced memory usage by 30%
+- API response time improved by 200ms
+
+## 🔒 Security Updates
+- Updated dependencies to patch CVE-XXXX
+- Enhanced authentication mechanism
+
+## 📚 Documentation
+- Added examples for new features
+- Updated API reference
+- New troubleshooting guide
+
+## 🙏 Contributors
+Thanks to all contributors who made this release possible!
+```
+
+## Best Practices
+
+### 1. Release Planning
+- Regular release cycles
+- Feature freeze periods
+- Beta testing phases
+- Clear communication
+
+### 2. Automation
+- Comprehensive CI/CD
+- Automated testing
+- Progressive rollouts
+- Monitoring and alerts
+
+### 3. Documentation
+- Up-to-date changelogs
+- Migration guides
+- API documentation
+- Example updates
+
+## Integration Examples
+
+### NPM Package Release
+```bash
+# NPM package release
+npx ruv-swarm github npm-release \
+  --version patch \
+  --test-all \
+  --publish-beta \
+  --tag-latest-on-success
+```
+
+### Docker Image Release
+```bash
+# Docker multi-arch release
+npx ruv-swarm github docker-release \
+  --platforms "linux/amd64,linux/arm64" \
+  --tags "latest,v2.0.0,stable" \
+  --scan-vulnerabilities \
+  --push-to "dockerhub,gcr,ecr"
+```
+
+### Mobile App Release
+```bash
+# Mobile app store release
+npx ruv-swarm github mobile-release \
+  --platforms "ios,android" \
+  --build-release \
+  --submit-review \
+  --staged-rollout
+```
+
+## Emergency Procedures
+
+### Hotfix Process
+```bash
+# Emergency hotfix
+npx ruv-swarm github emergency-release \
+  --severity critical \
+  --bypass-checks security-only \
+  --fast-track \
+  --notify-all
+```
+
+### Rollback Procedure
+```bash
+# Immediate rollback
+npx ruv-swarm github rollback \
+  --to-version v1.9.9 \
+  --reason "Critical bug in v2.0.0" \
+  --preserve-data \
+  --notify-users
+```
+
 See also: [workflow-automation.md](./workflow-automation.md), [multi-repo-swarm.md](./multi-repo-swarm.md)