Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/project-board-sync.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set76

The whole set →
repo-architect repo-architect optimizes repository layouts and synchronizes files across projects using agent swarms. Helpful when setting up standard templates and multi-repo workflows. CX Codex +1 ★ 850repo stars swarm-pr swarm-pr coordinates agents working on a GitHub pull request, from diff analysis and review to reporting results back to the PR. CX Codex ★ 850repo stars code-review-swarm code-review-swarm sends a pull request through several review agents at once: security, performance, style, architecture. Handy when a plain diff and a linter no longer catch the trouble. CX Codex +1 ★ 850repo stars swarm-issue swarm-issue is a Claude Code command that connects GitHub Issues to swarm work by splitting tasks into subtasks, suggesting agents, and tracking progress. It supports workflows managed through GitHub Issues. CX Codex +1 ★ 850repo stars release-manager release-manager coordinates release pipelines using an agent swarm. It synchronizes versions across packages, executes tests, and opens a GitHub pull request. CX Codex +1 ★ 850repo stars adaptive-learner adaptive-learner — a subagent that pulls similar past cases from ReasoningBank before it starts and files the outcome afterwards, so later runs lean on what already happened. CX Codex ★ 850repo stars pagerank-analyzer The pagerank-analyzer subagent computes PageRank and examines graph structure. Use it to find influential nodes or assess connections across a network. CX Codex ★ 850repo stars production-validator production-validator — a subagent that hunts leftover mocks and stubs in your code, then runs the tests against a real database, cache and payment API before you deploy. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open