# project-board-sync

Субагент project-board-sync для Claude Code, Codex и Cursor связывает задачи роя ИИ-агентов с доской GitHub Projects, синхронизируя карточки, статусы и метрики.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 850 у репозитория
- Автор: ruvnet
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/github/project-board-sync.md
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/project-board-sync

## Что делает

Субагент заводит карточки из issue, двигает их по колонкам вслед за сменой статуса задачи агента и заполняет поля вроде числа агентов и сложности. С GitHub он говорит через `gh`, с роем — через MCP-инструменты `mcp__claude-flow__*`: `swarm_init`, `agent_spawn`, `task_orchestrate`, `github_issue_track`, `workflow_execute`.

Поведение описано в `.github/board-sync.yml`: какой статус задачи в какую колонку идёт, какой тип агента становится меткой, как приоритет ложится в поле проекта. Виды доски задаются отдельно — канбан по статусу, таблица по нагрузке агентов, roadmap по ETA. Массовые правки карточек, шаблоны и перенос между досками идут командами `npx ruv-swarm github board-*`.

Сначала срабатывают pre-хуки: `gh auth status`, `gh project list --owner @me`, `git status --porcelain`. Если `gh` не авторизован, первый же хук выходит с ошибкой и работа не начинается. Проверка пользователя идёт через `gh api user | jq`, поэтому на машине нужен ещё и `jq`. Инструменты `mcp__claude-flow__*` доступны только при подключённом MCP-сервере claude-flow.

## Требования
- Работает с: GitHub

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/project-board-sync.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/project-board-sync.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/project-board-sync.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/github/project-board-sync.md

## Когда брать
- завести карточки GitHub Projects из списка issue
- переносить карточки по колонкам вслед за статусом задачи
- собрать burndown и velocity за спринт
- разложить карточки по агентам с учётом текущей загрузки
- держать доски Development и QA в согласованном состоянии

## Примеры запросов агенту
- Подключи проект Development Board к рою и включи двустороннюю синхронизацию статусов
- Импортируй открытые issue с меткой enhancement в колонку Backlog и назначь на них агентов
- Покажи burndown и velocity по текущему спринту

## Похожие
- [project-management](https://affpapa.org/nevibecode/skills/project-management.md) — скилл · 399 установок
- [run-github-project](https://affpapa.org/nevibecode/skills/run-github-project.md) — скилл · 829 установок
- [board-ops](https://affpapa.org/nevibecode/skills/board-ops.md) — скилл · ★ 92149 у репозитория
- [github-project-management](https://affpapa.org/nevibecode/skills/github-project-management.md) — скилл · 1400 установок
- [sync-todos-to-github](https://affpapa.org/nevibecode/commands/sync-todos-to-github.md) — команда · ★ 907 у репозитория
- [audit-project-github](https://affpapa.org/nevibecode/commands/audit-project-github.md) — команда · ★ 2003 у репозитория

Из того же набора: [ruvnet/agentic-flow](https://affpapa.org/nevibecode/by/ruvnet/agentic-flow.md) — 76 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
