# CCPM — Project Management for AI Coding Agents

> An open-source skill system that brings structured project management to AI coding agents using GitHub Issues and Git worktrees for parallel execution.

## Install

Save as a script file and run:

# CCPM — Project Management for AI Coding Agents

## Quick Use
```bash
git clone https://github.com/automazeio/ccpm.git
cp ccpm/.claude/commands/* .claude/commands/
claude /ccpm:plan "Build a REST API with auth"
```

## Introduction
CCPM (Claude Code Project Management) is an open-source skill system that gives AI coding agents structured project management capabilities. It uses GitHub Issues as a task backlog and Git worktrees for isolated parallel execution, enabling agents to break down complex projects into manageable, trackable work items.

## What CCPM Does
- Decomposes large tasks into GitHub Issues with dependencies
- Creates isolated Git worktrees for each task so agents work in parallel
- Tracks progress through issue labels and automated status updates
- Provides planning commands that generate structured implementation plans
- Integrates directly with Claude Code as installable slash commands

## Architecture Overview
CCPM operates as a set of shell-based skills installed into the agent's command directory. When invoked, it creates a project plan as GitHub Issues, assigns priorities, and spawns worktrees. Each worktree represents an isolated branch where one task executes without interfering with others. Upon completion, changes merge back through pull requests with automated conflict resolution.

## Self-Hosting & Configuration
- Clone the repository and copy commands into your project's .claude/commands/
- Requires a GitHub repository with Issues enabled
- Git must be installed with worktree support (Git 2.5+)
- Configure via environment variables for custom label schemes
- Works with any Git hosting that supports the GitHub Issues API

## Key Features
- Zero-dependency shell scripts that work on any Unix system
- Parallel task execution through Git worktree isolation
- Automatic dependency tracking between related issues
- Progress dashboard via GitHub Issue labels and milestones
- Supports resumption if an agent session is interrupted

## Comparison with Similar Tools
- **GitHub Projects** — manual board management; CCPM automates the full loop for AI agents
- **Linear/Jira integrations** — require API keys and complex setup; CCPM uses native Git
- **Devin/Cursor task lists** — proprietary and non-portable; CCPM works with any agent
- **Custom CLAUDE.md workflows** — ad-hoc; CCPM provides a repeatable framework

## FAQ
**Q: Does CCPM work with agents other than Claude Code?**
A: The core concepts (issues + worktrees) are agent-agnostic, though the slash command integration is tailored for Claude Code.

**Q: How does it handle merge conflicts between parallel worktrees?**
A: Each worktree operates on a separate branch. Merges happen sequentially with automated rebasing. Conflicts surface as PR review comments.

**Q: Can I use it for solo development without AI?**
A: Yes. The planning and worktree commands work independently of any AI agent.

**Q: What happens if the agent crashes mid-task?**
A: Work is preserved in the Git worktree branch. Resuming picks up from the last commit.

## Sources
- https://github.com/automazeio/ccpm
- https://github.com/automazeio/ccpm/blob/main/README.md

---
Source: https://tokrepo.com/en/workflows/asset-a4ce00ee
Author: Script Depot