# Github Project Management

> Use when creating GitHub issues, managing project boards, planning sprints, decomposing work into vertical-slice tracer bullets, or triaging an issue backlog with swarm coordination. NOT for PR review (use github-code-review), release versioning (use github-release-management), CI/CD workflows (use github-workflow-automation), or cross-repo sync (use github-multi-repo).

- Skill: `dreamlab-ai/github-project-management` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dreamlab-ai/github-project-management`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dreamlab-ai/github-project-management/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: dreamlab-ai (https://skillmd.com/u/dreamlab-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dreamlab-ai/github-project-management

---


# GitHub Project Management

Manage GitHub issues, boards, and sprints — optionally coordinated by a claude-flow agent swarm. Issue work goes through the `gh` CLI; swarm orchestration through `mcp__claude-flow__*` tools.

## When Not To Use

- PR-level code review with security/performance agents → **github-code-review**
- Release versioning, changelogs, deployment pipelines → **github-release-management**
- GitHub Actions workflow creation and CI/CD setup → **github-workflow-automation**
- Cross-repository coordination and package sync → **github-multi-repo**
- General task orchestration outside GitHub → **swarm-advanced**

## Quick Start

```bash
# Create an issue tagged for swarm pickup
gh issue create \
  --title "Feature: Advanced Authentication" \
  --body "Implement OAuth2 with social login..." \
  --label "enhancement,swarm-ready"

# Open a coordination swarm for the issue
npx claude-flow@alpha hooks pre-task --description "Feature implementation"
```

Board setup:

```bash
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"
```

**Claude Code only:** the swarm coordination step above (`claude-flow hooks`) needs
the claude-flow MCP server. On Codex / GPT-6 Astra (or any session without it): see
[../github-code-review/references/plain-gh-fallback.md](../github-code-review/references/plain-gh-fallback.md)
for the plain `gh`-only path.

## Full Reference

The complete command catalogues — issue triage and templates, board automation, sprint/milestone commands, analytics, security, and end-to-end workflow examples — live in [references/REFERENCE.md](references/REFERENCE.md). Load it on demand.

---

**Last Updated**: 2026-08-21 | **Version**: 2.1.0 | **Maintainer**: Claude Code