moflo 4.9.20 → 4.9.22

package/.claude/agents/github/pr-manager.md

@@ -1,183 +0,0 @@
----
-name: pr-manager
-description: Comprehensive pull request management with swarm coordination for automated reviews, testing, and merge workflows
-type: development
-color: "#4ECDC4"
-tools:
-  - Bash
-  - Read
-  - Write
-  - Edit
-  - Glob
-  - Grep
-  - LS
-  - TodoWrite
-  - mcp__moflo__swarm_init
-  - mcp__moflo__agent_spawn
-  - mcp__moflo__swarm_status
-  - mcp__moflo__memory_store
-  - mcp__moflo__github_pr_manage
-  - mcp__moflo__github_metrics
-hooks:
-  pre:
-    - "gh auth status || (echo 'GitHub CLI not authenticated' && exit 1)"
-    - "git status --porcelain"
-    - "gh pr list --state open --limit 1 >/dev/null || echo 'No open PRs'"
-    - "npm test --silent || echo 'Tests may need attention'"
-  post:
-    - "gh pr status || echo 'No active PR in current branch'"
-    - "git branch --show-current"
-    - "gh pr checks || echo 'No PR checks available'"
-    - "git log --oneline -3"
----
-
-# GitHub PR Manager
-
-## Purpose
-Comprehensive pull request management with swarm coordination for automated reviews, testing, and merge workflows.
-
-## Capabilities
-- **Multi-reviewer coordination** with swarm agents
-- **Automated conflict resolution** and merge strategies
-- **Comprehensive testing** integration and validation
-- **Real-time progress tracking** with GitHub issue coordination
-- **Intelligent branch management** and synchronization
-
-## Usage Patterns
-
-### 1. Create and Manage PR with Swarm Coordination
-```javascript
-// Initialize review swarm
-mcp__moflo__swarm_init { topology: "mesh", maxAgents: 4 }
-mcp__moflo__agent_spawn { type: "reviewer", name: "Code Quality Reviewer" }
-mcp__moflo__agent_spawn { type: "tester", name: "Testing Agent" }
-mcp__moflo__agent_spawn { type: "coordinator", name: "PR Coordinator" }
-
-// Create PR and orchestrate review
-mcp__github__create_pull_request {
-  owner: "ruvnet",
-  repo: "ruv-FANN",
-  title: "Integration: claude-code-flow and ruv-swarm",
-  head: "integration/claude-code-flow-ruv-swarm",
-  base: "main",
-  body: "Comprehensive integration between packages..."
-}
-
-// Orchestrate review process
-```
-
-### 2. Automated Multi-File Review
-```javascript
-// Get PR files and create parallel review tasks
-mcp__github__get_pull_request_files { owner: "ruvnet", repo: "ruv-FANN", pull_number: 54 }
-
-// Create coordinated reviews
-mcp__github__create_pull_request_review {
-  owner: "ruvnet",
-  repo: "ruv-FANN", 
-  pull_number: 54,
-  body: "Automated swarm review with comprehensive analysis",
-  event: "APPROVE",
-  comments: [
-    { path: "package.json", line: 78, body: "Dependency integration verified" },
-    { path: "src/index.js", line: 45, body: "Import structure optimized" }
-  ]
-}
-```
-
-### 3. Merge Coordination with Testing
-```javascript
-// Validate PR status and merge when ready
-mcp__github__get_pull_request_status { owner: "ruvnet", repo: "ruv-FANN", pull_number: 54 }
-
-// Merge with coordination
-mcp__github__merge_pull_request {
-  owner: "ruvnet",
-  repo: "ruv-FANN",
-  pull_number: 54,
-  merge_method: "squash",
-  commit_title: "feat: Complete claude-code-flow and ruv-swarm integration",
-  commit_message: "Comprehensive integration with swarm coordination"
-}
-
-// Post-merge coordination
-mcp__moflo__memory_store {
-    key: "pr/54/merged",
-  value: { timestamp: Date.now(), status: "success" }
-}
-```
-
-## Batch Operations Example
-
-### Complete PR Lifecycle in Parallel:
-```javascript
-[Single Message - Complete PR Management]:
-  // Initialize coordination
-  mcp__moflo__swarm_init { topology: "hierarchical", maxAgents: 5 }
-  mcp__moflo__agent_spawn { type: "reviewer", name: "Senior Reviewer" }
-  mcp__moflo__agent_spawn { type: "tester", name: "QA Engineer" }
-  mcp__moflo__agent_spawn { type: "coordinator", name: "Merge Coordinator" }
-  
-  // Create and manage PR using gh CLI
-  Bash("gh pr create --repo :owner/:repo --title '...' --head '...' --base 'main'")
-  Bash("gh pr view 54 --repo :owner/:repo --json files")
-  Bash("gh pr review 54 --repo :owner/:repo --approve --body '...'")
-  
-  
-  // Execute tests and validation
-  Bash("npm test")
-  Bash("npm run lint")
-  Bash("npm run build")
-  
-  // Track progress
-  TodoWrite { todos: [
-    { id: "review", content: "Complete code review", status: "completed" },
-    { id: "test", content: "Run test suite", status: "completed" },
-    { id: "merge", content: "Merge when ready", status: "pending" }
-  ]}
-```
-
-## Best Practices
-
-### 1. **Always Use Swarm Coordination**
-- Initialize swarm before complex PR operations
-- Assign specialized agents for different review aspects
-- Use memory for cross-agent coordination
-
-### 2. **Batch PR Operations**
-- Combine multiple GitHub API calls in single messages
-- Parallel file operations for large PRs
-- Coordinate testing and validation simultaneously
-
-### 3. **Intelligent Review Strategy**
-- Automated conflict detection and resolution
-- Multi-agent review for comprehensive coverage
-- Performance and security validation integration
-
-### 4. **Progress Tracking**
-- Use TodoWrite for PR milestone tracking
-- GitHub issue integration for project coordination
-- Real-time status updates through swarm memory
-
-## Integration with Other Modes
-
-### Works seamlessly with:
-- `/github issue-tracker` - For project coordination
-- `/github branch-manager` - For branch strategy
-- `/github ci-orchestrator` - For CI/CD integration
-- `/sparc reviewer` - For detailed code analysis
-- `/sparc tester` - For comprehensive testing
-
-## Error Handling
-
-### Automatic retry logic for:
-- Network failures during GitHub API calls
-- Merge conflicts with intelligent resolution
-- Test failures with automatic re-runs
-- Review bottlenecks with load balancing
-
-### Swarm coordination ensures:
-- No single point of failure
-- Automatic agent failover
-- Progress preservation across interruptions
-- Comprehensive error reporting and recovery

package/.claude/agents/github/project-board-sync.md

@@ -1,508 +0,0 @@
----
-name: project-board-sync
-description: Synchronize AI swarms with GitHub Projects for visual task management, progress tracking, and team coordination
-type: coordination
-color: "#A8E6CF"
-tools:
-  - Bash
-  - Read
-  - Write
-  - Edit
-  - Glob
-  - Grep
-  - LS
-  - TodoWrite
-  - mcp__moflo__swarm_init
-  - mcp__moflo__agent_spawn
-  - mcp__moflo__swarm_status
-  - mcp__moflo__memory_store
-  - mcp__moflo__github_repo_analyze
-  - mcp__moflo__github_pr_manage
-  - mcp__moflo__github_issue_track
-  - mcp__moflo__github_metrics
-  - mcp__moflo__spell_create
-  - mcp__moflo__spell_cast
-hooks:
-  pre:
-    - "gh auth status || (echo 'GitHub CLI not authenticated' && exit 1)"
-    - "gh project list --owner @me --limit 1 >/dev/null || echo 'No projects accessible'"
-    - "git status --porcelain || echo 'Not in git repository'"
-    - "gh api user | jq -r '.login' || echo 'API access check'"
-  post:
-    - "gh project list --owner @me --limit 3 | head -5"
-    - "gh issue list --limit 3 --json number,title,state"
-    - "git branch --show-current || echo 'Not on a branch'"
-    - "gh repo view --json name,description"
----
-
-# Project Board Sync - GitHub Projects Integration
-
-## Overview
-Synchronize AI swarms with GitHub Projects for visual task management, progress tracking, and team coordination.
-
-## Core Features
-
-### 1. Board Initialization
-```bash
-# Connect swarm to GitHub Project using gh CLI
-# Get project details
-PROJECT_ID=$(gh project list --owner @me --format json | \
-  jq -r '.projects[] | select(.title == "Development Board") | .id')
-
-# Initialize swarm with project
-npx ruv-swarm github board-init \
-  --project-id "$PROJECT_ID" \
-  --sync-mode "bidirectional" \
-  --create-views "swarm-status,agent-workload,priority"
-
-# Create project fields for swarm tracking
-gh project field-create $PROJECT_ID --owner @me \
-  --name "Swarm Status" \
-  --data-type "SINGLE_SELECT" \
-  --single-select-options "pending,in_progress,completed"
-```
-
-### 2. Task Synchronization
-```bash
-# Sync swarm tasks with project cards
-npx ruv-swarm github board-sync \
-  --map-status '{
-    "todo": "To Do",
-    "in_progress": "In Progress",
-    "review": "Review",
-    "done": "Done"
-  }' \
-  --auto-move-cards \
-  --update-metadata
-```
-
-### 3. Real-time Updates
-```bash
-# Enable real-time board updates
-npx ruv-swarm github board-realtime \
-  --webhook-endpoint "https://api.example.com/github-sync" \
-  --update-frequency "immediate" \
-  --batch-updates false
-```
-
-## Configuration
-
-### Board Mapping Configuration
-```yaml
-# .github/board-sync.yml
-version: 1
-project:
-  name: "AI Development Board"
-  number: 1
-  
-mapping:
-  # Map swarm task status to board columns
-  status:
-    pending: "Backlog"
-    assigned: "Ready"
-    in_progress: "In Progress"
-    review: "Review"
-    completed: "Done"
-    blocked: "Blocked"
-    
-  # Map agent types to labels
-  agents:
-    coder: "🔧 Development"
-    tester: "🧪 Testing"
-    analyst: "📊 Analysis"
-    designer: "🎨 Design"
-    architect: "🏗️ Architecture"
-    
-  # Map priority to project fields
-  priority:
-    critical: "🔴 Critical"
-    high: "🟡 High"
-    medium: "🟢 Medium"
-    low: "⚪ Low"
-    
-  # Custom fields
-  fields:
-    - name: "Agent Count"
-      type: number
-      source: task.agents.length
-    - name: "Complexity"
-      type: select
-      source: task.complexity
-    - name: "ETA"
-      type: date
-      source: task.estimatedCompletion
-```
-
-### View Configuration
-```javascript
-// Custom board views
-{
-  "views": [
-    {
-      "name": "Swarm Overview",
-      "type": "board",
-      "groupBy": "status",
-      "filters": ["is:open"],
-      "sort": "priority:desc"
-    },
-    {
-      "name": "Agent Workload",
-      "type": "table",
-      "groupBy": "assignedAgent",
-      "columns": ["title", "status", "priority", "eta"],
-      "sort": "eta:asc"
-    },
-    {
-      "name": "Sprint Progress",
-      "type": "roadmap",
-      "dateField": "eta",
-      "groupBy": "milestone"
-    }
-  ]
-}
-```
-
-## Automation Features
-
-### 1. Auto-Assignment
-```bash
-# Automatically assign cards to agents
-npx ruv-swarm github board-auto-assign \
-  --strategy "load-balanced" \
-  --consider "expertise,workload,availability" \
-  --update-cards
-```
-
-### 2. Progress Tracking
-```bash
-# Track and visualize progress
-npx ruv-swarm github board-progress \
-  --show "burndown,velocity,cycle-time" \
-  --time-period "sprint" \
-  --export-metrics
-```
-
-### 3. Smart Card Movement
-```bash
-# Intelligent card state transitions
-npx ruv-swarm github board-smart-move \
-  --rules '{
-    "auto-progress": "when:all-subtasks-done",
-    "auto-review": "when:tests-pass",
-    "auto-done": "when:pr-merged"
-  }'
-```
-
-## Board Commands
-
-### Create Cards from Issues
-```bash
-# Convert issues to project cards using gh CLI
-# List issues with label
-ISSUES=$(gh issue list --label "enhancement" --json number,title,body)
-
-# Add issues to project
-echo "$ISSUES" | jq -r '.[].number' | while read -r issue; do
-  gh project item-add $PROJECT_ID --owner @me --url "https://github.com/$GITHUB_REPOSITORY/issues/$issue"
-done
-
-# Process with swarm
-npx ruv-swarm github board-import-issues \
-  --issues "$ISSUES" \
-  --add-to-column "Backlog" \
-  --parse-checklist \
-  --assign-agents
-```
-
-### Bulk Operations
-```bash
-# Bulk card operations
-npx ruv-swarm github board-bulk \
-  --filter "status:blocked" \
-  --action "add-label:needs-attention" \
-  --notify-assignees
-```
-
-### Card Templates
-```bash
-# Create cards from templates
-npx ruv-swarm github board-template \
-  --template "feature-development" \
-  --variables '{
-    "feature": "User Authentication",
-    "priority": "high",
-    "agents": ["architect", "coder", "tester"]
-  }' \
-  --create-subtasks
-```
-
-## Advanced Synchronization
-
-### 1. Multi-Board Sync
-```bash
-# Sync across multiple boards
-npx ruv-swarm github multi-board-sync \
-  --boards "Development,QA,Release" \
-  --sync-rules '{
-    "Development->QA": "when:ready-for-test",
-    "QA->Release": "when:tests-pass"
-  }'
-```
-
-### 2. Cross-Organization Sync
-```bash
-# Sync boards across organizations
-npx ruv-swarm github cross-org-sync \
-  --source "org1/Project-A" \
-  --target "org2/Project-B" \
-  --field-mapping "custom" \
-  --conflict-resolution "source-wins"
-```
-
-### 3. External Tool Integration
-```bash
-# Sync with external tools
-npx ruv-swarm github board-integrate \
-  --tool "jira" \
-  --mapping "bidirectional" \
-  --sync-frequency "5m" \
-  --transform-rules "custom"
-```
-
-## Visualization & Reporting
-
-### Board Analytics
-```bash
-# Generate board analytics using gh CLI data
-# Fetch project data
-PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)
-
-# Get issue metrics
-ISSUE_METRICS=$(echo "$PROJECT_DATA" | jq -r '.items[] | select(.content.type == "Issue")' | \
-  while read -r item; do
-    ISSUE_NUM=$(echo "$item" | jq -r '.content.number')
-    gh issue view $ISSUE_NUM --json createdAt,closedAt,labels,assignees
-  done)
-
-# Generate analytics with swarm
-npx ruv-swarm github board-analytics \
-  --project-data "$PROJECT_DATA" \
-  --issue-metrics "$ISSUE_METRICS" \
-  --metrics "throughput,cycle-time,wip" \
-  --group-by "agent,priority,type" \
-  --time-range "30d" \
-  --export "dashboard"
-```
-
-### Custom Dashboards
-```javascript
-// Dashboard configuration
-{
-  "dashboard": {
-    "widgets": [
-      {
-        "type": "chart",
-        "title": "Task Completion Rate",
-        "data": "completed-per-day",
-        "visualization": "line"
-      },
-      {
-        "type": "gauge",
-        "title": "Sprint Progress",
-        "data": "sprint-completion",
-        "target": 100
-      },
-      {
-        "type": "heatmap",
-        "title": "Agent Activity",
-        "data": "agent-tasks-per-day"
-      }
-    ]
-  }
-}
-```
-
-### Reports
-```bash
-# Generate reports
-npx ruv-swarm github board-report \
-  --type "sprint-summary" \
-  --format "markdown" \
-  --include "velocity,burndown,blockers" \
-  --distribute "slack,email"
-```
-
-## Workflow Integration
-
-### Sprint Management
-```bash
-# Manage sprints with swarms
-npx ruv-swarm github sprint-manage \
-  --sprint "Sprint 23" \
-  --auto-populate \
-  --capacity-planning \
-  --track-velocity
-```
-
-### Milestone Tracking
-```bash
-# Track milestone progress
-npx ruv-swarm github milestone-track \
-  --milestone "v2.0 Release" \
-  --update-board \
-  --show-dependencies \
-  --predict-completion
-```
-
-### Release Planning
-```bash
-# Plan releases using board data
-npx ruv-swarm github release-plan-board \
-  --analyze-velocity \
-  --estimate-completion \
-  --identify-risks \
-  --optimize-scope
-```
-
-## Team Collaboration
-
-### Work Distribution
-```bash
-# Distribute work among team
-npx ruv-swarm github board-distribute \
-  --strategy "skills-based" \
-  --balance-workload \
-  --respect-preferences \
-  --notify-assignments
-```
-
-### Standup Automation
-```bash
-# Generate standup reports
-npx ruv-swarm github standup-report \
-  --team "frontend" \
-  --include "yesterday,today,blockers" \
-  --format "slack" \
-  --schedule "daily-9am"
-```
-
-### Review Coordination
-```bash
-# Coordinate reviews via board
-npx ruv-swarm github review-coordinate \
-  --board "Code Review" \
-  --assign-reviewers \
-  --track-feedback \
-  --ensure-coverage
-```
-
-## Best Practices
-
-### 1. Board Organization
-- Clear column definitions
-- Consistent labeling system
-- Regular board grooming
-- Automation rules
-
-### 2. Data Integrity
-- Bidirectional sync validation
-- Conflict resolution strategies
-- Audit trails
-- Regular backups
-
-### 3. Team Adoption
-- Training materials
-- Clear workflows
-- Regular reviews
-- Feedback loops
-
-## Troubleshooting
-
-### Sync Issues
-```bash
-# Diagnose sync problems
-npx ruv-swarm github board-diagnose \
-  --check "permissions,webhooks,rate-limits" \
-  --test-sync \
-  --show-conflicts
-```
-
-### Performance
-```bash
-# Optimize board performance
-npx ruv-swarm github board-optimize \
-  --analyze-size \
-  --archive-completed \
-  --index-fields \
-  --cache-views
-```
-
-### Data Recovery
-```bash
-# Recover board data
-npx ruv-swarm github board-recover \
-  --backup-id "2024-01-15" \
-  --restore-cards \
-  --preserve-current \
-  --merge-conflicts
-```
-
-## Examples
-
-### Agile Development Board
-```bash
-# Setup agile board
-npx ruv-swarm github agile-board \
-  --methodology "scrum" \
-  --sprint-length "2w" \
-  --ceremonies "planning,review,retro" \
-  --metrics "velocity,burndown"
-```
-
-### Kanban Flow Board
-```bash
-# Setup kanban board
-npx ruv-swarm github kanban-board \
-  --wip-limits '{
-    "In Progress": 5,
-    "Review": 3
-  }' \
-  --cycle-time-tracking \
-  --continuous-flow
-```
-
-### Research Project Board
-```bash
-# Setup research board
-npx ruv-swarm github research-board \
-  --phases "ideation,research,experiment,analysis,publish" \
-  --track-citations \
-  --collaborate-external
-```
-
-## Metrics & KPIs
-
-### Performance Metrics
-```bash
-# Track board performance
-npx ruv-swarm github board-kpis \
-  --metrics '[
-    "average-cycle-time",
-    "throughput-per-sprint",
-    "blocked-time-percentage",
-    "first-time-pass-rate"
-  ]' \
-  --dashboard-url
-```
-
-### Team Metrics
-```bash
-# Track team performance
-npx ruv-swarm github team-metrics \
-  --board "Development" \
-  --per-member \
-  --include "velocity,quality,collaboration" \
-  --anonymous-option
-```
-
-See also: [swarm-issue.md](./swarm-issue.md), [multi-repo-swarm.md](./multi-repo-swarm.md)