@swarmdo/cli 1.4.8

package/.claude/skills/sdo-github-release-management/SKILL.md

@@ -0,0 +1,1064 @@
+---
+name: sdo-github-release-management
+description: |
+  Comprehensive GitHub release orchestration with AI swarm coordination for automated versioning, testing, deployment, and rollback management
+---
+
+# GitHub Release Management Skill
+
+Intelligent release automation and orchestration using AI swarms for comprehensive software releases - from changelog generation to multi-platform deployment with rollback capabilities.
+
+## Quick Start
+
+### Simple Release Flow
+```bash
+# Plan and create a release
+gh release create v2.0.0 \
+  --draft \
+  --generate-notes \
+  --title "Release v2.0.0"
+
+# Orchestrate with swarm
+npx swarmdo github release-create \
+  --version "2.0.0" \
+  --build-artifacts \
+  --deploy-targets "npm,docker,github"
+```
+
+### Full Automated Release
+```bash
+# Initialize release swarm
+npx swarmdo swarm init --topology hierarchical
+
+# Execute complete release pipeline
+npx swarmdo sparc pipeline "Release v2.0.0 with full validation"
+```
+
+---
+
+## Core Capabilities
+
+### 1. Release Planning & Version Management
+- Semantic version analysis and suggestion
+- Breaking change detection from commits
+- Release timeline generation
+- Multi-package version coordination
+
+### 2. Automated Testing & Validation
+- Multi-stage test orchestration
+- Cross-platform compatibility testing
+- Performance regression detection
+- Security vulnerability scanning
+
+### 3. Build & Deployment Orchestration
+- Multi-platform build coordination
+- Parallel artifact generation
+- Progressive deployment strategies
+- Automated rollback mechanisms
+
+### 4. Documentation & Communication
+- Automated changelog generation
+- Release notes with categorization
+- Migration guide creation
+- Stakeholder notification
+
+---
+
+## Progressive Disclosure: Level 1 - Basic Usage
+
+### Essential Release Commands
+
+#### Create Release Draft
+```bash
+# Get last release tag
+LAST_TAG=$(gh release list --limit 1 --json tagName -q '.[0].tagName')
+
+# Generate changelog from commits
+CHANGELOG=$(gh api repos/:owner/:repo/compare/${LAST_TAG}...HEAD \
+  --jq '.commits[].commit.message')
+
+# Create draft release
+gh release create v2.0.0 \
+  --draft \
+  --title "Release v2.0.0" \
+  --notes "$CHANGELOG" \
+  --target main
+```
+
+#### Basic Version Bump
+```bash
+# Update package.json version
+npm version patch  # or minor, major
+
+# Push version tag
+git push --follow-tags
+```
+
+#### Simple Deployment
+```bash
+# Build and publish npm package
+npm run build
+npm publish
+
+# Create GitHub release
+gh release create $(npm pkg get version) \
+  --generate-notes
+```
+
+### Quick Integration Example
+```javascript
+// Simple release preparation in Claude Code
+[Single Message]:
+  // Update version files
+  Edit("package.json", { old: '"version": "1.0.0"', new: '"version": "2.0.0"' })
+
+  // Generate changelog
+  Bash("gh api repos/:owner/:repo/compare/v1.0.0...HEAD --jq '.commits[].commit.message' > CHANGELOG.md")
+
+  // Create release branch
+  Bash("git checkout -b release/v2.0.0")
+  Bash("git add -A && git commit -m 'release: Prepare v2.0.0'")
+
+  // Create PR
+  Bash("gh pr create --title 'Release v2.0.0' --body 'Automated release preparation'")
+```
+
+---
+
+## Progressive Disclosure: Level 2 - Swarm Coordination
+
+### AI Swarm Release Orchestration
+
+#### Initialize Release Swarm
+```javascript
+// Set up coordinated release team
+[Single Message - Swarm Initialization]:
+  mcp__swarmdo__swarm_init {
+    topology: "hierarchical",
+    maxAgents: 6,
+    strategy: "balanced"
+  }
+
+  // Spawn specialized agents
+  mcp__swarmdo__agent_spawn { type: "coordinator", name: "Release Director" }
+  mcp__swarmdo__agent_spawn { type: "coder", name: "Version Manager" }
+  mcp__swarmdo__agent_spawn { type: "tester", name: "QA Engineer" }
+  mcp__swarmdo__agent_spawn { type: "reviewer", name: "Release Reviewer" }
+  mcp__swarmdo__agent_spawn { type: "analyst", name: "Deployment Analyst" }
+  mcp__swarmdo__agent_spawn { type: "researcher", name: "Compatibility Checker" }
+```
+
+#### Coordinated Release Workflow
+```javascript
+[Single Message - Full Release Coordination]:
+  // Create release branch
+  Bash("gh api repos/:owner/:repo/git/refs --method POST -f ref='refs/heads/release/v2.0.0' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')")
+
+  // Orchestrate release preparation
+  mcp__swarmdo__task_orchestrate {
+    task: "Prepare release v2.0.0 with comprehensive testing and validation",
+    strategy: "sequential",
+    priority: "critical",
+    maxAgents: 6
+  }
+
+  // Update all release files
+  Write("package.json", "[updated version]")
+  Write("CHANGELOG.md", "[release changelog]")
+  Write("RELEASE_NOTES.md", "[detailed notes]")
+
+  // Run comprehensive validation
+  Bash("npm install && npm test && npm run lint && npm run build")
+
+  // Create release PR
+  Bash(`gh pr create \
+    --title "Release v2.0.0: Feature Set and Improvements" \
+    --head "release/v2.0.0" \
+    --base "main" \
+    --body "$(cat RELEASE_NOTES.md)"`)
+
+  // Track progress
+  TodoWrite { todos: [
+    { content: "Prepare release branch", status: "completed", priority: "critical" },
+    { content: "Run validation suite", status: "completed", priority: "high" },
+    { content: "Create release PR", status: "completed", priority: "high" },
+    { content: "Code review approval", status: "pending", priority: "high" },
+    { content: "Merge and deploy", status: "pending", priority: "critical" }
+  ]}
+
+  // Store release state
+  mcp__swarmdo__memory_usage {
+    action: "store",
+    key: "release/v2.0.0/status",
+    value: JSON.stringify({
+      version: "2.0.0",
+      stage: "validation_complete",
+      timestamp: Date.now(),
+      ready_for_review: true
+    })
+  }
+```
+
+### Release Agent Specializations
+
+#### Changelog Agent
+```bash
+# Get 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 commit history
+COMMITS=$(gh api repos/:owner/:repo/compare/v1.0.0...HEAD \
+  --jq '.commits[].commit.message')
+
+# Generate categorized changelog
+npx swarmdo github changelog \
+  --prs "$PRS" \
+  --commits "$COMMITS" \
+  --from v1.0.0 \
+  --to HEAD \
+  --categorize \
+  --add-migration-guide
+```
+
+**Capabilities:**
+- Semantic commit analysis
+- Breaking change detection
+- Contributor attribution
+- Migration guide generation
+- Multi-language support
+
+#### Version Agent
+```bash
+# Intelligent version suggestion
+npx swarmdo github version-suggest \
+  --current v1.2.3 \
+  --analyze-commits \
+  --check-compatibility \
+  --suggest-pre-release
+```
+
+**Logic:**
+- Analyzes commit messages and PR labels
+- Detects breaking changes via keywords
+- Suggests appropriate version bump
+- Handles pre-release versioning
+- Validates version constraints
+
+#### Build Agent
+```bash
+# Multi-platform build coordination
+npx swarmdo github release-build \
+  --platforms "linux,macos,windows" \
+  --architectures "x64,arm64" \
+  --parallel \
+  --optimize-size
+```
+
+**Features:**
+- Cross-platform compilation
+- Parallel build execution
+- Artifact optimization and compression
+- Dependency bundling
+- Build caching and reuse
+
+#### Test Agent
+```bash
+# Comprehensive pre-release testing
+npx swarmdo 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 orchestration
+npx swarmdo github release-deploy \
+  --targets "npm,docker,github,s3" \
+  --staged-rollout \
+  --monitor-metrics \
+  --auto-rollback
+```
+
+---
+
+## Progressive Disclosure: Level 3 - Advanced Workflows
+
+### Multi-Package Release Coordination
+
+#### Monorepo Release Strategy
+```javascript
+[Single Message - Multi-Package Release]:
+  // Initialize mesh topology for cross-package coordination
+  mcp__swarmdo__swarm_init { topology: "mesh", maxAgents: 8 }
+
+  // Spawn package-specific agents
+  Task("Package A Manager", "Coordinate swarmdo package release v1.0.72", "coder")
+  Task("Package B Manager", "Coordinate swarmdo-swarm package release v1.0.12", "coder")
+  Task("Integration Tester", "Validate cross-package compatibility", "tester")
+  Task("Version Coordinator", "Align dependencies and versions", "coordinator")
+
+  // Update all packages simultaneously
+  Write("packages/swarmdo/package.json", "[v1.0.72 content]")
+  Write("packages/swarmdo-swarm/package.json", "[v1.0.12 content]")
+  Write("CHANGELOG.md", "[consolidated changelog]")
+
+  // Run cross-package validation
+  Bash("cd packages/swarmdo && npm install && npm test")
+  Bash("cd packages/swarmdo-swarm && npm install && npm test")
+  Bash("npm run test:integration")
+
+  // Create unified release PR
+  Bash(`gh pr create \
+    --title "Release: swarmdo v1.0.72, swarmdo-swarm v1.0.12" \
+    --body "Multi-package coordinated release with cross-compatibility validation"`)
+```
+
+### Progressive Deployment Strategy
+
+#### Staged Rollout Configuration
+```yaml
+# .github/release-deployment.yml
+deployment:
+  strategy: progressive
+  stages:
+    - name: canary
+      percentage: 5
+      duration: 1h
+      metrics:
+        - error-rate < 0.1%
+        - latency-p99 < 200ms
+      auto-advance: true
+
+    - name: partial
+      percentage: 25
+      duration: 4h
+      validation: automated-tests
+      approval: qa-team
+
+    - name: rollout
+      percentage: 50
+      duration: 8h
+      monitor: true
+
+    - name: full
+      percentage: 100
+      approval: release-manager
+      rollback-enabled: true
+```
+
+#### Execute Staged Deployment
+```bash
+# Deploy with progressive rollout
+npx swarmdo github release-deploy \
+  --version v2.0.0 \
+  --strategy progressive \
+  --config .github/release-deployment.yml \
+  --monitor-metrics \
+  --auto-rollback-on-error
+```
+
+### Multi-Repository Coordination
+
+#### Coordinated Multi-Repo Release
+```bash
+# Synchronize releases across repositories
+npx swarmdo github multi-release \
+  --repos "frontend:v2.0.0,backend:v2.1.0,cli:v1.5.0" \
+  --ensure-compatibility \
+  --atomic-release \
+  --synchronized \
+  --rollback-all-on-failure
+```
+
+#### Cross-Repo Dependency Management
+```javascript
+[Single Message - Cross-Repo Release]:
+  // Initialize star topology for centralized coordination
+  mcp__swarmdo__swarm_init { topology: "star", maxAgents: 6 }
+
+  // Spawn repo-specific coordinators
+  Task("Frontend Release", "Release frontend v2.0.0 with API compatibility", "coordinator")
+  Task("Backend Release", "Release backend v2.1.0 with breaking changes", "coordinator")
+  Task("CLI Release", "Release CLI v1.5.0 with new commands", "coordinator")
+  Task("Compatibility Checker", "Validate cross-repo compatibility", "researcher")
+
+  // Coordinate version updates across repos
+  Bash("gh api repos/org/frontend/dispatches --method POST -f event_type='release' -F client_payload[version]=v2.0.0")
+  Bash("gh api repos/org/backend/dispatches --method POST -f event_type='release' -F client_payload[version]=v2.1.0")
+  Bash("gh api repos/org/cli/dispatches --method POST -f event_type='release' -F client_payload[version]=v1.5.0")
+
+  // Monitor all releases
+  mcp__swarmdo__swarm_monitor { interval: 5, duration: 300 }
+```
+
+### Hotfix Emergency Procedures
+
+#### Emergency Hotfix Workflow
+```bash
+# Fast-track critical bug fix
+npx swarmdo github emergency-release \
+  --issue 789 \
+  --severity critical \
+  --target-version v1.2.4 \
+  --cherry-pick-commits \
+  --bypass-checks security-only \
+  --fast-track \
+  --notify-all
+```
+
+#### Automated Hotfix Process
+```javascript
+[Single Message - Emergency Hotfix]:
+  // Create hotfix branch from last stable release
+  Bash("git checkout -b hotfix/v1.2.4 v1.2.3")
+
+  // Cherry-pick critical fixes
+  Bash("git cherry-pick abc123def")
+
+  // Fast validation
+  Bash("npm run test:critical && npm run build")
+
+  // Create emergency release
+  Bash(`gh release create v1.2.4 \
+    --title "HOTFIX v1.2.4: Critical Security Patch" \
+    --notes "Emergency release addressing CVE-2024-XXXX" \
+    --prerelease=false`)
+
+  // Immediate deployment
+  Bash("npm publish --tag hotfix")
+
+  // Notify stakeholders
+  Bash(`gh issue create \
+    --title "🚨 HOTFIX v1.2.4 Deployed" \
+    --body "Critical security patch deployed. Please update immediately." \
+    --label "critical,security,hotfix"`)
+```
+
+---
+
+## Progressive Disclosure: Level 4 - Enterprise Features
+
+### Release Configuration Management
+
+#### Comprehensive Release Config
+```yaml
+# .github/release-swarm.yml
+version: 2.0.0
+
+release:
+  versioning:
+    strategy: semantic
+    breaking-keywords: ["BREAKING", "BREAKING CHANGE", "!"]
+    feature-keywords: ["feat", "feature"]
+    fix-keywords: ["fix", "bugfix"]
+
+  changelog:
+    sections:
+      - title: "🚀 Features"
+        labels: ["feature", "enhancement"]
+        emoji: true
+      - title: "🐛 Bug Fixes"
+        labels: ["bug", "fix"]
+      - title: "💥 Breaking Changes"
+        labels: ["breaking"]
+        highlight: true
+      - title: "📚 Documentation"
+        labels: ["docs", "documentation"]
+      - title: "⚡ Performance"
+        labels: ["performance", "optimization"]
+      - title: "🔒 Security"
+        labels: ["security"]
+        priority: critical
+
+  artifacts:
+    - name: npm-package
+      build: npm run build
+      test: npm run test:all
+      publish: npm publish
+      registry: https://registry.npmjs.org
+
+    - name: docker-image
+      build: docker build -t app:$VERSION .
+      test: docker run app:$VERSION npm test
+      publish: docker push app:$VERSION
+      platforms: [linux/amd64, linux/arm64]
+
+    - name: binaries
+      build: ./scripts/build-binaries.sh
+      platforms: [linux, macos, windows]
+      architectures: [x64, arm64]
+      upload: github-release
+      sign: true
+
+  validation:
+    pre-release:
+      - lint: npm run lint
+      - typecheck: npm run typecheck
+      - unit-tests: npm run test:unit
+      - integration-tests: npm run test:integration
+      - security-scan: npm audit
+      - license-check: npm run license-check
+
+    post-release:
+      - smoke-tests: npm run test:smoke
+      - deployment-validation: ./scripts/validate-deployment.sh
+      - performance-baseline: npm run benchmark
+
+  deployment:
+    environments:
+      - name: staging
+        auto-deploy: true
+        validation: npm run test:e2e
+        approval: false
+
+      - name: production
+        auto-deploy: false
+        approval-required: true
+        approvers: ["release-manager", "tech-lead"]
+        rollback-enabled: true
+        health-checks:
+          - endpoint: /health
+            expected: 200
+            timeout: 30s
+
+  monitoring:
+    metrics:
+      - error-rate: <1%
+      - latency-p95: <500ms
+      - availability: >99.9%
+      - memory-usage: <80%
+
+    alerts:
+      - type: slack
+        channel: releases
+        on: [deploy, rollback, error]
+      - type: email
+        recipients: ["team@company.com"]
+        on: [critical-error, rollback]
+      - type: pagerduty
+        service: production-releases
+        on: [critical-error]
+
+  rollback:
+    auto-rollback:
+      triggers:
+        - error-rate > 5%
+        - latency-p99 > 2000ms
+        - availability < 99%
+      grace-period: 5m
+
+    manual-rollback:
+      preserve-data: true
+      notify-users: true
+      create-incident: true
+```
+
+### Advanced Testing Strategies
+
+#### Comprehensive Validation Suite
+```bash
+# Pre-release validation with all checks
+npx swarmdo github release-validate \
+  --checks "
+    version-conflicts,
+    dependency-compatibility,
+    api-breaking-changes,
+    security-vulnerabilities,
+    performance-regression,
+    documentation-completeness,
+    license-compliance,
+    backwards-compatibility
+  " \
+  --block-on-failure \
+  --generate-report \
+  --upload-results
+```
+
+#### Backward Compatibility Testing
+```bash
+# Test against previous versions
+npx swarmdo github compat-test \
+  --previous-versions "v1.0,v1.1,v1.2" \
+  --api-contracts \
+  --data-migrations \
+  --integration-tests \
+  --generate-report
+```
+
+#### Performance Regression Detection
+```bash
+# Benchmark against baseline
+npx swarmdo github performance-test \
+  --baseline v1.9.0 \
+  --candidate v2.0.0 \
+  --metrics "throughput,latency,memory,cpu" \
+  --threshold 5% \
+  --fail-on-regression
+```
+
+### Release Monitoring & Analytics
+
+#### Real-Time Release Monitoring
+```bash
+# Monitor release health post-deployment
+npx swarmdo github release-monitor \
+  --version v2.0.0 \
+  --metrics "error-rate,latency,throughput,adoption" \
+  --alert-thresholds \
+  --duration 24h \
+  --export-dashboard
+```
+
+#### Release Analytics & Insights
+```bash
+# Analyze release performance and adoption
+npx swarmdo github release-analytics \
+  --version v2.0.0 \
+  --compare-with v1.9.0 \
+  --metrics "adoption,performance,stability,feedback" \
+  --generate-insights \
+  --export-report
+```
+
+#### Automated Rollback Configuration
+```bash
+# Configure intelligent auto-rollback
+npx swarmdo github rollback-config \
+  --triggers '{
+    "error-rate": ">5%",
+    "latency-p99": ">1000ms",
+    "availability": "<99.9%",
+    "failed-health-checks": ">3"
+  }' \
+  --grace-period 5m \
+  --notify-on-rollback \
+  --preserve-metrics
+```
+
+### Security & Compliance
+
+#### Security Scanning
+```bash
+# Comprehensive security validation
+npx swarmdo github release-security \
+  --scan-dependencies \
+  --check-secrets \
+  --audit-permissions \
+  --sign-artifacts \
+  --sbom-generation \
+  --vulnerability-report
+```
+
+#### Compliance Validation
+```bash
+# Ensure regulatory compliance
+npx swarmdo github release-compliance \
+  --standards "SOC2,GDPR,HIPAA" \
+  --license-audit \
+  --data-governance \
+  --audit-trail \
+  --generate-attestation
+```
+
+---
+
+## GitHub Actions Integration
+
+### Complete Release Workflow
+```yaml
+# .github/workflows/release.yml
+name: Intelligent Release Workflow
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  release-orchestration:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+      issues: write
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Authenticate GitHub CLI
+        run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
+
+      - name: Initialize Release Swarm
+        run: |
+          # Extract version from tag
+          RELEASE_TAG=${{ github.ref_name }}
+          PREV_TAG=$(gh release list --limit 2 --json tagName -q '.[1].tagName')
+
+          # Get merged PRs for changelog
+          PRS=$(gh pr list --state merged --base main --json number,title,labels,author,mergedAt \
+            --jq ".[] | select(.mergedAt > \"$(gh release view $PREV_TAG --json publishedAt -q .publishedAt)\")")
+
+          # Get commit history
+          COMMITS=$(gh api repos/${{ github.repository }}/compare/${PREV_TAG}...HEAD \
+            --jq '.commits[].commit.message')
+
+          # Initialize swarm coordination
+          npx swarmdo@alpha swarm init --topology hierarchical
+
+          # Store release context
+          echo "$PRS" > /tmp/release-prs.json
+          echo "$COMMITS" > /tmp/release-commits.txt
+
+      - name: Generate Release Changelog
+        run: |
+          # Generate intelligent changelog
+          CHANGELOG=$(npx swarmdo@alpha github changelog \
+            --prs "$(cat /tmp/release-prs.json)" \
+            --commits "$(cat /tmp/release-commits.txt)" \
+            --from $PREV_TAG \
+            --to $RELEASE_TAG \
+            --categorize \
+            --add-migration-guide \
+            --format markdown)
+
+          echo "$CHANGELOG" > RELEASE_CHANGELOG.md
+
+      - name: Build Release Artifacts
+        run: |
+          # Install dependencies
+          npm ci
+
+          # Run comprehensive validation
+          npm run lint
+          npm run typecheck
+          npm run test:all
+          npm run build
+
+          # Build platform-specific binaries
+          npx swarmdo@alpha github release-build \
+            --platforms "linux,macos,windows" \
+            --architectures "x64,arm64" \
+            --parallel
+
+      - name: Security Scan
+        run: |
+          # Run security validation
+          npm audit --audit-level=moderate
+
+          npx swarmdo@alpha github release-security \
+            --scan-dependencies \
+            --check-secrets \
+            --sign-artifacts
+
+      - name: Create GitHub Release
+        run: |
+          # Update release with generated changelog
+          gh release edit ${{ github.ref_name }} \
+            --notes "$(cat RELEASE_CHANGELOG.md)" \
+            --draft=false
+
+          # Upload all artifacts
+          for file in dist/*; do
+            gh release upload ${{ github.ref_name }} "$file"
+          done
+
+      - name: Deploy to Package Registries
+        run: |
+          # Publish to npm
+          echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > .npmrc
+          npm publish
+
+          # Build and push Docker images
+          docker build -t ${{ github.repository }}:${{ github.ref_name }} .
+          docker push ${{ github.repository }}:${{ github.ref_name }}
+
+      - name: Post-Release Validation
+        run: |
+          # Run smoke tests
+          npm run test:smoke
+
+          # Validate deployment
+          npx swarmdo@alpha github release-validate \
+            --version ${{ github.ref_name }} \
+            --smoke-tests \
+            --health-checks
+
+      - name: Create Release Announcement
+        run: |
+          # Create announcement issue
+          gh issue create \
+            --title "🎉 Released ${{ github.ref_name }}" \
+            --body "$(cat RELEASE_CHANGELOG.md)" \
+            --label "announcement,release"
+
+          # Notify via discussion
+          gh api repos/${{ github.repository }}/discussions \
+            --method POST \
+            -f title="Release ${{ github.ref_name }} Now Available" \
+            -f body="$(cat RELEASE_CHANGELOG.md)" \
+            -f category_id="$(gh api repos/${{ github.repository }}/discussions/categories --jq '.[] | select(.slug=="announcements") | .id')"
+
+      - name: Monitor Release
+        run: |
+          # Start release monitoring
+          npx swarmdo@alpha github release-monitor \
+            --version ${{ github.ref_name }} \
+            --duration 1h \
+            --alert-on-errors &
+```
+
+### Hotfix Workflow
+```yaml
+# .github/workflows/hotfix.yml
+name: Emergency Hotfix Workflow
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  emergency-hotfix:
+    if: contains(github.event.issue.labels.*.name, 'critical-hotfix')
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Create Hotfix Branch
+        run: |
+          LAST_STABLE=$(gh release list --limit 1 --json tagName -q '.[0].tagName')
+          HOTFIX_VERSION=$(echo $LAST_STABLE | awk -F. '{print $1"."$2"."$3+1}')
+
+          git checkout -b hotfix/$HOTFIX_VERSION $LAST_STABLE
+
+      - name: Fast-Track Testing
+        run: |
+          npm ci
+          npm run test:critical
+          npm run build
+
+      - name: Emergency Release
+        run: |
+          npx swarmdo@alpha github emergency-release \
+            --issue ${{ github.event.issue.number }} \
+            --severity critical \
+            --fast-track \
+            --notify-all
+```
+
+---
+
+## Best Practices & Patterns
+
+### Release Planning Guidelines
+
+#### 1. Regular Release Cadence
+- **Weekly**: Patch releases with bug fixes
+- **Bi-weekly**: Minor releases with features
+- **Quarterly**: Major releases with breaking changes
+- **On-demand**: Hotfixes for critical issues
+
+#### 2. Feature Freeze Strategy
+- Code freeze 3 days before release
+- Only critical bug fixes allowed
+- Beta testing period for major releases
+- Stakeholder communication plan
+
+#### 3. Version Management Rules
+- Strict semantic versioning compliance
+- Breaking changes only in major versions
+- Deprecation warnings one minor version ahead
+- Cross-package version synchronization
+
+### Automation Recommendations
+
+#### 1. Comprehensive CI/CD Pipeline
+- Automated testing at every stage
+- Security scanning before release
+- Performance benchmarking
+- Documentation generation
+
+#### 2. Progressive Deployment
+- Canary releases for early detection
+- Staged rollouts with monitoring
+- Automated health checks
+- Quick rollback mechanisms
+
+#### 3. Monitoring & Observability
+- Real-time error tracking
+- Performance metrics collection
+- User adoption analytics
+- Feedback collection automation
+
+### Documentation Standards
+
+#### 1. Changelog Requirements
+- Categorized changes by type
+- Breaking changes highlighted
+- Migration guides for major versions
+- Contributor attribution
+
+#### 2. Release Notes Content
+- High-level feature summaries
+- Detailed technical changes
+- Upgrade instructions
+- Known issues and limitations
+
+#### 3. API Documentation
+- Automated API doc generation
+- Example code updates
+- Deprecation notices
+- Version compatibility matrix
+
+---
+
+## Troubleshooting & Common Issues
+
+### Issue: Failed Release Build
+```bash
+# Debug build failures
+npx swarmdo@alpha diagnostic-run \
+  --component build \
+  --verbose
+
+# Retry with isolated environment
+docker run --rm -v $(pwd):/app node:20 \
+  bash -c "cd /app && npm ci && npm run build"
+```
+
+### Issue: Test Failures in CI
+```bash
+# Run tests with detailed output
+npm run test -- --verbose --coverage
+
+# Check for environment-specific issues
+npm run test:ci
+
+# Compare local vs CI environment
+npx swarmdo@alpha github compat-test \
+  --environments "local,ci" \
+  --compare
+```
+
+### Issue: Deployment Rollback Needed
+```bash
+# Immediate rollback to previous version
+npx swarmdo@alpha github rollback \
+  --to-version v1.9.9 \
+  --reason "Critical bug in v2.0.0" \
+  --preserve-data \
+  --notify-users
+
+# Investigate rollback cause
+npx swarmdo@alpha github release-analytics \
+  --version v2.0.0 \
+  --identify-issues
+```
+
+### Issue: Version Conflicts
+```bash
+# Check and resolve version conflicts
+npx swarmdo@alpha github release-validate \
+  --checks version-conflicts \
+  --auto-resolve
+
+# Align multi-package versions
+npx swarmdo@alpha github version-sync \
+  --packages "package-a,package-b" \
+  --strategy semantic
+```
+
+---
+
+## Performance Metrics & Benchmarks
+
+### Expected Performance
+- **Release Planning**: < 2 minutes
+- **Build Process**: 3-8 minutes (varies by project)
+- **Test Execution**: 5-15 minutes
+- **Deployment**: 2-5 minutes per target
+- **Complete Pipeline**: 15-30 minutes
+
+### Optimization Tips
+1. **Parallel Execution**: Use swarm coordination for concurrent tasks
+2. **Caching**: Enable build and dependency caching
+3. **Incremental Builds**: Only rebuild changed components
+4. **Test Optimization**: Run critical tests first, full suite in parallel
+
+### Success Metrics
+- **Release Frequency**: Target weekly minor releases
+- **Lead Time**: < 2 hours from commit to production
+- **Failure Rate**: < 2% of releases require rollback
+- **MTTR**: < 30 minutes for critical hotfixes
+
+---
+
+## Related Resources
+
+### Documentation
+- [GitHub CLI Documentation](https://cli.github.com/manual/)
+- [Semantic Versioning Spec](https://semver.org/)
+- [Swarmdo SPARC Guide](../../docs/sparc-methodology.md)
+- [Swarm Coordination Patterns](../../docs/swarm-patterns.md)
+
+### Related Skills
+- **github-pr-management**: PR review and merge automation
+- **github-workflow-automation**: CI/CD workflow orchestration
+- **multi-repo-coordination**: Cross-repository synchronization
+- **deployment-orchestration**: Advanced deployment strategies
+
+### Support & Community
+- Issues: the upstream project (see NOTICE)
+- Discussions: the upstream project (see NOTICE)
+- Documentation: https://swarmdo.dev/docs
+
+---
+
+## Appendix: Release Checklist Template
+
+### Pre-Release Checklist
+- [ ] Version numbers updated across all packages
+- [ ] Changelog generated and reviewed
+- [ ] Breaking changes documented with migration guide
+- [ ] All tests passing (unit, integration, e2e)
+- [ ] Security scan completed with no critical issues
+- [ ] Performance benchmarks within acceptable range
+- [ ] Documentation updated (API docs, README, examples)
+- [ ] Release notes drafted and reviewed
+- [ ] Stakeholders notified of upcoming release
+- [ ] Deployment plan reviewed and approved
+
+### Release Checklist
+- [ ] Release branch created and validated
+- [ ] CI/CD pipeline completed successfully
+- [ ] Artifacts built and verified
+- [ ] GitHub release created with proper notes
+- [ ] Packages published to registries
+- [ ] Docker images pushed to container registry
+- [ ] Deployment to staging successful
+- [ ] Smoke tests passing in staging
+- [ ] Production deployment completed
+- [ ] Health checks passing
+
+### Post-Release Checklist
+- [ ] Release announcement published
+- [ ] Monitoring dashboards reviewed
+- [ ] Error rates within normal range
+- [ ] Performance metrics stable
+- [ ] User feedback collected
+- [ ] Documentation links verified
+- [ ] Release retrospective scheduled
+- [ ] Next release planning initiated
+
+---
+
+**Version**: 2.0.0
+**Last Updated**: 2025-10-19
+**Maintained By**: Swarmdo Team