GitHub Project Management
AI-powered GitHub project management with swarm coordination
✨ The solution you've been looking for
Comprehensive GitHub project management with swarm-coordinated issue tracking, project board automation, and sprint planning
See It In Action
Interactive preview & real-world examples
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
Install
claude-code skill install github-project-management
claude-code skill install github-project-managementConfig
First Trigger
@github-project-management helpCommands
| Command | Description | Required Args |
|---|---|---|
| @github-project-management sprint-planning-automation | Automate sprint planning with AI-driven task estimation and resource allocation | None |
| @github-project-management complex-issue-breakdown | Transform large feature requests into manageable, trackable subtasks with swarm coordination | None |
| @github-project-management cross-repository-coordination | Manage dependencies and coordination across multiple GitHub repositories | None |
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
- Command Authorization: Validate user permissions before executing commands
- Rate Limiting: Prevent spam and abuse of issue commands
- Audit Logging: Track all swarm operations on issues and boards
- Data Privacy: Respect private repository settings
- Access Control: Proper GitHub permissions for board operations
- Webhook Security: Secure webhook endpoints for real-time updates
Integration with Other Skills
Seamless Integration With:
github-pr-workflow- Link issues to pull requests automaticallygithub-release-management- Coordinate release issues and milestonessparc-orchestrator- Complex project coordination workflowssparc-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
- GitHub CLI Documentation
- GitHub Projects Documentation
- Swarm Coordination Guide
- Claude Flow Documentation
Last Updated: 2025-10-19 Version: 2.0.0 Maintainer: Claude Code
What Users Are Saying
Real feedback from the community
Environment Matrix
Dependencies
Framework Support
Context Window
Security & Privacy
Information
- Author
- ruvnet
- Updated
- 2026-01-30
- Category
- productivity-tools
Related Skills
GitHub Project Management
Comprehensive GitHub project management with swarm-coordinated issue tracking, project board …
View Details →Linear
Manage issues, projects & team workflows in Linear. Use when the user wants to read, create or …
View Details →Linear
Manage issues, projects & team workflows in Linear. Use when the user wants to read, create or …
View Details →