{"id":30415626,"url":"https://github.com/automazeio/ccpm","last_synced_at":"2025-12-27T09:13:20.740Z","repository":{"id":310807091,"uuid":"1040397982","full_name":"automazeio/ccpm","owner":"automazeio","description":"Project management system for Claude Code using GitHub Issues and Git worktrees for parallel agent execution.","archived":false,"fork":false,"pushed_at":"2025-09-25T14:45:09.000Z","size":461,"stargazers_count":4963,"open_issues_count":15,"forks_count":532,"subscribers_count":28,"default_branch":"main","last_synced_at":"2025-10-02T04:29:18.628Z","etag":null,"topics":["ai-agents","ai-coding","claude","claude-code","project-management","vibe-coding"],"latest_commit_sha":null,"homepage":"https://automaze.io/ccpm","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/automazeio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-18T23:20:08.000Z","updated_at":"2025-10-02T02:39:29.000Z","dependencies_parsed_at":"2025-08-20T11:41:59.860Z","dependency_job_id":"7b241ac2-1f18-4436-b661-6693393e30ce","html_url":"https://github.com/automazeio/ccpm","commit_stats":null,"previous_names":["automazeio/ccpm"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/automazeio/ccpm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/automazeio%2Fccpm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/automazeio%2Fccpm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/automazeio%2Fccpm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/automazeio%2Fccpm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/automazeio","download_url":"https://codeload.github.com/automazeio/ccpm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/automazeio%2Fccpm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28076711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-27T02:00:05.897Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-coding","claude","claude-code","project-management","vibe-coding"],"created_at":"2025-08-22T04:02:45.252Z","updated_at":"2025-12-27T09:13:20.732Z","avatar_url":"https://github.com/automazeio.png","language":"Shell","funding_links":[],"categories":["Development \u0026 Engineering","Workflows \u0026 Knowledge Guides 🧠","Agent Orchestration","Shell","Tools \u0026 Utilities","🎯 Project Management \u0026 Orchestration","Project Management \u0026 Workflows","HarmonyOS","AI Coding Agents","Repos","Project \u0026 Knowledge Management","Plugins","Productivity \u0026 Workflow","AI Agent Frameworks \u0026 SDKs","A01_文本生成_文本对话","AI编程任务管理"],"sub_categories":["Core Development Skills","General","📖 Community Guides \u0026 Tutorials","Claude Code Project Management (CCPM)","Windows Manager","Claude Code","Other IDEs","All Plugins","Orchestration Frameworks","大语言对话模型及数据"],"readme":"# Claude Code PM\n\n[![Automaze](https://img.shields.io/badge/By-automaze.io-4b3baf)](https://automaze.io)\n\u0026nbsp;\n[![Claude Code](https://img.shields.io/badge/+-Claude%20Code-d97757)](https://github.com/automazeio/ccpm/blob/main/README.md)\n[![GitHub Issues](https://img.shields.io/badge/+-GitHub%20Issues-1f2328)](https://github.com/automazeio/ccpm)\n\u0026nbsp;\n[![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)](https://github.com/hesreallyhim/awesome-claude-code?tab=readme-ov-file#general-)\n\u0026nbsp;\n[![MIT License](https://img.shields.io/badge/License-MIT-28a745)](https://github.com/automazeio/ccpm/blob/main/LICENSE)\n\u0026nbsp;\n[![Follow on 𝕏](https://img.shields.io/badge/𝕏-@aroussi-1c9bf0)](http://x.com/intent/follow?screen_name=aroussi)\n\u0026nbsp;\n[![Star this repo](https://img.shields.io/github/stars/automazeio/ccpm.svg?style=social\u0026label=Star%20this%20repo\u0026maxAge=60)](https://github.com/automazeio/ccpm)\n\n### Claude Code workflow to ship ~~faster~~ _better_ using spec-driven development, GitHub issues, Git worktrees, and multiple AI agents running in parallel.\n\n**[中文文档 (Chinese Documentation)](zh-docs/README_ZH.md)**\n\nStop losing context. Stop blocking on tasks. Stop shipping bugs. This battle-tested system turns PRDs into epics, epics into GitHub issues, and issues into production code – with full traceability at every step.\n\n![Claude Code PM](screenshot.webp)\n\n## Table of Contents\n\n- [Background](#background)\n- [The Workflow](#the-workflow)\n- [What Makes This Different?](#what-makes-this-different)\n- [Why GitHub Issues?](#why-github-issues)\n- [Core Principle: No Vibe Coding](#core-principle-no-vibe-coding)\n- [System Architecture](#system-architecture)\n- [Workflow Phases](#workflow-phases)\n- [Command Reference](#command-reference)\n- [The Parallel Execution System](#the-parallel-execution-system)\n- [Key Features \u0026 Benefits](#key-features--benefits)\n- [Proven Results](#proven-results)\n- [Example Flow](#example-flow)\n- [Get Started Now](#get-started-now)\n- [Local vs Remote](#local-vs-remote)\n- [Technical Notes](#technical-notes)\n- [Support This Project](#support-this-project)\n\n## Background\n\nEvery team struggles with the same problems:\n- **Context evaporates** between sessions, forcing constant re-discovery\n- **Parallel work creates conflicts** when multiple developers touch the same code\n- **Requirements drift** as verbal decisions override written specs\n- **Progress becomes invisible** until the very end\n\nThis system solves all of that.\n\n## The Workflow\n\n```mermaid\ngraph LR\n    A[PRD Creation] --\u003e B[Epic Planning]\n    B --\u003e C[Task Decomposition]\n    C --\u003e D[GitHub Sync]\n    D --\u003e E[Parallel Execution]\n```\n\n### See It In Action (60 seconds)\n\n```bash\n# Create a comprehensive PRD through guided brainstorming\n/pm:prd-new memory-system\n\n# Transform PRD into a technical epic with task breakdown\n/pm:prd-parse memory-system\n\n# Push to GitHub and start parallel execution\n/pm:epic-oneshot memory-system\n/pm:issue-start 1235\n```\n\n## What Makes This Different?\n\n| Traditional Development | Claude Code PM System |\n|------------------------|----------------------|\n| Context lost between sessions | **Persistent context** across all work |\n| Serial task execution | **Parallel agents** on independent tasks |\n| \"Vibe coding\" from memory | **Spec-driven** with full traceability |\n| Progress hidden in branches | **Transparent audit trail** in GitHub |\n| Manual task coordination | **Intelligent prioritization** with `/pm:next` |\n\n## Why GitHub Issues?\n\nMost Claude Code workflows operate in isolation – a single developer working with AI in their local environment. This creates a fundamental problem: **AI-assisted development becomes a silo**.\n\nBy using GitHub Issues as our database, we unlock something powerful:\n\n### 🤝 **True Team Collaboration**\n- Multiple Claude instances can work on the same project simultaneously\n- Human developers see AI progress in real-time through issue comments\n- Team members can jump in anywhere – the context is always visible\n- Managers get transparency without interrupting flow\n\n### 🔄 **Seamless Human-AI Handoffs**\n- AI can start a task, human can finish it (or vice versa)\n- Progress updates are visible to everyone, not trapped in chat logs\n- Code reviews happen naturally through PR comments\n- No \"what did the AI do?\" meetings\n\n### 📈 **Scalable Beyond Solo Work**\n- Add team members without onboarding friction\n- Multiple AI agents working in parallel on different issues\n- Distributed teams stay synchronized automatically\n- Works with existing GitHub workflows and tools\n\n### 🎯 **Single Source of Truth**\n- No separate databases or project management tools\n- Issue state is the project state\n- Comments are the audit trail\n- Labels provide organization\n\nThis isn't just a project management system – it's a **collaboration protocol** that lets humans and AI agents work together at scale, using infrastructure your team already trusts.\n\n## Core Principle: No Vibe Coding\n\n\u003e **Every line of code must trace back to a specification.**\n\nWe follow a strict 5-phase discipline:\n\n1. **🧠 Brainstorm** - Think deeper than comfortable\n2. **📝 Document** - Write specs that leave nothing to interpretation\n3. **📐 Plan** - Architect with explicit technical decisions\n4. **⚡ Execute** - Build exactly what was specified\n5. **📊 Track** - Maintain transparent progress at every step\n\nNo shortcuts. No assumptions. No regrets.\n\n## System Architecture\n\n```\n.claude/\n├── CLAUDE.md          # Always-on instructions (copy content to your project's CLAUDE.md file)\n├── agents/            # Task-oriented agents (for context preservation)\n├── commands/          # Command definitions\n│   ├── context/       # Create, update, and prime context\n│   ├── pm/            # ← Project management commands (this system)\n│   └── testing/       # Prime and execute tests (edit this)\n├── context/           # Project-wide context files\n├── epics/             # ← PM's local workspace (place in .gitignore)\n│   └── [epic-name]/   # Epic and related tasks\n│       ├── epic.md    # Implementation plan\n│       ├── [#].md     # Individual task files\n│       └── updates/   # Work-in-progress updates\n├── prds/              # ← PM's PRD files\n├── rules/             # Place any rule files you'd like to reference here\n└── scripts/           # Place any script files you'd like to use here\n```\n\n## Workflow Phases\n\n### 1. Product Planning Phase\n\n```bash\n/pm:prd-new feature-name\n```\nLaunches comprehensive brainstorming to create a Product Requirements Document capturing vision, user stories, success criteria, and constraints.\n\n**Output:** `.claude/prds/feature-name.md`\n\n### 2. Implementation Planning Phase\n\n```bash\n/pm:prd-parse feature-name\n```\nTransforms PRD into a technical implementation plan with architectural decisions, technical approach, and dependency mapping.\n\n**Output:** `.claude/epics/feature-name/epic.md`\n\n### 3. Task Decomposition Phase\n\n```bash\n/pm:epic-decompose feature-name\n```\nBreaks epic into concrete, actionable tasks with acceptance criteria, effort estimates, and parallelization flags.\n\n**Output:** `.claude/epics/feature-name/[task].md`\n\n### 4. GitHub Synchronization\n\n```bash\n/pm:epic-sync feature-name\n# Or for confident workflows:\n/pm:epic-oneshot feature-name\n```\nPushes epic and tasks to GitHub as issues with appropriate labels and relationships.\n\n### 5. Execution Phase\n\n```bash\n/pm:issue-start 1234  # Launch specialized agent\n/pm:issue-sync 1234   # Push progress updates\n/pm:next             # Get next priority task\n```\nSpecialized agents implement tasks while maintaining progress updates and an audit trail.\n\n## Command Reference\n\n\u003e [!TIP]\n\u003e Type `/pm:help` for a concise command summary\n\n### Initial Setup\n- `/pm:init` - Install dependencies and configure GitHub\n\n### PRD Commands\n- `/pm:prd-new` - Launch brainstorming for new product requirement\n- `/pm:prd-parse` - Convert PRD to implementation epic\n- `/pm:prd-list` - List all PRDs\n- `/pm:prd-edit` - Edit existing PRD\n- `/pm:prd-status` - Show PRD implementation status\n\n### Epic Commands\n- `/pm:epic-decompose` - Break epic into task files\n- `/pm:epic-sync` - Push epic and tasks to GitHub\n- `/pm:epic-oneshot` - Decompose and sync in one command\n- `/pm:epic-list` - List all epics\n- `/pm:epic-show` - Display epic and its tasks\n- `/pm:epic-close` - Mark epic as complete\n- `/pm:epic-edit` - Edit epic details\n- `/pm:epic-refresh` - Update epic progress from tasks\n\n### Issue Commands\n- `/pm:issue-show` - Display issue and sub-issues\n- `/pm:issue-status` - Check issue status\n- `/pm:issue-start` - Begin work with specialized agent\n- `/pm:issue-sync` - Push updates to GitHub\n- `/pm:issue-close` - Mark issue as complete\n- `/pm:issue-reopen` - Reopen closed issue\n- `/pm:issue-edit` - Edit issue details\n\n### Workflow Commands\n- `/pm:next` - Show next priority issue with epic context\n- `/pm:status` - Overall project dashboard\n- `/pm:standup` - Daily standup report\n- `/pm:blocked` - Show blocked tasks\n- `/pm:in-progress` - List work in progress\n\n### Sync Commands\n- `/pm:sync` - Full bidirectional sync with GitHub\n- `/pm:import` - Import existing GitHub issues\n\n### Maintenance Commands\n- `/pm:validate` - Check system integrity\n- `/pm:clean` - Archive completed work\n- `/pm:search` - Search across all content\n\n## The Parallel Execution System\n\n### Issues Aren't Atomic\n\nTraditional thinking: One issue = One developer = One task\n\n**Reality: One issue = Multiple parallel work streams**\n\nA single \"Implement user authentication\" issue isn't one task. It's...\n\n- **Agent 1**: Database tables and migrations\n- **Agent 2**: Service layer and business logic\n- **Agent 3**: API endpoints and middleware\n- **Agent 4**: UI components and forms\n- **Agent 5**: Test suites and documentation\n\nAll running **simultaneously** in the same worktree.\n\n### The Math of Velocity\n\n**Traditional Approach:**\n- Epic with 3 issues\n- Sequential execution\n\n**This System:**\n- Same epic with 3 issues\n- Each issue splits into ~4 parallel streams\n- **12 agents working simultaneously**\n\nWe're not assigning agents to issues. We're **leveraging multiple agents** to ship faster.\n\n### Context Optimization\n\n**Traditional single-thread approach:**\n- Main conversation carries ALL the implementation details\n- Context window fills with database schemas, API code, UI components\n- Eventually hits context limits and loses coherence\n\n**Parallel agent approach:**\n- Main thread stays clean and strategic\n- Each agent handles its own context in isolation\n- Implementation details never pollute the main conversation\n- Main thread maintains oversight without drowning in code\n\nYour main conversation becomes the conductor, not the orchestra.\n\n### GitHub vs Local: Perfect Separation\n\n**What GitHub Sees:**\n- Clean, simple issues\n- Progress updates\n- Completion status\n\n**What Actually Happens Locally:**\n- Issue #1234 explodes into 5 parallel agents\n- Agents coordinate through Git commits\n- Complex orchestration hidden from view\n\nGitHub doesn't need to know HOW the work got done – just that it IS done.\n\n### The Command Flow\n\n```bash\n# Analyze what can be parallelized\n/pm:issue-analyze 1234\n\n# Launch the swarm\n/pm:epic-start memory-system\n\n# Watch the magic\n# 12 agents working across 3 issues\n# All in: ../epic-memory-system/\n\n# One clean merge when done\n/pm:epic-merge memory-system\n```\n\n## Key Features \u0026 Benefits\n\n### 🧠 **Context Preservation**\nNever lose project state again. Each epic maintains its own context, agents read from `.claude/context/`, and updates locally before syncing.\n\n### ⚡ **Parallel Execution**\nShip faster with multiple agents working simultaneously. Tasks marked `parallel: true` enable conflict-free concurrent development.\n\n### 🔗 **GitHub Native**\nWorks with tools your team already uses. Issues are the source of truth, comments provide history, and there is no dependency on the Projects API.\n\n### 🤖 **Agent Specialization**\nRight tool for every job. Different agents for UI, API, and database work. Each reads requirements and posts updates automatically.\n\n### 📊 **Full Traceability**\nEvery decision is documented. PRD → Epic → Task → Issue → Code → Commit. Complete audit trail from idea to production.\n\n### 🚀 **Developer Productivity**\nFocus on building, not managing. Intelligent prioritization, automatic context loading, and incremental sync when ready.\n\n## Proven Results\n\nTeams using this system report:\n- **89% less time** lost to context switching – you'll use `/compact` and `/clear` a LOT less\n- **5-8 parallel tasks** vs 1 previously – editing/testing multiple files at the same time\n- **75% reduction** in bug rates – due to the breaking down features into detailed tasks\n- **Up to 3x faster** feature delivery – based on feature size and complexity\n\n## Example Flow\n\n```bash\n# Start a new feature\n/pm:prd-new memory-system\n\n# Review and refine the PRD...\n\n# Create implementation plan\n/pm:prd-parse memory-system\n\n# Review the epic...\n\n# Break into tasks and push to GitHub\n/pm:epic-oneshot memory-system\n# Creates issues: #1234 (epic), #1235, #1236 (tasks)\n\n# Start development on a task\n/pm:issue-start 1235\n# Agent begins work, maintains local progress\n\n# Sync progress to GitHub\n/pm:issue-sync 1235\n# Updates posted as issue comments\n\n# Check overall status\n/pm:epic-show memory-system\n```\n\n## Get Started Now\n\n### Quick Setup (2 minutes)\n\n1. **Install this repository into your project**:\n\n   #### Unix/Linux/macOS\n\n   ```bash\n   cd path/to/your/project/\n   curl -sSL https://automaze.io/ccpm/install | bash\n   # or: wget -qO- https://automaze.io/ccpm/install | bash\n   ```\n\n   #### Windows (PowerShell)\n   ```bash\n   cd path/to/your/project/\n   iwr -useb https://automaze.io/ccpm/install | iex\n   ```\n   \u003e ⚠️ **IMPORTANT**: If you already have a `.claude` directory, clone this repository to a different directory and copy the contents of the cloned `.claude` directory to your project's `.claude` directory.\n\n   See full/other installation options in the [installation guide ›](https://github.com/automazeio/ccpm/tree/main/install)\n\n\n2. **Initialize the PM system**:\n   ```bash\n   /pm:init\n   ```\n   This command will:\n   - Install GitHub CLI (if needed)\n   - Authenticate with GitHub\n   - Install [gh-sub-issue extension](https://github.com/yahsan2/gh-sub-issue) for proper parent-child relationships\n   - Create required directories\n   - Update .gitignore\n\n3. **Create `CLAUDE.md`** with your repository information\n   ```bash\n   /init include rules from .claude/CLAUDE.md\n   ```\n   \u003e If you already have a `CLAUDE.md` file, run: `/re-init` to update it with important rules from `.claude/CLAUDE.md`.\n\n4. **Prime the system**:\n   ```bash\n   /context:create\n   ```\n\n\n\n### Start Your First Feature\n\n```bash\n/pm:prd-new your-feature-name\n```\n\nWatch as structured planning transforms into shipped code.\n\n## Local vs Remote\n\n| Operation | Local | GitHub |\n|-----------|-------|--------|\n| PRD Creation | ✅ | — |\n| Implementation Planning | ✅ | — |\n| Task Breakdown | ✅ | ✅ (sync) |\n| Execution | ✅ | — |\n| Status Updates | ✅ | ✅ (sync) |\n| Final Deliverables | — | ✅ |\n\n## Technical Notes\n\n### GitHub Integration\n- Uses **gh-sub-issue extension** for proper parent-child relationships\n- Falls back to task lists if extension not installed\n- Epic issues track sub-task completion automatically\n- Labels provide additional organization (`epic:feature`, `task:feature`)\n\n### File Naming Convention\n- Tasks start as `001.md`, `002.md` during decomposition\n- After GitHub sync, renamed to `{issue-id}.md` (e.g., `1234.md`)\n- Makes it easy to navigate: issue #1234 = file `1234.md`\n\n### Design Decisions\n- Intentionally avoids GitHub Projects API complexity\n- All commands operate on local files first for speed\n- Synchronization with GitHub is explicit and controlled\n- Worktrees provide clean git isolation for parallel work\n- GitHub Projects can be added separately for visualization\n\n---\n\n## Support This Project\n\nClaude Code PM was developed at [Automaze](https://automaze.io) **for developers who ship, by developers who ship**.\n\nIf Claude Code PM helps your team ship better software:\n\n- ⭐ **[Star this repository](https://github.com/automazeio/ccpm)** to show your support\n- 🐦 **[Follow @aroussi on X](https://x.com/aroussi)** for updates and tips\n\n\n---\n\n\u003e [!TIP]\n\u003e **Ship faster with Automaze.** We partner with founders to bring their vision to life, scale their business, and optimize for success.\n\u003e **[Visit Automaze to book a call with me ›](https://automaze.io)**\n\n---\n\n## Star History\n\n![Star History Chart](https://api.star-history.com/svg?repos=automazeio/ccpm)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautomazeio%2Fccpm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fautomazeio%2Fccpm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautomazeio%2Fccpm/lists"}