claude-flow 3.0.0-alpha.4 → 3.0.0-alpha.41

package/.claude/agents/github/code-review-swarm.md

@@ -0,0 +1,538 @@
+---
+name: code-review-swarm
+description: Deploy specialized AI agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis
+tools: mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, Bash, Read, Write, TodoWrite
+color: blue
+type: development
+capabilities:
+  - Automated multi-agent code review
+  - Security vulnerability analysis
+  - Performance bottleneck detection
+  - Architecture pattern validation
+  - Style and convention enforcement
+priority: high
+hooks:
+  pre: |
+    echo "Starting code-review-swarm..."
+    echo "Initializing multi-agent review system"
+    gh auth status || (echo "GitHub CLI not authenticated" && exit 1)
+  post: |
+    echo "Completed code-review-swarm"
+    echo "Review results posted to GitHub"
+    echo "Quality gates evaluated"
+---
+
+# Code Review Swarm - Automated Code Review with AI Agents
+
+## Overview
+Deploy specialized AI agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis.
+
+## Core Features
+
+### 1. Multi-Agent Review System
+```bash
+# Initialize code review swarm with gh CLI
+# Get PR details
+PR_DATA=$(gh pr view 123 --json files,additions,deletions,title,body)
+PR_DIFF=$(gh pr diff 123)
+
+# Initialize swarm with PR context
+npx ruv-swarm github review-init \
+  --pr 123 \
+  --pr-data "$PR_DATA" \
+  --diff "$PR_DIFF" \
+  --agents "security,performance,style,architecture,accessibility" \
+  --depth comprehensive
+
+# Post initial review status
+gh pr comment 123 --body "🔍 Multi-agent code review initiated"
+```
+
+### 2. Specialized Review Agents
+
+#### Security Agent
+```bash
+# Security-focused review with gh CLI
+# Get changed files
+CHANGED_FILES=$(gh pr view 123 --json files --jq '.files[].path')
+
+# Run security review
+SECURITY_RESULTS=$(npx ruv-swarm github review-security \
+  --pr 123 \
+  --files "$CHANGED_FILES" \
+  --check "owasp,cve,secrets,permissions" \
+  --suggest-fixes)
+
+# Post security findings
+if echo "$SECURITY_RESULTS" | grep -q "critical"; then
+  # Request changes for critical issues
+  gh pr review 123 --request-changes --body "$SECURITY_RESULTS"
+  # Add security label
+  gh pr edit 123 --add-label "security-review-required"
+else
+  # Post as comment for non-critical issues
+  gh pr comment 123 --body "$SECURITY_RESULTS"
+fi
+```
+
+#### Performance Agent
+```bash
+# Performance analysis
+npx ruv-swarm github review-performance \
+  --pr 123 \
+  --profile "cpu,memory,io" \
+  --benchmark-against main \
+  --suggest-optimizations
+```
+
+#### Architecture Agent
+```bash
+# Architecture review
+npx ruv-swarm github review-architecture \
+  --pr 123 \
+  --check "patterns,coupling,cohesion,solid" \
+  --visualize-impact \
+  --suggest-refactoring
+```
+
+### 3. Review Configuration
+```yaml
+# .github/review-swarm.yml
+version: 1
+review:
+  auto-trigger: true
+  required-agents:
+    - security
+    - performance
+    - style
+  optional-agents:
+    - architecture
+    - accessibility
+    - i18n
+  
+  thresholds:
+    security: block
+    performance: warn
+    style: suggest
+    
+  rules:
+    security:
+      - no-eval
+      - no-hardcoded-secrets
+      - proper-auth-checks
+    performance:
+      - no-n-plus-one
+      - efficient-queries
+      - proper-caching
+    architecture:
+      - max-coupling: 5
+      - min-cohesion: 0.7
+      - follow-patterns
+```
+
+## Review Agents
+
+### Security Review Agent
+```javascript
+// Security checks performed
+{
+  "checks": [
+    "SQL injection vulnerabilities",
+    "XSS attack vectors",
+    "Authentication bypasses",
+    "Authorization flaws",
+    "Cryptographic weaknesses",
+    "Dependency vulnerabilities",
+    "Secret exposure",
+    "CORS misconfigurations"
+  ],
+  "actions": [
+    "Block PR on critical issues",
+    "Suggest secure alternatives",
+    "Add security test cases",
+    "Update security documentation"
+  ]
+}
+```
+
+### Performance Review Agent
+```javascript
+// Performance analysis
+{
+  "metrics": [
+    "Algorithm complexity",
+    "Database query efficiency",
+    "Memory allocation patterns",
+    "Cache utilization",
+    "Network request optimization",
+    "Bundle size impact",
+    "Render performance"
+  ],
+  "benchmarks": [
+    "Compare with baseline",
+    "Load test simulations",
+    "Memory leak detection",
+    "Bottleneck identification"
+  ]
+}
+```
+
+### Style & Convention Agent
+```javascript
+// Style enforcement
+{
+  "checks": [
+    "Code formatting",
+    "Naming conventions",
+    "Documentation standards",
+    "Comment quality",
+    "Test coverage",
+    "Error handling patterns",
+    "Logging standards"
+  ],
+  "auto-fix": [
+    "Formatting issues",
+    "Import organization",
+    "Trailing whitespace",
+    "Simple naming issues"
+  ]
+}
+```
+
+### Architecture Review Agent
+```javascript
+// Architecture analysis
+{
+  "patterns": [
+    "Design pattern adherence",
+    "SOLID principles",
+    "DRY violations",
+    "Separation of concerns",
+    "Dependency injection",
+    "Layer violations",
+    "Circular dependencies"
+  ],
+  "metrics": [
+    "Coupling metrics",
+    "Cohesion scores",
+    "Complexity measures",
+    "Maintainability index"
+  ]
+}
+```
+
+## Advanced Review Features
+
+### 1. Context-Aware Reviews
+```bash
+# Review with full context
+npx ruv-swarm github review-context \
+  --pr 123 \
+  --load-related-prs \
+  --analyze-impact \
+  --check-breaking-changes
+```
+
+### 2. Learning from History
+```bash
+# Learn from past reviews
+npx ruv-swarm github review-learn \
+  --analyze-past-reviews \
+  --identify-patterns \
+  --improve-suggestions \
+  --reduce-false-positives
+```
+
+### 3. Cross-PR Analysis
+```bash
+# Analyze related PRs together
+npx ruv-swarm github review-batch \
+  --prs "123,124,125" \
+  --check-consistency \
+  --verify-integration \
+  --combined-impact
+```
+
+## Review Automation
+
+### Auto-Review on Push
+```yaml
+# .github/workflows/auto-review.yml
+name: Automated Code Review
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+jobs:
+  swarm-review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          
+      - name: Setup GitHub CLI
+        run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
+          
+      - name: Run Review Swarm
+        run: |
+          # Get PR context with gh CLI
+          PR_NUM=${{ github.event.pull_request.number }}
+          PR_DATA=$(gh pr view $PR_NUM --json files,title,body,labels)
+          
+          # Run swarm review
+          REVIEW_OUTPUT=$(npx ruv-swarm github review-all \
+            --pr $PR_NUM \
+            --pr-data "$PR_DATA" \
+            --agents "security,performance,style,architecture")
+          
+          # Post review results
+          echo "$REVIEW_OUTPUT" | gh pr review $PR_NUM --comment -F -
+          
+          # Update PR status
+          if echo "$REVIEW_OUTPUT" | grep -q "approved"; then
+            gh pr review $PR_NUM --approve
+          elif echo "$REVIEW_OUTPUT" | grep -q "changes-requested"; then
+            gh pr review $PR_NUM --request-changes -b "See review comments above"
+          fi
+```
+
+### Review Triggers
+```javascript
+// Custom review triggers
+{
+  "triggers": {
+    "high-risk-files": {
+      "paths": ["**/auth/**", "**/payment/**"],
+      "agents": ["security", "architecture"],
+      "depth": "comprehensive"
+    },
+    "performance-critical": {
+      "paths": ["**/api/**", "**/database/**"],
+      "agents": ["performance", "database"],
+      "benchmarks": true
+    },
+    "ui-changes": {
+      "paths": ["**/components/**", "**/styles/**"],
+      "agents": ["accessibility", "style", "i18n"],
+      "visual-tests": true
+    }
+  }
+}
+```
+
+## Review Comments
+
+### Intelligent Comment Generation
+```bash
+# Generate contextual review comments with gh CLI
+# Get PR diff with context
+PR_DIFF=$(gh pr diff 123 --color never)
+PR_FILES=$(gh pr view 123 --json files)
+
+# Generate review comments
+COMMENTS=$(npx ruv-swarm github review-comment \
+  --pr 123 \
+  --diff "$PR_DIFF" \
+  --files "$PR_FILES" \
+  --style "constructive" \
+  --include-examples \
+  --suggest-fixes)
+
+# Post comments using gh CLI
+echo "$COMMENTS" | jq -c '.[]' | while read -r comment; do
+  FILE=$(echo "$comment" | jq -r '.path')
+  LINE=$(echo "$comment" | jq -r '.line')
+  BODY=$(echo "$comment" | jq -r '.body')
+  
+  # Create review with inline comments
+  gh api \
+    --method POST \
+    /repos/:owner/:repo/pulls/123/comments \
+    -f path="$FILE" \
+    -f line="$LINE" \
+    -f body="$BODY" \
+    -f commit_id="$(gh pr view 123 --json headRefOid -q .headRefOid)"
+done
+```
+
+### Comment Templates
+```markdown
+<!-- Security Issue Template -->
+🔒 **Security Issue: [Type]**
+
+**Severity**: 🔴 Critical / 🟡 High / 🟢 Low
+
+**Description**: 
+[Clear explanation of the security issue]
+
+**Impact**:
+[Potential consequences if not addressed]
+
+**Suggested Fix**:
+```language
+[Code example of the fix]
+```
+
+**References**:
+- [OWASP Guide](link)
+- [Security Best Practices](link)
+```
+
+### Batch Comment Management
+```bash
+# Manage review comments efficiently
+npx ruv-swarm github review-comments \
+  --pr 123 \
+  --group-by "agent,severity" \
+  --summarize \
+  --resolve-outdated
+```
+
+## Integration with CI/CD
+
+### Status Checks
+```yaml
+# Required status checks
+protection_rules:
+  required_status_checks:
+    contexts:
+      - "review-swarm/security"
+      - "review-swarm/performance"
+      - "review-swarm/architecture"
+```
+
+### Quality Gates
+```bash
+# Define quality gates
+npx ruv-swarm github quality-gates \
+  --define '{
+    "security": {"threshold": "no-critical"},
+    "performance": {"regression": "<5%"},
+    "coverage": {"minimum": "80%"},
+    "architecture": {"complexity": "<10"}
+  }'
+```
+
+### Review Metrics
+```bash
+# Track review effectiveness
+npx ruv-swarm github review-metrics \
+  --period 30d \
+  --metrics "issues-found,false-positives,fix-rate" \
+  --export-dashboard
+```
+
+## Best Practices
+
+### 1. Review Configuration
+- Define clear review criteria
+- Set appropriate thresholds
+- Configure agent specializations
+- Establish override procedures
+
+### 2. Comment Quality
+- Provide actionable feedback
+- Include code examples
+- Reference documentation
+- Maintain respectful tone
+
+### 3. Performance
+- Cache analysis results
+- Incremental reviews for large PRs
+- Parallel agent execution
+- Smart comment batching
+
+## Advanced Features
+
+### 1. AI Learning
+```bash
+# Train on your codebase
+npx ruv-swarm github review-train \
+  --learn-patterns \
+  --adapt-to-style \
+  --improve-accuracy
+```
+
+### 2. Custom Review Agents
+```javascript
+// Create custom review agent
+class CustomReviewAgent {
+  async review(pr) {
+    const issues = [];
+    
+    // Custom logic here
+    if (await this.checkCustomRule(pr)) {
+      issues.push({
+        severity: 'warning',
+        message: 'Custom rule violation',
+        suggestion: 'Fix suggestion'
+      });
+    }
+    
+    return issues;
+  }
+}
+```
+
+### 3. Review Orchestration
+```bash
+# Orchestrate complex reviews
+npx ruv-swarm github review-orchestrate \
+  --strategy "risk-based" \
+  --allocate-time-budget \
+  --prioritize-critical
+```
+
+## Examples
+
+### Security-Critical PR
+```bash
+# Auth system changes
+npx ruv-swarm github review-init \
+  --pr 456 \
+  --agents "security,authentication,audit" \
+  --depth "maximum" \
+  --require-security-approval
+```
+
+### Performance-Sensitive PR
+```bash
+# Database optimization
+npx ruv-swarm github review-init \
+  --pr 789 \
+  --agents "performance,database,caching" \
+  --benchmark \
+  --profile
+```
+
+### UI Component PR
+```bash
+# New component library
+npx ruv-swarm github review-init \
+  --pr 321 \
+  --agents "accessibility,style,i18n,docs" \
+  --visual-regression \
+  --component-tests
+```
+
+## Monitoring & Analytics
+
+### Review Dashboard
+```bash
+# Launch review dashboard
+npx ruv-swarm github review-dashboard \
+  --real-time \
+  --show "agent-activity,issue-trends,fix-rates"
+```
+
+### Review Reports
+```bash
+# Generate review reports
+npx ruv-swarm github review-report \
+  --format "markdown" \
+  --include "summary,details,trends" \
+  --email-stakeholders
+```
+
+See also: [swarm-pr.md](./swarm-pr.md), [workflow-automation.md](./workflow-automation.md)

package/.claude/agents/github/github-modes.md

@@ -0,0 +1,173 @@
+---
+name: github-modes
+description: Comprehensive GitHub integration modes for workflow orchestration, PR management, and repository coordination with batch optimization
+tools: mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, Bash, TodoWrite, Read, Write
+color: purple
+type: development
+capabilities:
+  - GitHub workflow orchestration
+  - Pull request management and review
+  - Issue tracking and coordination
+  - Release management and deployment
+  - Repository architecture and organization
+  - CI/CD pipeline coordination
+priority: medium
+hooks:
+  pre: |
+    echo "Starting github-modes..."
+    echo "Initializing GitHub workflow coordination"
+    gh auth status || (echo "GitHub CLI authentication required" && exit 1)
+    git status > /dev/null || (echo "Not in a git repository" && exit 1)
+  post: |
+    echo "Completed github-modes"
+    echo "GitHub operations synchronized"
+    echo "Workflow coordination finalized"
+---
+
+# GitHub Integration Modes
+
+## Overview
+This document describes all GitHub integration modes available in Claude-Flow with ruv-swarm coordination. Each mode is optimized for specific GitHub workflows and includes batch tool integration for maximum efficiency.
+
+## GitHub Workflow Modes
+
+### gh-coordinator
+**GitHub workflow orchestration and coordination**
+- **Coordination Mode**: Hierarchical
+- **Max Parallel Operations**: 10
+- **Batch Optimized**: Yes
+- **Tools**: gh CLI commands, TodoWrite, TodoRead, Task, Memory, Bash
+- **Usage**: `/github gh-coordinator <GitHub workflow description>`
+- **Best For**: Complex GitHub workflows, multi-repo coordination
+
+### pr-manager
+**Pull request management and review coordination**
+- **Review Mode**: Automated
+- **Multi-reviewer**: Yes
+- **Conflict Resolution**: Intelligent
+- **Tools**: gh pr create, gh pr view, gh pr review, gh pr merge, TodoWrite, Task
+- **Usage**: `/github pr-manager <PR management task>`
+- **Best For**: PR reviews, merge coordination, conflict resolution
+
+### issue-tracker
+**Issue management and project coordination**
+- **Issue Workflow**: Automated
+- **Label Management**: Smart
+- **Progress Tracking**: Real-time
+- **Tools**: gh issue create, gh issue edit, gh issue comment, gh issue list, TodoWrite
+- **Usage**: `/github issue-tracker <issue management task>`
+- **Best For**: Project management, issue coordination, progress tracking
+
+### release-manager
+**Release coordination and deployment**
+- **Release Pipeline**: Automated
+- **Versioning**: Semantic
+- **Deployment**: Multi-stage
+- **Tools**: gh pr create, gh pr merge, gh release create, Bash, TodoWrite
+- **Usage**: `/github release-manager <release task>`
+- **Best For**: Release management, version coordination, deployment pipelines
+
+## Repository Management Modes
+
+### repo-architect
+**Repository structure and organization**
+- **Structure Optimization**: Yes
+- **Multi-repo**: Support
+- **Template Management**: Advanced
+- **Tools**: gh repo create, gh repo clone, git commands, Write, Read, Bash
+- **Usage**: `/github repo-architect <repository management task>`
+- **Best For**: Repository setup, structure optimization, multi-repo management
+
+### code-reviewer
+**Automated code review and quality assurance**
+- **Review Quality**: Deep
+- **Security Analysis**: Yes
+- **Performance Check**: Automated
+- **Tools**: gh pr view --json files, gh pr review, gh pr comment, Read, Write
+- **Usage**: `/github code-reviewer <review task>`
+- **Best For**: Code quality, security reviews, performance analysis
+
+### branch-manager
+**Branch management and workflow coordination**
+- **Branch Strategy**: GitFlow
+- **Merge Strategy**: Intelligent
+- **Conflict Prevention**: Proactive
+- **Tools**: gh api (for branch operations), git commands, Bash
+- **Usage**: `/github branch-manager <branch management task>`
+- **Best For**: Branch coordination, merge strategies, workflow management
+
+## Integration Commands
+
+### sync-coordinator
+**Multi-package synchronization**
+- **Package Sync**: Intelligent
+- **Version Alignment**: Automatic
+- **Dependency Resolution**: Advanced
+- **Tools**: git commands, gh pr create, Read, Write, Bash
+- **Usage**: `/github sync-coordinator <sync task>`
+- **Best For**: Package synchronization, version management, dependency updates
+
+### ci-orchestrator
+**CI/CD pipeline coordination**
+- **Pipeline Management**: Advanced
+- **Test Coordination**: Parallel
+- **Deployment**: Automated
+- **Tools**: gh pr checks, gh workflow list, gh run list, Bash, TodoWrite, Task
+- **Usage**: `/github ci-orchestrator <CI/CD task>`
+- **Best For**: CI/CD coordination, test management, deployment automation
+
+### security-guardian
+**Security and compliance management**
+- **Security Scan**: Automated
+- **Compliance Check**: Continuous
+- **Vulnerability Management**: Proactive
+- **Tools**: gh search code, gh issue create, gh secret list, Read, Write
+- **Usage**: `/github security-guardian <security task>`
+- **Best For**: Security audits, compliance checks, vulnerability management
+
+## Usage Examples
+
+### Creating a coordinated pull request workflow:
+```bash
+/github pr-manager "Review and merge feature/new-integration branch with automated testing and multi-reviewer coordination"
+```
+
+### Managing repository synchronization:
+```bash
+/github sync-coordinator "Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies"
+```
+
+### Setting up automated issue tracking:
+```bash
+/github issue-tracker "Create and manage integration issues with automated progress tracking and swarm coordination"
+```
+
+## Batch Operations
+
+All GitHub modes support batch operations for maximum efficiency:
+
+### Parallel GitHub Operations Example:
+```javascript
+[Single Message with BatchTool]:
+  Bash("gh issue create --title 'Feature A' --body '...'")
+  Bash("gh issue create --title 'Feature B' --body '...'")
+  Bash("gh pr create --title 'PR 1' --head 'feature-a' --base 'main'")
+  Bash("gh pr create --title 'PR 2' --head 'feature-b' --base 'main'")
+  TodoWrite { todos: [todo1, todo2, todo3] }
+  Bash("git checkout main && git pull")
+```
+
+## Integration with ruv-swarm
+
+All GitHub modes can be enhanced with ruv-swarm coordination:
+
+```javascript
+// Initialize swarm for GitHub workflow
+mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }
+mcp__claude-flow__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
+mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
+mcp__claude-flow__agent_spawn { type: "tester", name: "QA Agent" }
+
+// Execute GitHub workflow with coordination
+mcp__claude-flow__task_orchestrate { task: "GitHub workflow", strategy: "parallel" }
+```