/ Каталог / Песочница / CCPM (Claude Code Project Mgmt)
● Сообщество automazeio ⚡ Сразу

CCPM (Claude Code Project Mgmt)

автор automazeio · automazeio/ccpm

Используйте GitHub Issues + Git worktrees как слой управления проектом для Claude Code — каждый issue становится веткой, каждый агент работает изолированно, никакого взаимного загрязнения.

CCPM (Claude Code Project Management) рассматривает GitHub Issues как единицу работы для AI coding-агентов. Каждый issue получает свой Git worktree (ветку + изолированный checkout), чтобы несколько сессий Claude могли работать параллельно, не наступая друг другу на ноги. Навык предоставляет команды для создания issues из prompt'ов, их захвата, отправки как PR и очистки. Создан для одиночных разработчиков, открывающих несколько вкладок Claude одновременно.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

готово

Установка

Репозиторий автора · Официальная документация Claude Skills

Сценарии использования

Реальные сценарии: CCPM (Claude Code Project Mgmt)

Запустить 3 сессии Claude на 3 разных issue одновременно

👤 Одиночные основатели, инди-разработчики ⏱ ~60 min intermediate

Когда использовать: У вас 5 небольших issues; делать их последовательно медленно, а переключение веток ломает состояние.

Поток
  1. Выбрать issues
    Use ccpm. List open issues; recommend 3 small ones I can do in parallel today.✓ Скопировано
    → 3 issue с грубой оценкой, без блокировщиков между ними
  2. Запустить их
    Start issue #42, #43, #45 each in its own worktree. Open 3 Claude Code sessions ready.✓ Скопировано
    → 3 worktree созданы в ../wt-42 и т.д.; каждая сессия знает, какой issue ей принадлежит
  3. Отправить их
    (В каждой сессии) When done — /ship — push branch and open PR linked to the issue.✓ Скопировано
    → PR создан, связан с issue, CI запущен

Итог: Три закрытых issue к концу дня без боли с переключением веток.

Подводные камни
  • Issues затрагивают пересекающиеся файлы → конфликты слияния — Навык предупреждает, когда выбранные issues имеют пересечение по файлам; выбирайте непересекающиеся для параллельной работы
Сочетать с: github

Превратить случайную идею в правильно оформленный issue

👤 Все с переполнением идей ⏱ ~5 min beginner

Когда использовать: Вы постоянно пишете «а ещё стоило бы...» в чат. Фиксируйте это как нормальные issues.

Поток
  1. Зафиксировать
    Use ccpm. I want to add JSON export to the dashboard. Create an issue with rationale, acceptance criteria, and a rough plan.✓ Скопировано
    → Хорошо оформленный issue создан на GitHub
  2. Связать
    Link to related issues if any.✓ Скопировано
    → Связи добавлены

Итог: Идеи становятся issues, которые можно реально триажировать позже.

Подводные камни
  • Issues становятся слишком многословными — Навык устанавливает ограничение в 200 слов для тела
Сочетать с: github

Отказаться от начатого issue без осиротевших веток

👤 Все, кто начал что-то и передумал ⏱ ~2 min beginner

Когда использовать: Через 30 минут работы над issue вы понимаете, что подход неверный; хотите выйти чисто.

Поток
  1. Отказаться
    /abandon. Remove the worktree, delete the branch, close the issue with a comment explaining why.✓ Скопировано
    → Worktree удалён, ветка удалена, issue закрыт с объяснением

Итог: Никаких заброшенных веток, преследующих репозиторий.

Подводные камни
  • Вы хотели сохранить часть работы — Навык сохраняет патч в /tmp/ccpm-stashes перед удалением — восстановимо ~7 дней
Сочетать с: github

Комбинации

Сочетайте с другими MCP — эффект x10

ccpm-skill + github

Синхронизировать CCPM и GitHub MCP по состоянию issue

ccpm-skill + memorix-mcp

Переносить контекст между worktrees

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
list filters Найти работу 0
start issue_number Начать работу над issue 0
ship issue_number? Готово; время для PR 0
abandon issue_number, reason Чисто выйти 0

Стоимость и лимиты

Во что обходится

Квота API
Ограничен лимитами GitHub API (5000/ч для авторизованных)
Токенов на вызов
Легко — большинство операций это git + gh CLI
Деньги
Бесплатно
Совет
Не перевыпускайте issues — навык поощряет фиксацию мыслей, но не каждой микромысли

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: repo (для записи issue + PR)
Хранение учётных данных: Через gh auth
Исходящий трафик: GitHub API
Никогда не давайте: admin:org

Устранение неполадок

Частые ошибки и исправления

git worktree add fails: already used

Предыдущий worktree ещё существует; очистите через git worktree prune

Проверить: `git worktree list`
gh PR create ошибается с 'no commits between'

Сделайте хотя бы один коммит в ветке worktree перед /ship

Две сессии захватывают один issue

Навык пишет lockfile на issue — второй start завершается с чётким сообщением

Альтернативы

CCPM (Claude Code Project Mgmt) в сравнении

АльтернативаКогда использоватьКомпромисс
Linear MCPВы на Linear, а не на GitHub IssuesCCPM только для GitHub; Linear MCP — своя экосистема
Обычный `git worktree` + чеклистВы запускаете только 1 агента одновременноВручную; CCPM автоматизирует жизненный цикл

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills