CCPM — Project Management for AI Coding Agents

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