claude Code PM: Ship Software Faster with AI-Powered Project Management
Table of Contents
Claude Code PM is a lightweight, file-based project management system designed to accelerate software progress. Built for developers by developers at Automaze, it streamlines the process from initial product requirements to final code delivery, leveraging the power of large language models (LLMs) like Claude.
How It Works: A Workflow Example
Here’s a glimpse into how Claude Code PM transforms ideas into shipped code:
- Define Product Requirements (PRD): Start with
/pm:prd-new memory-systemto create a new PRD.The system then helps refine the PRD and generate an implementation plan. - Parse the PRD: Use
/pm:prd-parse memory-systemto review the epic and break it down into manageable tasks. - Create Tasks & Issues: The command
/pm:epic-oneshot memory-systemautomatically creates an epic issue (e.g., #1234) and associated task issues (e.g., #1235, #1236) in your GitHub repository. - Start development: Begin working on a task with
/pm:issue-start 1235. The agent maintains local progress. - Sync Progress: Regularly synchronize your work with GitHub using
/pm:issue-sync 1235, which updates issue comments with your progress. - Monitor Status: Check the overall project status with
/pm:epic-show memory-system.
Getting Started: Installation & Setup
-
Clone the Repository:
cd path/to/your/project/ git clone https://github.com/automazeio/ccpm.git . cd ccpm/ -
Initialize the PM System: This command handles essential setup tasks:
- Installs the GitHub CLI if it’s not already present.
- Authenticates with your GitHub account.
- installs the gh-sub-issue extension for proper parent-child issue relationships.
- Creates necessary directories.
- Updates your
.gitignorefile.
-
Create
CLAUDE.md: This file contains your repository-specific configuration./init include rules from .claude/CLAUDE.md -
Prime the System: Begin by creating your first PRD:
/pm:prd-new your-feature-nameWatch as structured planning seamlessly transitions into shipped code.
Key Features & Benefits
Claude Code PM offers a unique blend of simplicity, automation, and integration:
| Operation | local | GitHub |
|---|---|---|
| PRD Creation | ✅ | – |
| Implementation Planning | ✅ | – |
| Task Breakdown | ✅ | ✅ (sync) |
| Execution | ✅ | – |
| Status Updates | ✅ | ✅ (sync) |
| Final Deliverables | – | ✅ |
- Leverages
gh-sub-issue: Ensures correct parent-child relationships between epics and tasks. Falls back to task lists if the extension isn’t installed. - Automatic Epic Tracking: Epic issues automatically reflect the completion status of their sub-tasks.
- Clear Labeling: Uses labels like
epic:featureandtask:featurefor enhanced organization. - File-Based Workflow: Tasks initially start as
001.md,002.mdduring decomposition and are renamed to{issue-id}.md(e.g.,1234.md) after GitHub synchronization. This creates a direct link between files and issues. - Speed & Control: All commands operate on local files first for speed, with explicit and controlled synchronization to GitHub.
- Isolation & Parallel Work: Worktrees provide clean Git isolation for parallel development.
- Optional Integration: GitHub Projects can be added separately for visual project management.
Claude code PM was developed at Automaze for developers who ship, by developers who ship. If Claude Code PM helps your team ship better software, we’d love to hear from you!