github-project-management

Single Issue with Swarm Coordination

// Initialize issue management swarmmcp__claude-flow__swarm_init { topology: "star", maxAgents: 3 }mcp__claude-flow__agent_spawn { type: "coordinator", name: "Issue Coordinator" }mcp__claude-flow__agent_spawn { type: "researcher", name: "Requirements Analyst" }mcp__claude-flow__agent_spawn { type: "coder", name: "Implementation Planner" }// Create comprehensive issuemcp__github__create_issue {  owner: "org",  repo: "repository",  title: "Integration Review: Complete system integration",  body: `## 🔄 Integration Review  ### Overview  Comprehensive review and integration between components.  ### Objectives  - [ ] Verify dependencies and imports  - [ ] Ensure API integration  - [ ] Check hook system integration  - [ ] Validate data systems alignment  ### Swarm Coordination  This issue will be managed by coordinated swarm agents for optimal progress tracking.`,  labels: ["integration", "review", "enhancement"],  assignees: ["username"]}// Set up automated trackingmcp__claude-flow__task_orchestrate {  task: "Monitor and coordinate issue progress with automated updates",  strategy: "adaptive",  priority: "medium"}

Batch Issue Creation

# Create multiple related issues using gh CLIgh issue create \  --title "Feature: Advanced GitHub Integration" \  --body "Implement comprehensive GitHub workflow automation..." \  --label "feature,github,high-priority"gh issue create \  --title "Bug: Merge conflicts in integration branch" \  --body "Resolve merge conflicts..." \  --label "bug,integration,urgent"gh issue create \  --title "Documentation: Update integration guides" \  --body "Update all documentation..." \  --label "documentation,integration"

Transform Issues into Swarm Tasks

# Get issue detailsISSUE_DATA=$(gh issue view 456 --json title,body,labels,assignees,comments)# Create swarm from issuenpx ruv-swarm github issue-to-swarm 456 \  --issue-data "$ISSUE_DATA" \  --auto-decompose \  --assign-agents# Batch process multiple issuesISSUES=$(gh issue list --label "swarm-ready" --json number,title,body,labels)npx ruv-swarm github issues-batch \  --issues "$ISSUES" \  --parallel# Update issues with swarm statusecho "$ISSUES" | jq -r '.[].number' | while read -r num; do  gh issue edit $num --add-label "swarm-processing"done

Issue Comment Commands

Execute swarm operations via issue comments:

<!-- In issue comment -->/swarm analyze/swarm decompose 5/swarm assign @agent-coder/swarm estimate/swarm start

Auto-Label Based on Content

// .github/swarm-labels.json{  "rules": [    {      "keywords": ["bug", "error", "broken"],      "labels": ["bug", "swarm-debugger"],      "agents": ["debugger", "tester"]    },    {      "keywords": ["feature", "implement", "add"],      "labels": ["enhancement", "swarm-feature"],      "agents": ["architect", "coder", "tester"]    },    {      "keywords": ["slow", "performance", "optimize"],      "labels": ["performance", "swarm-optimizer"],      "agents": ["analyst", "optimizer"]    }  ]}

Automated Triage System

# Analyze and triage unlabeled issuesnpx ruv-swarm github triage \  --unlabeled \  --analyze-content \  --suggest-labels \  --assign-priority# Find and link duplicate issuesnpx ruv-swarm github find-duplicates \  --threshold 0.8 \  --link-related \  --close-duplicates

Break Down Issues into Subtasks

# Get issue bodyISSUE_BODY=$(gh issue view 456 --json body --jq '.body')# Decompose into subtasksSUBTASKS=$(npx ruv-swarm github issue-decompose 456 \  --body "$ISSUE_BODY" \  --max-subtasks 10 \  --assign-priorities)# Update issue with checklistCHECKLIST=$(echo "$SUBTASKS" | jq -r '.tasks[] | "- [ ] " + .description')UPDATED_BODY="$ISSUE_BODY## Subtasks$CHECKLIST"gh issue edit 456 --body "$UPDATED_BODY"# Create linked issues for major subtasksecho "$SUBTASKS" | jq -r '.tasks[] | select(.priority == "high")' | while read -r task; do  TITLE=$(echo "$task" | jq -r '.title')  BODY=$(echo "$task" | jq -r '.description')  gh issue create \    --title "$TITLE" \    --body "$BODYParent issue: #456" \    --label "subtask"done

Automated Progress Updates

# Get current issue stateCURRENT=$(gh issue view 456 --json body,labels)# Get swarm progressPROGRESS=$(npx ruv-swarm github issue-progress 456)# Update checklist in issue bodyUPDATED_BODY=$(echo "$CURRENT" | jq -r '.body' | \  npx ruv-swarm github update-checklist --progress "$PROGRESS")# Edit issue with updated bodygh issue edit 456 --body "$UPDATED_BODY"# Post progress summary as commentSUMMARY=$(echo "$PROGRESS" | jq -r '"## 📊 Progress Update**Completion**: \(.completion)%**ETA**: \(.eta)### Completed Tasks\(.completed | map("- ✅ " + .) | join(""))### In Progress\(.in_progress | map("- 🔄 " + .) | join(""))### Remaining\(.remaining | map("- ⏳ " + .) | join(""))---🤖 Automated update by swarm agent"')gh issue comment 456 --body "$SUMMARY"# Update labels based on progressif [[ $(echo "$PROGRESS" | jq -r '.completion') -eq 100 ]]; then  gh issue edit 456 --add-label "ready-for-review" --remove-label "in-progress"fi

Auto-Close Stale Issues with Swarm Analysis

# Find stale issuesSTALE_DATE=$(date -d '30 days ago' --iso-8601)STALE_ISSUES=$(gh issue list --state open --json number,title,updatedAt,labels \  --jq ".[] | select(.updatedAt < \"$STALE_DATE\")")# Analyze each stale issueecho "$STALE_ISSUES" | jq -r '.number' | while read -r num; do  # Get full issue context  ISSUE=$(gh issue view $num --json title,body,comments,labels)  # Analyze with swarm  ACTION=$(npx ruv-swarm github analyze-stale \    --issue "$ISSUE" \    --suggest-action)  case "$ACTION" in    "close")      gh issue comment $num --body "This issue has been inactive for 30 days and will be closed in 7 days if there's no further activity."      gh issue edit $num --add-label "stale"      ;;    "keep")      gh issue edit $num --remove-label "stale" 2>/dev/null || true      ;;    "needs-info")      gh issue comment $num --body "This issue needs more information. Please provide additional context or it may be closed as stale."      gh issue edit $num --add-label "needs-info"      ;;  esacdone# Close issues that have been stale for 37+ daysgh issue list --label stale --state open --json number,updatedAt \  --jq ".[] | select(.updatedAt < \"$(date -d '37 days ago' --iso-8601)\") | .number" | \  while read -r num; do    gh issue close $num --comment "Closing due to inactivity. Feel free to reopen if this is still relevant."  done

Connect Swarm to GitHub Project

# Get project detailsPROJECT_ID=$(gh project list --owner @me --format json | \  jq -r '.projects[] | select(.title == "Development Board") | .id')# Initialize swarm with projectnpx ruv-swarm github board-init \  --project-id "$PROJECT_ID" \  --sync-mode "bidirectional" \  --create-views "swarm-status,agent-workload,priority"# Create project fields for swarm trackinggh project field-create $PROJECT_ID --owner @me \  --name "Swarm Status" \  --data-type "SINGLE_SELECT" \  --single-select-options "pending,in_progress,completed"

Board Mapping Configuration

# .github/board-sync.ymlversion: 1project:  name: "AI Development Board"  number: 1mapping:  # 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

Real-time Board Sync

# Sync swarm tasks with project cardsnpx ruv-swarm github board-sync \  --map-status '{    "todo": "To Do",    "in_progress": "In Progress",    "review": "Review",    "done": "Done"  }' \  --auto-move-cards \  --update-metadata# Enable real-time board updatesnpx ruv-swarm github board-realtime \  --webhook-endpoint "https://api.example.com/github-sync" \  --update-frequency "immediate" \  --batch-updates false

Convert Issues to Project Cards

# List issues with labelISSUES=$(gh issue list --label "enhancement" --json number,title,body)# Add issues to projectecho "$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 swarmnpx ruv-swarm github board-import-issues \  --issues "$ISSUES" \  --add-to-column "Backlog" \  --parse-checklist \  --assign-agents

Auto-Assignment

# Automatically assign cards to agentsnpx ruv-swarm github board-auto-assign \  --strategy "load-balanced" \  --consider "expertise,workload,availability" \  --update-cards

Intelligent Card State Transitions

# Smart card movement based on rulesnpx ruv-swarm github board-smart-move \  --rules '{    "auto-progress": "when:all-subtasks-done",    "auto-review": "when:tests-pass",    "auto-done": "when:pr-merged"  }'

Bulk Operations

# Bulk card operationsnpx ruv-swarm github board-bulk \  --filter "status:blocked" \  --action "add-label:needs-attention" \  --notify-assignees

View Configuration

// 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"    }  ]}

Dashboard Configuration

// Dashboard with performance widgets{  "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"      }    ]  }}

Initialize Sprint with Swarm Coordination

# Manage sprints with swarmsnpx ruv-swarm github sprint-manage \  --sprint "Sprint 23" \  --auto-populate \  --capacity-planning \  --track-velocity# Track milestone progressnpx ruv-swarm github milestone-track \  --milestone "v2.0 Release" \  --update-board \  --show-dependencies \  --predict-completion

Agile Development Board Setup

# Setup agile boardnpx ruv-swarm github agile-board \  --methodology "scrum" \  --sprint-length "2w" \  --ceremonies "planning,review,retro" \  --metrics "velocity,burndown"

Kanban Flow Board Setup

# Setup kanban boardnpx ruv-swarm github kanban-board \  --wip-limits '{    "In Progress": 5,    "Review": 3  }' \  --cycle-time-tracking \  --continuous-flow

Board Analytics

# Fetch project dataPROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)# Get issue metricsISSUE_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 swarmnpx 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"

Performance Reports

# Track and visualize progressnpx ruv-swarm github board-progress \  --show "burndown,velocity,cycle-time" \  --time-period "sprint" \  --export-metrics# Generate reportsnpx ruv-swarm github board-report \  --type "sprint-summary" \  --format "markdown" \  --include "velocity,burndown,blockers" \  --distribute "slack,email"

KPI Tracking

# Track board performancenpx ruv-swarm github board-kpis \  --metrics '[    "average-cycle-time",    "throughput-per-sprint",    "blocked-time-percentage",    "first-time-pass-rate"  ]' \  --dashboard-url# Track team performancenpx ruv-swarm github team-metrics \  --board "Development" \  --per-member \  --include "velocity,quality,collaboration" \  --anonymous-option

Release Coordination

# Plan releases using board datanpx ruv-swarm github release-plan-board \  --analyze-velocity \  --estimate-completion \  --identify-risks \  --optimize-scope

Cross-Board Sync

# Sync across multiple boardsnpx ruv-swarm github multi-board-sync \  --boards "Development,QA,Release" \  --sync-rules '{    "Development->QA": "when:ready-for-test",    "QA->Release": "when:tests-pass"  }'# Cross-organization syncnpx ruv-swarm github cross-org-sync \  --source "org1/Project-A" \  --target "org2/Project-B" \  --field-mapping "custom" \  --conflict-resolution "source-wins"

Dependency Resolution

# Handle issue dependenciesnpx ruv-swarm github issue-deps 456 \  --resolve-order \  --parallel-safe \  --update-blocking

Epic Coordination

# Coordinate epic-level swarmsnpx ruv-swarm github epic-swarm \  --epic 123 \  --child-issues "456,457,458" \  --orchestrate

Multi-Repo Issue Management

# Handle issues across repositoriesnpx ruv-swarm github cross-repo \  --issue "org/repo#456" \  --related "org/other-repo#123" \  --coordinate

Work Distribution

# Distribute work among teamnpx ruv-swarm github board-distribute \  --strategy "skills-based" \  --balance-workload \  --respect-preferences \  --notify-assignments

Standup Automation

# Generate standup reportsnpx ruv-swarm github standup-report \  --team "frontend" \  --include "yesterday,today,blockers" \  --format "slack" \  --schedule "daily-9am"

Review Coordination

# Coordinate reviews via boardnpx ruv-swarm github review-coordinate \  --board "Code Review" \  --assign-reviewers \  --track-feedback \  --ensure-coverage