An agentic IDE built around the pi coding agent, running each task in isolated git-worktree workspaces with living specs and reusable skills.
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
Clone the repository
git clone https://github.com/automazeio/ccpm.git - 2
Symlink the skill into your project's Claude Code skills directory
ln -s /path/to/ccpm/skill/ccpm .claude/skills/ccpm - 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
Local governance layer giving AI coding agents a durable project memory of problems, compared options, human decisions, evidence and staleness.
A spec-driven framework that coordinates Planner, Manager and Worker AI agents in separate conversations to manage larger software projects.
A CLI that installs a project-local harness of skills, rules, hooks and knowledge docs for 18 AI coding assistants, after you review the plan.
Installs a spec-driven development workflow as Agent Skills for AI coding agents like Claude Code, Codex, and Cursor, covering requirements, design, tasks, and autonomous implementation.
A terminal app (CLI/TUI) for running and managing multiple AI coding agents like Claude Code, Codex, and Aider in separate git workspaces.