github-project-management

GitHub Project Management

Manage GitHub projects with AI swarm coordination: intelligent issue management, automated project-board synchronization, and sprint planning. This file holds the core workflow; the exhaustive command catalog and issue templates live in references/ and load only when needed.

When to use

Triaging or organizing issues, wiring a project board to a swarm, decomposing an issue into subtasks, planning or tracking a sprint, or coordinating a release/roadmap on GitHub.

Prerequisites

• gh (GitHub CLI) installed and authenticated.
• ruv-swarm or claude-flow available (npx ruv-swarm ...).
• Permission to edit issues and projects in the target repo/org.

Quick start

# Create a swarm-ready issue
gh issue create \
  --title "Feature: Advanced Authentication" \
  --body "Implement OAuth2 with social login..." \
  --label "enhancement,swarm-ready"

# Initialize a swarm for it
npx claude-flow@alpha hooks pre-task --description "Feature implementation"

# Wire a project board to the swarm (bidirectional)
PROJECT_ID=$(gh project list --owner @me --format json | jq -r '.projects[0].id')
npx ruv-swarm github board-init --project-id "$PROJECT_ID" --sync-mode "bidirectional"

Core workflow

1. Issue management & triage

Spin up a small coordination swarm, create a well-structured issue, then orchestrate tracking:

mcp__claude-flow__swarm_init { topology: "star", maxAgents: 3 }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "Issue Coordinator" }
mcp__github__create_issue {
  owner: "org", repo: "repository",
  title: "Integration Review: Complete system integration",
  body: "## Objectives\n- [ ] Verify dependencies\n- [ ] Ensure API integration\n- [ ] Validate data systems",
  labels: ["integration", "review", "enhancement"]
}
mcp__claude-flow__task_orchestrate { task: "Monitor and coordinate issue progress", strategy: "adaptive", priority: "medium" }

Auto-triage unlabeled issues and decompose large ones into subtask checklists — see references/command-reference.md for triage rules, issue→swarm conversion, decomposition, automated progress comments, and stale-issue handling.