claude-flow 3.0.0-alpha.16 → 3.0.0-alpha.17

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

@@ -1,538 +0,0 @@
----
-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

@@ -1,173 +0,0 @@
----
-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" }
-```