Repolode
automazeio

automazeio/ccpm

An Agent Skill that gives AI coding agents a spec-driven project workflow, turning PRDs into epics and GitHub Issues, with parallel execution in Git worktrees.

Stars
8,435
Forks
840
Open issues
1
Last commit
3 days ago

What is it?

CCPM is a project management skill for AI coding agents. It guides an agent through writing a product requirements document, turning it into a technical epic, breaking the epic into task files with dependencies, and syncing those tasks to GitHub as an epic issue with sub-issues. Progress is tracked in plain Markdown files inside the repository, and GitHub issue comments serve as the audit trail.

For execution, the skill analyzes an issue for independent work streams and launches parallel agents, each scoped to its own files and coordinating through Git. An epic gets a dedicated worktree so parallel changes stay isolated. Deterministic operations such as standup, status, search, and validation run as bash scripts rather than through the model.

CCPM follows the agentskills.io standard, so it can be installed in harnesses such as Claude Code, Codex, OpenCode, Factory, Amp, and Cursor. It requires git and an authenticated gh CLI, and uses a gh-sub-issue extension for parent-child issue links when available.

Key features

  • 01Guided brainstorming that produces a PRD, then a technical epic
  • 02Decomposes epics into task files with dependencies and parallel flags
  • 03Syncs epics and tasks to GitHub as issues and sub-issues
  • 04Launches parallel agents on independent work streams of an issue
  • 05Uses per-epic Git worktrees to isolate parallel changes
  • 06Runs standup, status, and search via bash scripts

Use cases

  • Turning a feature idea into a written spec before an agent writes code
  • Splitting a large feature into tasks that several agents can work on at once
  • Keeping an agent's progress visible to teammates through GitHub issues
  • Resuming agent-driven project work across sessions without losing context

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/automazeio/ccpm.git
  2. 2

    Symlink the skill into your project's Claude Code skills directory

    ln -s /path/to/ccpm/skill/ccpm .claude/skills/ccpm
  3. 3

    Authenticate the GitHub CLI

    gh auth login

Things to know

  • Requires a GitHub repository for your project and an authenticated gh CLI.
  • Parent-child sub-issue links need the extra gh-sub-issue extension; otherwise it falls back to task lists.

In collections

Topics

FAQ

What is ccpm?
An Agent Skill that gives AI coding agents a spec-driven project workflow, turning PRDs into epics and GitHub Issues, with parallel execution in Git worktrees. CCPM is a project management skill for AI coding agents. It guides an agent through writing a product requirements document, turning it into a technical epic, breaking the epic into task files with dependencies, and syncing those tasks to GitHub as an epic issue with sub-issues. Progress is tracked in plain Markdown files inside the repository, and GitHub issue comments serve as the audit trail.
Is ccpm free to use? What license does it have?
ccpm is open source under the MIT license. Check the license terms before using it in commercial products.
Is ccpm still maintained?
Actively maintained. The last commit to ccpm was on Nov 4, 2026.
What can I use ccpm for?
Turning a feature idea into a written spec before an agent writes code Splitting a large feature into tasks that several agents can work on at once Keeping an agent's progress visible to teammates through GitHub issues Resuming agent-driven project work across sessions without losing context
How do I install ccpm?
Clone the repository: git clone https://github.com/automazeio/ccpm.git Symlink the skill into your project's Claude Code skills directory: ln -s /path/to/ccpm/skill/ccpm .claude/skills/ccpm Authenticate the GitHub CLI: gh auth login
Where can I get ccpm?
The source code and installation instructions are on GitHub: https://github.com/automazeio/ccpm

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects