# project-board-sync

project-board-sync — a command that keeps a GitHub Projects board in step with agent-swarm tasks: states, agent labels and priorities land in the right columns.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/commands/github/project-board-sync.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/project-board-sync

## What it does

This command lays out how to wire an agent swarm to a GitHub Projects board. `gh` fetches the project id, then `npx ruv-swarm github board-init` turns on two-way sync and builds views for status, agent workload and priority. From there `board-sync` moves cards following a mapping table.

That table is `.github/board-sync.yml`. Six task states (pending, assigned, in_progress, review, completed, blocked) get columns from Backlog through Done, agent roles become labels, priority becomes a project field. Custom fields such as agent count or ETA read their values off the task itself.

Automation is the other half: assignment balanced by workload, a card sliding into Review once tests pass, plus analytics and reports. It all runs on `gh` and `ruv-swarm`, and the examples parse JSON with `jq`, so a box missing those tools will stall on the first command.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/project-board-sync.md` — Call it with /project-board-sync. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/project-board-sync.md` — Call it with /prompts:project-board-sync. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/project-board-sync.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/project-board-sync.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/commands/github/project-board-sync.md

## When to use it
- map swarm task states onto GitHub Projects columns
- move cards between columns without dragging them by hand
- turn priorities and agent roles into project fields
- pull sprint metrics off the board into a report
- keep two boards or two organisations in step

## Example prompts
- Run `/project-board-sync` against the “Development Board” project with two-way sync and status views.
- Lay out the state mapping in `.github/board-sync.yml` and shift the cards to match it.
- Build a sprint report from the board and export the metrics as markdown.

## Similar
- [sync-todos-to-github](https://affpapa.org/en/nevibecode/commands/sync-todos-to-github.md) — command · ★ 907 repo stars
- [run-github-project](https://affpapa.org/en/nevibecode/skills/run-github-project.md) — skill · 829 installs
- [github-project-management](https://affpapa.org/en/nevibecode/skills/github-project-management.md) — skill · 1400 installs
- [board-ops](https://affpapa.org/en/nevibecode/skills/board-ops.md) — skill · ★ 92149 repo stars
- [audit-project-github](https://affpapa.org/en/nevibecode/commands/audit-project-github.md) — command · ★ 2003 repo stars
- [yeet](https://affpapa.org/en/nevibecode/skills/yeet.md) — skill · 3700 installs

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
