/ ディレクトリ / プレイグラウンド / CCPM (Claude Code Project Mgmt)
● コミュニティ automazeio ⚡ 即起動

CCPM (Claude Code Project Mgmt)

作者 automazeio · automazeio/ccpm

Claude CodeのプロジェクトマネジメントレイヤーとしてGitHub Issues + Gitワークツリーを活用 — すべてのissueがブランチになり、すべてのエージェントが隔離された環境で作業し、コンタミネーションなし。

CCPM(Claude Code Project Management)はGitHub IssuesをAIコーディングエージェントの作業単位として扱います。各issueは独自のGitワークツリー(ブランチ + 隔離されたチェックアウト)を持つため、複数のClaudeセッションがお互いに踏み込まずに並行して作業できます。スキルはpromptからissueを作成し、それをクレームし、PRとしてリリースし、クリーンアップするコマンドを提供します。複数のClaudeタブを同時に実行するソロ開発者向けに作られています。

なぜ使うのか

主な機能

ライブデモ

実際の動作

準備完了

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "ccpm-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "ccpm-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/automazeio/ccpm",
          "~/.claude/skills/ccpm"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add ccpm-skill -- git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: CCPM (Claude Code Project Mgmt)

3つの異なるissueで3つのClaudeセッションを同時に実行する

👤 ソロ創業者・インディー開発者 ⏱ ~60 min intermediate

使うタイミング: 5つの小さなissueがある;順次処理は遅いが、ブランチを切り替えると状態が壊れる場合。

前提条件
  • gh CLI認証済みgh auth logingh repo viewで確認
  • スキルのインストール — git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm
フロー
  1. issueを選ぶ
    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.✓ コピーしました
    → ../wt-42などに3つのワークツリーが作成;各セッションが自分のissueを把握
  3. リリースする
    (In each session) When done — /ship — push branch and open PR linked to the issue.✓ コピーしました
    → PRが作成され、issueにリンクされ、CIが起動

結果: ブランチ切り替えの苦労なく、EoDまでに3つのissueが完了。

注意点
  • issueが重複するファイルに触れる → マージコンフリクト — スキルは選択したissueにファイルの重複があると警告します;並行処理には重複しないものを選んでください
組み合わせ: github

気軽なアイデアを適切にスコープされたissueに変換する

👤 アイデアが溢れている人 ⏱ ~5 min beginner

使うタイミング: チャットに「ああ、あと〜もやろう」と打ち込み続けている場合。適切なissueとして記録しましょう。

フロー
  1. 記録する
    Use ccpm. I want to add JSON export to the dashboard. Create an issue with rationale, acceptance criteria, and a rough plan.✓ コピーしました
    → GitHubで整形されたissueが作成される
  2. リンクする
    Link to related issues if any.✓ コピーしました
    → リンクが追加される

結果: 後でトリアージできる、適切なissueになったアイデア。

注意点
  • issueが冗長になりすぎる — スキルはbodyに200ワードの上限を設けています
組み合わせ: github

腐ったブランチを残さずにissueを途中放棄する

👤 何かを試みて考え直した人 ⏱ ~2 min beginner

使うタイミング: issueを30分進めてアプローチが間違いと判断し、クリーンに抜け出したい場合。

フロー
  1. 放棄する
    /abandon. Remove the worktree, delete the branch, close the issue with a comment explaining why.✓ コピーしました
    → ワークツリーが消え、ブランチが削除され、説明付きでissueが閉じられる

結果: リポジトリを悩ます孤立ブランチなし。

注意点
  • 実は作業の一部を保存したかった — スキルは削除前に/tmp/ccpm-stashesの下にパッチを保存します — 約7日間は復元可能
組み合わせ: github

組み合わせ

他のMCPと組み合わせて10倍の力を

ccpm-skill + github

CCPMとGitHub MCPがissue状態で一致していることを確認する

Sync issue state after every /ship to ensure project boards reflect.✓ コピーしました
ccpm-skill + memorix-mcp

ワークツリーをまたいでコンテキストを引き継ぐ

When starting an issue, recall any memorix entries tagged with this issue's component.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
list filters 作業を見つける 0
start issue_number issueの作業を開始する 0
ship issue_number? 完了;PRの準備ができた 0
abandon issue_number, reason クリーンに抜け出す 0

コストと制限

運用コスト

APIクォータ
GitHub APIの制限に依存(認証済みで5000/h)
呼び出しあたりのトークン
軽量 — ほとんどの操作はgit + gh CLI
金額
無料
ヒント
issue過多にしないでください — スキルはアイデアの記録を促しますが、細かいマイクロ思考まで記録は不要です

セキュリティ

権限、シークレット、影響範囲

最小スコープ: repo(issue + PR書き込み用)
認証情報の保管: gh auth経由
データ送信先: GitHub API
絶対に付与しない: admin:org

トラブルシューティング

よくあるエラーと対処法

git worktree addが失敗:すでに使用中

以前のワークツリーがまだ存在します;git worktree pruneでクリーンアップしてください

確認: `git worktree list`
gh PR createが「コミットなし」エラー

/shipの前にワークツリーブランチで少なくとも1つのコミットを作成してください

2つのセッションが同じissueをクレームする

スキルはissueごとにロックファイルを書きます — 2番目のstartが明確なメッセージで失敗します

代替案

CCPM (Claude Code Project Mgmt) 他との比較

代替案代わりに使う場面トレードオフ
Linear MCPGitHub IssuesではなくLinearを使用している場合CCPMはGitHub専用;Linear MCPは独自のエコシステム
普通の`git worktree` + チェックリスト一度に1つのエージェントしか実行しない場合手動;CCPMはライフサイクルを自動化

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る