GitHub Project Management

AI-powered GitHub project management with swarm coordination

✨ The solution you've been looking for

Verified
Tested and verified by our team
11981 Stars

Comprehensive GitHub project management with swarm-coordinated issue tracking, project board automation, and sprint planning

github project-management issue-tracking agile sprint-planning automation swarm-coordination productivity
Repository

See It In Action

Interactive preview & real-world examples

Live Demo
Skill Demo Animation

AI Conversation Simulator

See how users interact with this skill

User Prompt

Set up sprint planning for our next 2-week iteration with automatic capacity planning and velocity tracking

Skill Processing

Analyzing request...

Agent Response

Fully configured sprint with estimated tasks, assigned agents, progress tracking, and burndown charts

Quick Start (3 Steps)

Get up and running in minutes

1

Install

claude-code skill install github-project-management

claude-code skill install github-project-management
2

Config

3

First Trigger

@github-project-management help

Commands

CommandDescriptionRequired Args
@github-project-management sprint-planning-automationAutomate sprint planning with AI-driven task estimation and resource allocationNone
@github-project-management complex-issue-breakdownTransform large feature requests into manageable, trackable subtasks with swarm coordinationNone
@github-project-management cross-repository-coordinationManage dependencies and coordination across multiple GitHub repositoriesNone

Typical Use Cases

Sprint Planning Automation

Automate sprint planning with AI-driven task estimation and resource allocation

Complex Issue Breakdown

Transform large feature requests into manageable, trackable subtasks with swarm coordination

Cross-Repository Coordination

Manage dependencies and coordination across multiple GitHub repositories

Overview

GitHub Project Management

Overview

A comprehensive skill for managing GitHub projects using AI swarm coordination. This skill combines intelligent issue management, automated project board synchronization, and swarm-based coordination for efficient project delivery.

Quick Start

Basic Issue Creation with Swarm Coordination

1# Create a coordinated issue
2gh issue create \
3  --title "Feature: Advanced Authentication" \
4  --body "Implement OAuth2 with social login..." \
5  --label "enhancement,swarm-ready"
6
7# Initialize swarm for issue
8npx claude-flow@alpha hooks pre-task --description "Feature implementation"

Project Board Quick Setup

1# Get project ID
2PROJECT_ID=$(gh project list --owner @me --format json | \
3  jq -r '.projects[0].id')
4
5# Initialize board sync
6npx ruv-swarm github board-init \
7  --project-id "$PROJECT_ID" \
8  --sync-mode "bidirectional"

Core Capabilities

1. Issue Management & Triage

Automated Issue Creation

Single Issue with Swarm Coordination

 1// Initialize issue management swarm
 2mcp__claude-flow__swarm_init { topology: "star", maxAgents: 3 }
 3mcp__claude-flow__agent_spawn { type: "coordinator", name: "Issue Coordinator" }
 4mcp__claude-flow__agent_spawn { type: "researcher", name: "Requirements Analyst" }
 5mcp__claude-flow__agent_spawn { type: "coder", name: "Implementation Planner" }
 6
 7// Create comprehensive issue
 8mcp__github__create_issue {
 9  owner: "org",
10  repo: "repository",
11  title: "Integration Review: Complete system integration",
12  body: `## 🔄 Integration Review
13
14  ### Overview
15  Comprehensive review and integration between components.
16
17  ### Objectives
18  - [ ] Verify dependencies and imports
19  - [ ] Ensure API integration
20  - [ ] Check hook system integration
21  - [ ] Validate data systems alignment
22
23  ### Swarm Coordination
24  This issue will be managed by coordinated swarm agents for optimal progress tracking.`,
25  labels: ["integration", "review", "enhancement"],
26  assignees: ["username"]
27}
28
29// Set up automated tracking
30mcp__claude-flow__task_orchestrate {
31  task: "Monitor and coordinate issue progress with automated updates",
32  strategy: "adaptive",
33  priority: "medium"
34}

Batch Issue Creation

 1# Create multiple related issues using gh CLI
 2gh issue create \
 3  --title "Feature: Advanced GitHub Integration" \
 4  --body "Implement comprehensive GitHub workflow automation..." \
 5  --label "feature,github,high-priority"
 6
 7gh issue create \
 8  --title "Bug: Merge conflicts in integration branch" \
 9  --body "Resolve merge conflicts..." \
10  --label "bug,integration,urgent"
11
12gh issue create \
13  --title "Documentation: Update integration guides" \
14  --body "Update all documentation..." \
15  --label "documentation,integration"
Issue-to-Swarm Conversion

Transform Issues into Swarm Tasks

 1# Get issue details
 2ISSUE_DATA=$(gh issue view 456 --json title,body,labels,assignees,comments)
 3
 4# Create swarm from issue
 5npx ruv-swarm github issue-to-swarm 456 \
 6  --issue-data "$ISSUE_DATA" \
 7  --auto-decompose \
 8  --assign-agents
 9
10# Batch process multiple issues
11ISSUES=$(gh issue list --label "swarm-ready" --json number,title,body,labels)
12npx ruv-swarm github issues-batch \
13  --issues "$ISSUES" \
14  --parallel
15
16# Update issues with swarm status
17echo "$ISSUES" | jq -r '.[].number' | while read -r num; do
18  gh issue edit $num --add-label "swarm-processing"
19done

Issue Comment Commands

Execute swarm operations via issue comments:

1<!-- In issue comment -->
2/swarm analyze
3/swarm decompose 5
4/swarm assign @agent-coder
5/swarm estimate
6/swarm start
Automated Issue Triage

Auto-Label Based on Content

 1// .github/swarm-labels.json
 2{
 3  "rules": [
 4    {
 5      "keywords": ["bug", "error", "broken"],
 6      "labels": ["bug", "swarm-debugger"],
 7      "agents": ["debugger", "tester"]
 8    },
 9    {
10      "keywords": ["feature", "implement", "add"],
11      "labels": ["enhancement", "swarm-feature"],
12      "agents": ["architect", "coder", "tester"]
13    },
14    {
15      "keywords": ["slow", "performance", "optimize"],
16      "labels": ["performance", "swarm-optimizer"],
17      "agents": ["analyst", "optimizer"]
18    }
19  ]
20}

Automated Triage System

 1# Analyze and triage unlabeled issues
 2npx ruv-swarm github triage \
 3  --unlabeled \
 4  --analyze-content \
 5  --suggest-labels \
 6  --assign-priority
 7
 8# Find and link duplicate issues
 9npx ruv-swarm github find-duplicates \
10  --threshold 0.8 \
11  --link-related \
12  --close-duplicates
Task Decomposition & Progress Tracking

Break Down Issues into Subtasks

 1# Get issue body
 2ISSUE_BODY=$(gh issue view 456 --json body --jq '.body')
 3
 4# Decompose into subtasks
 5SUBTASKS=$(npx ruv-swarm github issue-decompose 456 \
 6  --body "$ISSUE_BODY" \
 7  --max-subtasks 10 \
 8  --assign-priorities)
 9
10# Update issue with checklist
11CHECKLIST=$(echo "$SUBTASKS" | jq -r '.tasks[] | "- [ ] " + .description')
12UPDATED_BODY="$ISSUE_BODY
13
14## Subtasks
15$CHECKLIST"
16
17gh issue edit 456 --body "$UPDATED_BODY"
18
19# Create linked issues for major subtasks
20echo "$SUBTASKS" | jq -r '.tasks[] | select(.priority == "high")' | while read -r task; do
21  TITLE=$(echo "$task" | jq -r '.title')
22  BODY=$(echo "$task" | jq -r '.description')
23
24  gh issue create \
25    --title "$TITLE" \
26    --body "$BODY
27
28Parent issue: #456" \
29    --label "subtask"
30done

Automated Progress Updates

 1# Get current issue state
 2CURRENT=$(gh issue view 456 --json body,labels)
 3
 4# Get swarm progress
 5PROGRESS=$(npx ruv-swarm github issue-progress 456)
 6
 7# Update checklist in issue body
 8UPDATED_BODY=$(echo "$CURRENT" | jq -r '.body' | \
 9  npx ruv-swarm github update-checklist --progress "$PROGRESS")
10
11# Edit issue with updated body
12gh issue edit 456 --body "$UPDATED_BODY"
13
14# Post progress summary as comment
15SUMMARY=$(echo "$PROGRESS" | jq -r '
16"## 📊 Progress Update
17
18**Completion**: \(.completion)%
19**ETA**: \(.eta)
20
21### Completed Tasks
22\(.completed | map("- ✅ " + .) | join("\n"))
23
24### In Progress
25\(.in_progress | map("- 🔄 " + .) | join("\n"))
26
27### Remaining
28\(.remaining | map("- ⏳ " + .) | join("\n"))
29
30---
31🤖 Automated update by swarm agent"')
32
33gh issue comment 456 --body "$SUMMARY"
34
35# Update labels based on progress
36if [[ $(echo "$PROGRESS" | jq -r '.completion') -eq 100 ]]; then
37  gh issue edit 456 --add-label "ready-for-review" --remove-label "in-progress"
38fi
Stale Issue Management

Auto-Close Stale Issues with Swarm Analysis

 1# Find stale issues
 2STALE_DATE=$(date -d '30 days ago' --iso-8601)
 3STALE_ISSUES=$(gh issue list --state open --json number,title,updatedAt,labels \
 4  --jq ".[] | select(.updatedAt < \"$STALE_DATE\")")
 5
 6# Analyze each stale issue
 7echo "$STALE_ISSUES" | jq -r '.number' | while read -r num; do
 8  # Get full issue context
 9  ISSUE=$(gh issue view $num --json title,body,comments,labels)
10
11  # Analyze with swarm
12  ACTION=$(npx ruv-swarm github analyze-stale \
13    --issue "$ISSUE" \
14    --suggest-action)
15
16  case "$ACTION" in
17    "close")
18      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."
19      gh issue edit $num --add-label "stale"
20      ;;
21    "keep")
22      gh issue edit $num --remove-label "stale" 2>/dev/null || true
23      ;;
24    "needs-info")
25      gh issue comment $num --body "This issue needs more information. Please provide additional context or it may be closed as stale."
26      gh issue edit $num --add-label "needs-info"
27      ;;
28  esac
29done
30
31# Close issues that have been stale for 37+ days
32gh issue list --label stale --state open --json number,updatedAt \
33  --jq ".[] | select(.updatedAt < \"$(date -d '37 days ago' --iso-8601)\") | .number" | \
34  while read -r num; do
35    gh issue close $num --comment "Closing due to inactivity. Feel free to reopen if this is still relevant."
36  done

2. Project Board Automation

Board Initialization & Configuration

Connect Swarm to GitHub Project

 1# Get project details
 2PROJECT_ID=$(gh project list --owner @me --format json | \
 3  jq -r '.projects[] | select(.title == "Development Board") | .id')
 4
 5# Initialize swarm with project
 6npx ruv-swarm github board-init \
 7  --project-id "$PROJECT_ID" \
 8  --sync-mode "bidirectional" \
 9  --create-views "swarm-status,agent-workload,priority"
10
11# Create project fields for swarm tracking
12gh project field-create $PROJECT_ID --owner @me \
13  --name "Swarm Status" \
14  --data-type "SINGLE_SELECT" \
15  --single-select-options "pending,in_progress,completed"

Board Mapping Configuration

 1# .github/board-sync.yml
 2version: 1
 3project:
 4  name: "AI Development Board"
 5  number: 1
 6
 7mapping:
 8  # Map swarm task status to board columns
 9  status:
10    pending: "Backlog"
11    assigned: "Ready"
12    in_progress: "In Progress"
13    review: "Review"
14    completed: "Done"
15    blocked: "Blocked"
16
17  # Map agent types to labels
18  agents:
19    coder: "🔧 Development"
20    tester: "🧪 Testing"
21    analyst: "📊 Analysis"
22    designer: "🎨 Design"
23    architect: "🏗️ Architecture"
24
25  # Map priority to project fields
26  priority:
27    critical: "🔴 Critical"
28    high: "🟡 High"
29    medium: "🟢 Medium"
30    low: "⚪ Low"
31
32  # Custom fields
33  fields:
34    - name: "Agent Count"
35      type: number
36      source: task.agents.length
37    - name: "Complexity"
38      type: select
39      source: task.complexity
40    - name: "ETA"
41      type: date
42      source: task.estimatedCompletion
Task Synchronization

Real-time Board Sync

 1# Sync swarm tasks with project cards
 2npx ruv-swarm github board-sync \
 3  --map-status '{
 4    "todo": "To Do",
 5    "in_progress": "In Progress",
 6    "review": "Review",
 7    "done": "Done"
 8  }' \
 9  --auto-move-cards \
10  --update-metadata
11
12# Enable real-time board updates
13npx ruv-swarm github board-realtime \
14  --webhook-endpoint "https://api.example.com/github-sync" \
15  --update-frequency "immediate" \
16  --batch-updates false

Convert Issues to Project Cards

 1# List issues with label
 2ISSUES=$(gh issue list --label "enhancement" --json number,title,body)
 3
 4# Add issues to project
 5echo "$ISSUES" | jq -r '.[].number' | while read -r issue; do
 6  gh project item-add $PROJECT_ID --owner @me --url "https://github.com/$GITHUB_REPOSITORY/issues/$issue"
 7done
 8
 9# Process with swarm
10npx ruv-swarm github board-import-issues \
11  --issues "$ISSUES" \
12  --add-to-column "Backlog" \
13  --parse-checklist \
14  --assign-agents
Smart Card Management

Auto-Assignment

1# Automatically assign cards to agents
2npx ruv-swarm github board-auto-assign \
3  --strategy "load-balanced" \
4  --consider "expertise,workload,availability" \
5  --update-cards

Intelligent Card State Transitions

1# Smart card movement based on rules
2npx ruv-swarm github board-smart-move \
3  --rules '{
4    "auto-progress": "when:all-subtasks-done",
5    "auto-review": "when:tests-pass",
6    "auto-done": "when:pr-merged"
7  }'

Bulk Operations

1# Bulk card operations
2npx ruv-swarm github board-bulk \
3  --filter "status:blocked" \
4  --action "add-label:needs-attention" \
5  --notify-assignees
Custom Views & Dashboards

View Configuration

 1// Custom board views
 2{
 3  "views": [
 4    {
 5      "name": "Swarm Overview",
 6      "type": "board",
 7      "groupBy": "status",
 8      "filters": ["is:open"],
 9      "sort": "priority:desc"
10    },
11    {
12      "name": "Agent Workload",
13      "type": "table",
14      "groupBy": "assignedAgent",
15      "columns": ["title", "status", "priority", "eta"],
16      "sort": "eta:asc"
17    },
18    {
19      "name": "Sprint Progress",
20      "type": "roadmap",
21      "dateField": "eta",
22      "groupBy": "milestone"
23    }
24  ]
25}

Dashboard Configuration

 1// Dashboard with performance widgets
 2{
 3  "dashboard": {
 4    "widgets": [
 5      {
 6        "type": "chart",
 7        "title": "Task Completion Rate",
 8        "data": "completed-per-day",
 9        "visualization": "line"
10      },
11      {
12        "type": "gauge",
13        "title": "Sprint Progress",
14        "data": "sprint-completion",
15        "target": 100
16      },
17      {
18        "type": "heatmap",
19        "title": "Agent Activity",
20        "data": "agent-tasks-per-day"
21      }
22    ]
23  }
24}

3. Sprint Planning & Tracking

Sprint Management

Initialize Sprint with Swarm Coordination

 1# Manage sprints with swarms
 2npx ruv-swarm github sprint-manage \
 3  --sprint "Sprint 23" \
 4  --auto-populate \
 5  --capacity-planning \
 6  --track-velocity
 7
 8# Track milestone progress
 9npx ruv-swarm github milestone-track \
10  --milestone "v2.0 Release" \
11  --update-board \
12  --show-dependencies \
13  --predict-completion

Agile Development Board Setup

1# Setup agile board
2npx ruv-swarm github agile-board \
3  --methodology "scrum" \
4  --sprint-length "2w" \
5  --ceremonies "planning,review,retro" \
6  --metrics "velocity,burndown"

Kanban Flow Board Setup

1# Setup kanban board
2npx ruv-swarm github kanban-board \
3  --wip-limits '{
4    "In Progress": 5,
5    "Review": 3
6  }' \
7  --cycle-time-tracking \
8  --continuous-flow
Progress Tracking & Analytics

Board Analytics

 1# Fetch project data
 2PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)
 3
 4# Get issue metrics
 5ISSUE_METRICS=$(echo "$PROJECT_DATA" | jq -r '.items[] | select(.content.type == "Issue")' | \
 6  while read -r item; do
 7    ISSUE_NUM=$(echo "$item" | jq -r '.content.number')
 8    gh issue view $ISSUE_NUM --json createdAt,closedAt,labels,assignees
 9  done)
10
11# Generate analytics with swarm
12npx ruv-swarm github board-analytics \
13  --project-data "$PROJECT_DATA" \
14  --issue-metrics "$ISSUE_METRICS" \
15  --metrics "throughput,cycle-time,wip" \
16  --group-by "agent,priority,type" \
17  --time-range "30d" \
18  --export "dashboard"

Performance Reports

 1# Track and visualize progress
 2npx ruv-swarm github board-progress \
 3  --show "burndown,velocity,cycle-time" \
 4  --time-period "sprint" \
 5  --export-metrics
 6
 7# Generate reports
 8npx ruv-swarm github board-report \
 9  --type "sprint-summary" \
10  --format "markdown" \
11  --include "velocity,burndown,blockers" \
12  --distribute "slack,email"

KPI Tracking

 1# Track board performance
 2npx ruv-swarm github board-kpis \
 3  --metrics '[
 4    "average-cycle-time",
 5    "throughput-per-sprint",
 6    "blocked-time-percentage",
 7    "first-time-pass-rate"
 8  ]' \
 9  --dashboard-url
10
11# Track team performance
12npx ruv-swarm github team-metrics \
13  --board "Development" \
14  --per-member \
15  --include "velocity,quality,collaboration" \
16  --anonymous-option
Release Planning

Release Coordination

1# Plan releases using board data
2npx ruv-swarm github release-plan-board \
3  --analyze-velocity \
4  --estimate-completion \
5  --identify-risks \
6  --optimize-scope

4. Advanced Coordination

Multi-Board Synchronization

Cross-Board Sync

 1# Sync across multiple boards
 2npx ruv-swarm github multi-board-sync \
 3  --boards "Development,QA,Release" \
 4  --sync-rules '{
 5    "Development->QA": "when:ready-for-test",
 6    "QA->Release": "when:tests-pass"
 7  }'
 8
 9# Cross-organization sync
10npx ruv-swarm github cross-org-sync \
11  --source "org1/Project-A" \
12  --target "org2/Project-B" \
13  --field-mapping "custom" \
14  --conflict-resolution "source-wins"
Issue Dependencies & Epic Management

Dependency Resolution

1# Handle issue dependencies
2npx ruv-swarm github issue-deps 456 \
3  --resolve-order \
4  --parallel-safe \
5  --update-blocking

Epic Coordination

1# Coordinate epic-level swarms
2npx ruv-swarm github epic-swarm \
3  --epic 123 \
4  --child-issues "456,457,458" \
5  --orchestrate
Cross-Repository Coordination

Multi-Repo Issue Management

1# Handle issues across repositories
2npx ruv-swarm github cross-repo \
3  --issue "org/repo#456" \
4  --related "org/other-repo#123" \
5  --coordinate
Team Collaboration

Work Distribution

1# Distribute work among team
2npx ruv-swarm github board-distribute \
3  --strategy "skills-based" \
4  --balance-workload \
5  --respect-preferences \
6  --notify-assignments

Standup Automation

1# Generate standup reports
2npx ruv-swarm github standup-report \
3  --team "frontend" \
4  --include "yesterday,today,blockers" \
5  --format "slack" \
6  --schedule "daily-9am"

Review Coordination

1# Coordinate reviews via board
2npx ruv-swarm github review-coordinate \
3  --board "Code Review" \
4  --assign-reviewers \
5  --track-feedback \
6  --ensure-coverage

Issue Templates

Integration Issue Template

 1## 🔄 Integration Task
 2
 3### Overview
 4[Brief description of integration requirements]
 5
 6### Objectives
 7- [ ] Component A integration
 8- [ ] Component B validation
 9- [ ] Testing and verification
10- [ ] Documentation updates
11
12### Integration Areas
13#### Dependencies
14- [ ] Package.json updates
15- [ ] Version compatibility
16- [ ] Import statements
17
18#### Functionality
19- [ ] Core feature integration
20- [ ] API compatibility
21- [ ] Performance validation
22
23#### Testing
24- [ ] Unit tests
25- [ ] Integration tests
26- [ ] End-to-end validation
27
28### Swarm Coordination
29- **Coordinator**: Overall progress tracking
30- **Analyst**: Technical validation
31- **Tester**: Quality assurance
32- **Documenter**: Documentation updates
33
34### Progress Tracking
35Updates will be posted automatically by swarm agents during implementation.
36
37---
38🤖 Generated with Claude Code

Bug Report Template

 1## 🐛 Bug Report
 2
 3### Problem Description
 4[Clear description of the issue]
 5
 6### Expected Behavior
 7[What should happen]
 8
 9### Actual Behavior
10[What actually happens]
11
12### Reproduction Steps
131. [Step 1]
142. [Step 2]
153. [Step 3]
16
17### Environment
18- Package: [package name and version]
19- Node.js: [version]
20- OS: [operating system]
21
22### Investigation Plan
23- [ ] Root cause analysis
24- [ ] Fix implementation
25- [ ] Testing and validation
26- [ ] Regression testing
27
28### Swarm Assignment
29- **Debugger**: Issue investigation
30- **Coder**: Fix implementation
31- **Tester**: Validation and testing
32
33---
34🤖 Generated with Claude Code

Feature Request Template

 1## ✨ Feature Request
 2
 3### Feature Description
 4[Clear description of the proposed feature]
 5
 6### Use Cases
 71. [Use case 1]
 82. [Use case 2]
 93. [Use case 3]
10
11### Acceptance Criteria
12- [ ] Criterion 1
13- [ ] Criterion 2
14- [ ] Criterion 3
15
16### Implementation Approach
17#### Design
18- [ ] Architecture design
19- [ ] API design
20- [ ] UI/UX mockups
21
22#### Development
23- [ ] Core implementation
24- [ ] Integration with existing features
25- [ ] Performance optimization
26
27#### Testing
28- [ ] Unit tests
29- [ ] Integration tests
30- [ ] User acceptance testing
31
32### Swarm Coordination
33- **Architect**: Design and planning
34- **Coder**: Implementation
35- **Tester**: Quality assurance
36- **Documenter**: Documentation
37
38---
39🤖 Generated with Claude Code

Swarm Task Template

 1<!-- .github/ISSUE_TEMPLATE/swarm-task.yml -->
 2name: Swarm Task
 3description: Create a task for AI swarm processing
 4body:
 5  - type: dropdown
 6    id: topology
 7    attributes:
 8      label: Swarm Topology
 9      options:
10        - mesh
11        - hierarchical
12        - ring
13        - star
14  - type: input
15    id: agents
16    attributes:
17      label: Required Agents
18      placeholder: "coder, tester, analyst"
19  - type: textarea
20    id: tasks
21    attributes:
22      label: Task Breakdown
23      placeholder: |
24        1. Task one description
25        2. Task two description

Workflow Integration

GitHub Actions for Issue Management

 1# .github/workflows/issue-swarm.yml
 2name: Issue Swarm Handler
 3on:
 4  issues:
 5    types: [opened, labeled, commented]
 6
 7jobs:
 8  swarm-process:
 9    runs-on: ubuntu-latest
10    steps:
11      - name: Process Issue
12        uses: ruvnet/swarm-action@v1
13        with:
14          command: |
15            if [[ "${{ github.event.label.name }}" == "swarm-ready" ]]; then
16              npx ruv-swarm github issue-init ${{ github.event.issue.number }}
17            fi

Board Integration Workflow

1# Sync with project board
2npx ruv-swarm github issue-board-sync \
3  --project "Development" \
4  --column-mapping '{
5    "To Do": "pending",
6    "In Progress": "active",
7    "Done": "completed"
8  }'

Specialized Issue Strategies

Bug Investigation Swarm

1# Specialized bug handling
2npx ruv-swarm github bug-swarm 456 \
3  --reproduce \
4  --isolate \
5  --fix \
6  --test

Feature Implementation Swarm

1# Feature implementation swarm
2npx ruv-swarm github feature-swarm 456 \
3  --design \
4  --implement \
5  --document \
6  --demo

Technical Debt Refactoring

1# Refactoring swarm
2npx ruv-swarm github debt-swarm 456 \
3  --analyze-impact \
4  --plan-migration \
5  --execute \
6  --validate

Best Practices

1. Swarm-Coordinated Issue Management

  • Always initialize swarm for complex issues
  • Assign specialized agents based on issue type
  • Use memory for progress coordination
  • Regular automated progress updates

2. Board Organization

  • Clear column definitions with consistent naming
  • Systematic labeling strategy across repositories
  • Regular board grooming and maintenance
  • Well-defined automation rules

3. Data Integrity

  • Bidirectional sync validation
  • Conflict resolution strategies
  • Comprehensive audit trails
  • Regular backups of project data

4. Team Adoption

  • Comprehensive training materials
  • Clear, documented workflows
  • Regular team reviews and retrospectives
  • Active feedback loops for improvement

5. Smart Labeling and Organization

  • Consistent labeling strategy across repositories
  • Priority-based issue sorting and assignment
  • Milestone integration for project coordination
  • Agent-type to label mapping

6. Automated Progress Tracking

  • Regular automated updates with swarm coordination
  • Progress metrics and completion tracking
  • Cross-issue dependency management
  • Real-time status synchronization

Troubleshooting

Sync Issues

1# Diagnose sync problems
2npx ruv-swarm github board-diagnose \
3  --check "permissions,webhooks,rate-limits" \
4  --test-sync \
5  --show-conflicts

Performance Optimization

1# Optimize board performance
2npx ruv-swarm github board-optimize \
3  --analyze-size \
4  --archive-completed \
5  --index-fields \
6  --cache-views

Data Recovery

1# Recover board data
2npx ruv-swarm github board-recover \
3  --backup-id "2024-01-15" \
4  --restore-cards \
5  --preserve-current \
6  --merge-conflicts

Metrics & Analytics

Performance Metrics

Automatic tracking of:

  • Issue creation and resolution times
  • Agent productivity metrics
  • Project milestone progress
  • Cross-repository coordination efficiency
  • Sprint velocity and burndown
  • Cycle time and throughput
  • Work-in-progress limits

Reporting Features

  • Weekly progress summaries
  • Agent performance analytics
  • Project health metrics
  • Integration success rates
  • Team collaboration metrics
  • Quality and defect tracking

Issue Resolution Time

1# Analyze swarm performance
2npx ruv-swarm github issue-metrics \
3  --issue 456 \
4  --metrics "time-to-close,agent-efficiency,subtask-completion"

Swarm Effectiveness

1# Generate effectiveness report
2npx ruv-swarm github effectiveness \
3  --issues "closed:>2024-01-01" \
4  --compare "with-swarm,without-swarm"

Security & Permissions

  1. Command Authorization: Validate user permissions before executing commands
  2. Rate Limiting: Prevent spam and abuse of issue commands
  3. Audit Logging: Track all swarm operations on issues and boards
  4. Data Privacy: Respect private repository settings
  5. Access Control: Proper GitHub permissions for board operations
  6. Webhook Security: Secure webhook endpoints for real-time updates

Integration with Other Skills

Seamless Integration With:

  • github-pr-workflow - Link issues to pull requests automatically
  • github-release-management - Coordinate release issues and milestones
  • sparc-orchestrator - Complex project coordination workflows
  • sparc-tester - Automated testing workflows for issues

Complete Workflow Example

Full-Stack Feature Development

 1# 1. Create feature issue with swarm coordination
 2gh issue create \
 3  --title "Feature: Real-time Collaboration" \
 4  --body "$(cat <<EOF
 5## Feature: Real-time Collaboration
 6
 7### Overview
 8Implement real-time collaboration features using WebSockets.
 9
10### Objectives
11- [ ] WebSocket server setup
12- [ ] Client-side integration
13- [ ] Presence tracking
14- [ ] Conflict resolution
15- [ ] Testing and documentation
16
17### Swarm Coordination
18This feature will use mesh topology for parallel development.
19EOF
20)" \
21  --label "enhancement,swarm-ready,high-priority"
22
23# 2. Initialize swarm and decompose tasks
24ISSUE_NUM=$(gh issue list --label "swarm-ready" --limit 1 --json number --jq '.[0].number')
25npx ruv-swarm github issue-init $ISSUE_NUM \
26  --topology mesh \
27  --auto-decompose \
28  --assign-agents "architect,coder,tester"
29
30# 3. Add to project board
31PROJECT_ID=$(gh project list --owner @me --format json | jq -r '.projects[0].id')
32gh project item-add $PROJECT_ID --owner @me \
33  --url "https://github.com/$GITHUB_REPOSITORY/issues/$ISSUE_NUM"
34
35# 4. Set up automated tracking
36npx ruv-swarm github board-sync \
37  --auto-move-cards \
38  --update-metadata
39
40# 5. Monitor progress
41npx ruv-swarm github issue-progress $ISSUE_NUM \
42  --auto-update-comments \
43  --notify-on-completion

Quick Reference Commands

 1# Issue Management
 2gh issue create --title "..." --body "..." --label "..."
 3npx ruv-swarm github issue-init <number>
 4npx ruv-swarm github issue-decompose <number>
 5npx ruv-swarm github triage --unlabeled
 6
 7# Project Boards
 8npx ruv-swarm github board-init --project-id <id>
 9npx ruv-swarm github board-sync
10npx ruv-swarm github board-analytics
11
12# Sprint Management
13npx ruv-swarm github sprint-manage --sprint "Sprint X"
14npx ruv-swarm github milestone-track --milestone "vX.X"
15
16# Analytics
17npx ruv-swarm github issue-metrics --issue <number>
18npx ruv-swarm github board-kpis

Additional Resources


Last Updated: 2025-10-19 Version: 2.0.0 Maintainer: Claude Code

What Users Are Saying

Real feedback from the community

Environment Matrix

Dependencies

GitHub CLI (gh) - authenticated
Node.js 16+
ruv-swarm or claude-flow MCP server

Framework Support

GitHub Projects ✓ (recommended) GitHub Issues ✓ GitHub Actions ✓ Agile/Scrum methodologies ✓ Kanban workflows ✓

Context Window

Token Usage ~5K-15K tokens for complex project coordination with multiple issues and boards

Security & Privacy

Information

Author
ruvnet
Updated
2026-01-30
Category
productivity-tools