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 リポジトリ。
典型的な使用フロー
- ブレインストーミング / PRD – 「通知システムを構築したい」 と言う → CCPM が明確化の質問をし、
.claude/prds/notification-system.mdを書きます。 - PRD を Epic に解析 – 「notification-system PRD を解析」 で
.claude/epics/notification-system/epic.mdを作成します。 - 分解 – 「notification-system epic を分解」 でメタデータ(
depends_on、parallel)付きのタスク Markdown ファイルを生成します。 - GitHub に同期 – 「notification-system epic を GitHub に同期」 で epic issue とサブ issue を作成し、ローカルタスクファイルを issue 番号にリネームし、専用の worktree を設定します。
- 実行 – 「issue 42 の作業を開始」 で、各自のファイルにスコープされた並列エージェントを起動します。各エージェントは
Issue #42: …のようなメッセージでコミットします。 - 追跡 – 「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%。
開発者
- Automaze(https://automaze.io)によって開発されました。AI を活用したソフトウェアデリバリーに特化したコンサルティング会社です。
- 主な連絡先:X(旧 Twitter)の @aroussi。
結論 CCPM は、AI コーディングエージェントが規律あるプロジェクトマネージャーのように動作し、コンテキストを保持し、真の並列作業を可能にし、すべてを GitHub Issues で可視化できるようにする、軽量で Markdown ファーストのスキルです。LLM ベースのコーディングアシスタントをすでに使用しており、再現可能で監査可能なワークフローを求めるチームにとって実用的な追加です。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト