project-board-sync — Claude Code subagent
project-board-sync keeps a GitHub Projects board in step with a claude-flow agent swarm: cards, statuses, sprint metrics. Useful when several agents touch one repo.
no license ★ 850 updated 2026-10-26
.claude/agents/project-board-sync.mdWhat project-board-sync does
Cards are created from issues, shifted between columns as an agent task changes state, and filled in with fields such as agent count or complexity. The subagent reaches GitHub through gh and the swarm through mcp__claude-flow__* tools like swarm_init, task_orchestrate and github_issue_track.
Rules live in .github/board-sync.yml: which task status maps to which column, which agent type turns into a label, how priority lands in a project field. Views are declared separately — a kanban grouped by status, a table grouped by assigned agent, a roadmap keyed on ETA. Bulk edits, card templates and moves between boards run as npx ruv-swarm github board-* commands.
Pre-hooks fire first: gh auth status, gh project list --owner @me, git status --porcelain. An unauthenticated gh makes the first hook exit with an error, so nothing starts. The user check pipes through jq, which has to be on the machine. The mcp__claude-flow__* tools resolve only with the claude-flow MCP server connected.
What it helps with
- turn a labelled issue list into project cards
- move cards to the next column as agent tasks advance
- chart burndown and velocity for a sprint
- spread cards across agents by current workload
- keep the Development and QA boards in sync
Example prompts for the agent
- Attach the Development Board project to the swarm and switch on two-way status sync
- Import open issues labelled enhancement into Backlog and assign agents to them
- Show burndown and velocity for the current sprint
How to install project-board-sync
Manually: put the files in place
.claude/agents/project-board-sync.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/project-board-sync.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/project-board-sync.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about project-board-sync
How do I install project-board-sync in Claude Code?
Put the subagent file at .claude/agents/project-board-sync.md inside your project, and it becomes available in the session.
What does project-board-sync do?
It aligns a GitHub Projects board with what the agent swarm is doing: cards from issues, column moves, field updates and sprint metrics.
What does it need to run?
An authenticated gh, jq for the hook checks, a git repository, and the claude-flow MCP server behind the mcp__claude-flow__* tools.