automazeio/ccpm

Project management skill system for Agents that uses GitHub Issues and Git worktrees for parallel agent execution.

CCPM – プロジェクトマネージャーエージェント

それは何か

  • Agent Skill(agentskills.io 標準に準拠)で、AI コーディングエージェントに構造化されたプロジェクト管理の頭脳を提供します。
  • 自然言語のアイデアを仕様駆動の完全なワークフローに変換します:PRD → Epic → Task → GitHub Issue → Code。各ステップはリポジトリに記録されます。

なぜ重要か

  • コンテキストが消えない – すべての仕様、決定、進捗は .claude/ のプレーンな Markdown ファイルに保存され、チャットログで失われることはありません。
  • 並列性 – 単一の Issue を複数の独立したストリームに分割し、別々のエージェントで同時に実行できるため、ウォールクロック時間を大幅に短縮できます。
  • GitHub ネイティブ – GitHub Issues(およびオプションの gh-sub-issue 拡張機能)を唯一の真実のソースとして使用するため、チームは追加のプロジェクト管理ツールなしで人間またはエージェントと協力できます。
  • ハーネス非依存 – Claude Code、Codex、Factory、Amp、Cursor、OpenCode などで動作し、ハーネスを skill/ccpm/ にポイントするだけです。

主な機能

機能 利点
仕様駆動のワークフロー PRD 作成、エピック計画、タスク分解はすべて Markdown ファイルによって駆動され、トレーサビリティを保証します。
並列実行システム タスクを parallel: true とマークし、各エージェントが独自の git worktree で作業する複数のエージェントを起動し、競合を回避します。
GitHub ファーストの統合 Issue がプロジェクトの状態になり、コメントが監査証跡として機能します。別のデータベースや Projects ボードは不要です。
決定論的な bash スクリプト Stand-up、status、search、next-task、blocked-task などがスクリプトとして即座に実行され、余分な LLM トークンコストを排除します。
Agent-skill プラグアンドプレイ 一度インストールすれば、Agent Skills 仕様を理解する任意のエージェントが自然言語で CCPM を呼び出せます(例:「issue 42 の作業を開始」)。
完全なトレーサビリティ すべてのコード行は PRD → Epic → Task → Issue → Commit チェーンに遡ることができます。

インストール

# リポジトリをクローン
git clone https://github.com/automazeio/ccpm.git

# Factory/Droid ハーネスの例
ln -s $(pwd)/ccpm/skill/ccpm ~/.factory/skills/ccpm

# Claude Code の例
ln -s $(pwd)/ccpm/skill/ccpm .claude/skills/ccpm

前提条件:git、認証済みの GitHub CLI(gh)、およびプロジェクトが置かれる GitHub リポジトリ。

典型的な使用フロー

  1. ブレインストーミング / PRD – 「通知システムを構築したい」 と言う → CCPM が明確化の質問をし、.claude/prds/notification-system.md を書きます。
  2. PRD を Epic に解析 – 「notification-system PRD を解析」 で .claude/epics/notification-system/epic.md を作成します。
  3. 分解 – 「notification-system epic を分解」 でメタデータ(depends_on、parallel)付きのタスク Markdown ファイルを生成します。
  4. GitHub に同期 – 「notification-system epic を GitHub に同期」 で epic issue とサブ issue を作成し、ローカルタスクファイルを issue 番号にリネームし、専用の worktree を設定します。
  5. 実行 – 「issue 42 の作業を開始」 で、各自のファイルにスコープされた並列エージェントを起動します。各エージェントは Issue #42: … のようなメッセージでコミットします。
  6. 追跡 – 「standup」 または 「what’s blocked」 でバンドルされた standup.sh/status.sh スクリプトを実行し、Markdown ファイルからリアルタイムレポートを出力します。

プロジェクト構造

skill/ccpm/
├─ SKILL.md            # スキルのエントリポイント
└─ references/
   ├─ plan.md          # PRD → epic ロジック
   ├─ structure.md     # タスク分解
   ├─ sync.md          # GitHub issue 作成
   ├─ execute.md       # 並列起動
   ├─ track.md         # ステータス/スタンドアップスクリプト
   └─ scripts/        # 14 個の bash ヘルパー(status.sh、standup.sh、…)

.claude/
├─ prds/               # 製品要件ドキュメント
└─ epics/
   └─ <feature>/       # epic.md + <issue-id>.md タスクファイル

すべての真実のソースデータはこれらのプレーンな Markdown ファイルにあります。

実証済みの結果(README の主張)

  • コンテキストスイッチングによる時間損失が 89% 削減。
  • 単一のシリアルタスクではなく 5〜8 の並列タスク。
  • 詳細なコーディング前仕様によりバグが 75% 削減。
  • 機能提供が最大 3 倍高速。
  • 内部ベンチマークでは、CCPM 使用時の PRD 作成、issue 実行、スタンドアップの成功率は 100% で、未使用時は約 28%。

開発者

結論 CCPM は、AI コーディングエージェントが規律あるプロジェクトマネージャーのように動作し、コンテキストを保持し、真の並列作業を可能にし、すべてを GitHub Issues で可視化できるようにする、軽量で Markdown ファーストのスキルです。LLM ベースのコーディングアシスタントをすでに使用しており、再現可能で監査可能なワークフローを求めるチームにとって実用的な追加です。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト