github-release-management · diff
v2.0.0 to v2.0.0
3 added, 723 removed. Audit A to A.
---
name: github-release-management
version: 2.0.0
description: GitHub release orchestration — automated versioning, testing, deployment, and rollback. Use when cutting a release, tagging a version, drafting release notes, or coordinating a deploy/rollback workflow.
category: github
tags: [release, deployment, versioning, automation, ci-cd, swarm, orchestration]
author: Claude Flow Team
requires:
- gh (GitHub CLI)
- claude-flow
- ruv-swarm (optional for enhanced coordination)
- mcp-github (optional for MCP integration)
dependencies:
- git
- npm or yarn
- node >= 20.0.0
related_skills:
- github-pr-management
- github-issue-tracking
- github-workflow-automation
- multi-repo-coordination
---
# 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 claude-flow github release-create \
--version "2.0.0" \
--build-artifacts \
--deploy-targets "npm,docker,github"
```
### Full Automated Release
```bash
# Initialize release swarm
npx claude-flow swarm init --topology hierarchical
# Execute complete release pipeline
npx claude-flow 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__claude-flow__swarm_init {
- topology: "hierarchical",
- maxAgents: 6,
- strategy: "balanced"
- }
-
- // Spawn specialized agents
- mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Director" }
- mcp__claude-flow__agent_spawn { type: "coder", name: "Version Manager" }
- mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
- mcp__claude-flow__agent_spawn { type: "reviewer", name: "Release Reviewer" }
- mcp__claude-flow__agent_spawn { type: "analyst", name: "Deployment Analyst" }
- mcp__claude-flow__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__claude-flow__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__claude-flow__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 claude-flow 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 claude-flow 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 claude-flow 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 claude-flow 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 claude-flow 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__claude-flow__swarm_init { topology: "mesh", maxAgents: 8 }
-
- // Spawn package-specific agents
- Task("Package A Manager", "Coordinate claude-flow package release v1.0.72", "coder")
- Task("Package B Manager", "Coordinate ruv-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/claude-flow/package.json", "[v1.0.72 content]")
- Write("packages/ruv-swarm/package.json", "[v1.0.12 content]")
- Write("CHANGELOG.md", "[consolidated changelog]")
-
- // Run cross-package validation
- Bash("cd packages/claude-flow && npm install && npm test")
- Bash("cd packages/ruv-swarm && npm install && npm test")
- Bash("npm run test:integration")
-
- // Create unified release PR
- Bash(`gh pr create \
- --title "Release: claude-flow v1.0.72, ruv-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 claude-flow 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 claude-flow 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__claude-flow__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__claude-flow__swarm_monitor { interval: 5, duration: 300 }
- ```
-
- ### Hotfix Emergency Procedures
-
- #### Emergency Hotfix Workflow
- ```bash
- # Fast-track critical bug fix
- npx claude-flow 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 claude-flow 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 claude-flow 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 claude-flow 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 claude-flow 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 claude-flow 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 claude-flow 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 claude-flow github release-security \
- --scan-dependencies \
- --check-secrets \
- --audit-permissions \
- --sign-artifacts \
- --sbom-generation \
- --vulnerability-report
- ```
-
- #### Compliance Validation
- ```bash
- # Ensure regulatory compliance
- npx claude-flow 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@v3
- with:
- fetch-depth: 0
-
- - name: Setup Node.js
- uses: actions/setup-node@v3
- 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 claude-flow@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 claude-flow@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 claude-flow@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 claude-flow@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 claude-flow@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 claude-flow@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}')
+ ## Reference
- git checkout -b hotfix/$HOTFIX_VERSION $LAST_STABLE
- - name: Fast-Track Testing
- run: |
- npm ci
- npm run test:critical
- npm run build
+ The full detail lives in `references/` and loads only when needed:
- - name: Emergency Release
- run: |
- npx claude-flow@alpha github emergency-release \
- --issue ${{ github.event.issue.number }} \
- --severity critical \
- --fast-track \
- --notify-all
- ```
+ - [`references/workflows.md`](references/workflows.md) — swarm coordination, advanced & enterprise workflows, and github actions integration.
---
## 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 claude-flow@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 claude-flow@alpha github compat-test \
--environments "local,ci" \
--compare
```
### Issue: Deployment Rollback Needed
```bash
# Immediate rollback to previous version
npx claude-flow@alpha github rollback \
--to-version v1.9.9 \
--reason "Critical bug in v2.0.0" \
--preserve-data \
--notify-users
# Investigate rollback cause
npx claude-flow@alpha github release-analytics \
--version v2.0.0 \
--identify-issues
```
### Issue: Version Conflicts
```bash
# Check and resolve version conflicts
npx claude-flow@alpha github release-validate \
--checks version-conflicts \
--auto-resolve
# Align multi-package versions
npx claude-flow@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/)
- [Claude Flow 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: https://github.com/ruvnet/claude-flow/issues
- Discussions: https://github.com/ruvnet/claude-flow/discussions
- Documentation: https://claude-flow.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**: Claude Flow Team