{"id":30415626,"url":"https://github.com/automazeio/ccpm","last_synced_at":"2026-10-18T20:06:52.430Z","repository":{"id":310807091,"uuid":"1040397982","full_name":"automazeio/ccpm","owner":"automazeio","description":"Project management skill system for Agents that uses GitHub Issues and Git worktrees for parallel agent execution.","archived":false,"fork":false,"pushed_at":"2026-03-18T12:15:24.000Z","size":1654,"stargazers_count":8411,"open_issues_count":6,"forks_count":848,"subscribers_count":41,"default_branch":"main","last_synced_at":"2026-10-17T07:10:32.366Z","etag":null,"topics":["ai-agents","ai-coding","claude","claude-code","project-management","vibe-coding"],"latest_commit_sha":null,"homepage":"https://automaze.io","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":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"accessibility":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"claude":null,"gemini":null,"cursor":null,"copilot":null,"dco":null,"cla":null,"disclosure":null}},"created_at":"2025-08-18T23:20:08.000Z","updated_at":"2026-10-17T05:35:55.000Z","dependencies_parsed_at":"2026-10-17T04:17:28.931Z","dependency_job_id":null,"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":344872684,"owners_count":38341179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-18T02:00:06.448Z","response_time":63,"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":"2026-10-18T20:06:52.410Z","avatar_url":"https://github.com/automazeio.png","language":"Shell","funding_links":[],"categories":["Development \u0026 Engineering","Agent Orchestration","AI Coding Agents","Shell","Uncategorized","Skills, Hooks, and MCP for Coordination","Tools \u0026 Utilities","🎯 Project Management \u0026 Orchestration","Project Management \u0026 Workflows","AI Agent Frameworks \u0026 SDKs","HarmonyOS","AI编程任务管理","Repos","Plugins","Productivity \u0026 Workflow","Catalog","工作流程与知识指南 🧠","Project \u0026 Knowledge Management"],"sub_categories":["Core Development Skills","Obsidian","Claude Code","Uncategorized","📖 Community Guides \u0026 Tutorials","Claude Code Project Management (CCPM)","Orchestration Frameworks","Windows Manager","Data Visualization","All Plugins","Context \u0026 Working-State Engineering","通用","Other IDEs"],"readme":"# CCPM – The Project Manager Agent\n\n[![Agent Skills](https://img.shields.io/badge/Agent_Skills-compatible-4b3baf)](https://agentskills.io)\n\u0026nbsp;\n[![Eval Score](https://img.shields.io/badge/eval_score-100%25-brightgreen)](#proven-results)\n\u0026nbsp;\n[![GitHub Issues](https://img.shields.io/badge/+-GitHub%20Issues-1f2328)](https://github.com/automazeio/ccpm)\n\u0026nbsp;\n[![MIT License](https://img.shields.io/badge/License-MIT-28a745)](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### Spec-driven development for AI agents – ship ~~faster~~ _better_ using PRDs, GitHub issues, and multiple agents running in parallel.\n\nStop losing context. Stop blocking on tasks. Stop shipping bugs. CCPM gives your AI agent a structured PM brain: turn ideas into PRDs, PRDs into epics, epics into GitHub issues, and issues into production code — with full traceability at every step.\n\n---\n\n\u003e [!IMPORTANT]\n\u003e 📢 **CCPM is now an AGENT SKILL!** It works with any [Agent Skills–compatible](https://agentskills.io) harness that supports skills: **Claude Code, Codex, OpenCode, Factory, Amp, Cursor, and more.**\n\n---\n\n![CCPM](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- [The Parallel Execution System](#the-parallel-execution-system)\n- [Key Features \u0026 Benefits](#key-features--benefits)\n- [Install](#install)\n- [Usage](#usage)\n- [Workflow Phases](#workflow-phases)\n- [Skill Structure](#skill-structure)\n- [Example Flow](#example-flow)\n- [Proven Results](#proven-results)\n- [Local vs Remote](#local-vs-remote)\n- [Technical Notes](#technical-notes)\n- [Who's Behind this Project](#whos-behind-this-project)\n\n---\n\n\u003e [!NOTE]\n\u003e Check out **[proof](https://github.com/automazeio/proof)** to get your agents capture visual proof of work of terminal output, browser interactions, and mobile simulator recordings.\n\n---\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 agents touch the same code\n- **Requirements drift** as verbal decisions override written specs\n- **Progress becomes invisible** until the very end\n\nCCPM solves all of that.\n\n---\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\n\n```\n\"I want to build a notification system — where do we start?\"\n→ Guided brainstorming + PRD creation\n\n\"break down the notification-system epic\"\n→ Parallelizable task files with dependencies\n\n\"sync the notification-system epic to GitHub\"\n→ Epic issue + sub-issues + worktree\n\n\"start working on issue 42\"\n→ Parallel stream analysis + multiple agents launched\n\n\"what's our standup for today?\"\n→ Instant report from project files\n```\n\n---\n\n## What Makes This Different\n\n| Traditional AI Development | CCPM |\n|---|---|\n| Context lost between sessions | **Persistent context** across all work |\n| One agent, one task | **Parallel agents** on independent streams |\n| Vibe coding from memory | **Spec-driven** with full traceability |\n| Progress hidden in chat logs | **Transparent audit trail** in GitHub |\n| Scattered status updates | **Structured standup, blocked, next** |\n\n---\n\n## Why GitHub Issues\n\nMost AI coding workflows operate in isolation — a single session with no shared state. CCPM uses GitHub Issues as the source of truth, which unlocks something fundamentally different:\n\n**Team collaboration** — multiple agents (or humans) work on the same project simultaneously. Progress is visible in real-time through issue comments.\n\n**Seamless handoffs** — an agent can start a task, a human can finish it, or vice versa. No \"what did the AI do?\" meetings.\n\n**Single source of truth** — no separate databases or project management tools. Issue state is project state. Comments are the audit trail.\n\n**Works with what you have** — no dependency on GitHub Projects. Integrates with existing labels, milestones, and PR workflows.\n\n---\n\n## Core Principle: No Vibe Coding\n\n\u003e **Every line of code must trace back to a specification.**\n\nCCPM enforces 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---\n\n## The Parallel Execution System\n\n### Issues Aren't Atomic\n\nTraditional thinking: **one issue = one agent = one task**\n\nReality: a single \"Implement user authentication\" issue is actually:\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| Approach | Agents working | Wall time |\n|---|---|---|\n| Traditional (serial) | 1 | 5x |\n| CCPM (parallel streams) | 5 | 1x |\n\n### Context Stays Clean\n\nEach agent handles its own context in isolation. Your main conversation becomes the conductor — it never drowns in implementation details. Agents read from `.claude/epics/` and commit progress back through Git.\n\n---\n\n## Key Features \u0026 Benefits\n\n**🧠 Context preservation** — project state lives in files, not in your head or chat history. Start a session anywhere, any time.\n\n**⚡ Parallel execution** — tasks marked `parallel: true` run concurrently across multiple agents without conflicts.\n\n**🔗 GitHub native** — works with tools your team already uses. No dependency on the Projects API.\n\n**📊 Full traceability** — every decision documented. PRD → Epic → Task → Issue → Code → Commit.\n\n**🤖 Deterministic ops run as scripts** — status, standup, search, validate all run as bash scripts: fast, consistent, no LLM token cost.\n\n**🌐 Harness-agnostic** — follows the [agentskills.io](https://agentskills.io) open standard. Works with Factory, Claude Code, Amp, OpenCode, Codex, Cursor, and more.\n\n---\n\n## Install\n\nCCPM is a standard [Agent Skill](https://agentskills.io). Point your harness at `skill/ccpm/` — that's it.\n\n### Clone the repo\n\n```bash\ngit clone https://github.com/automazeio/ccpm.git\n```\n\n### Factory / Droid\n\n```bash\n# Symlink into your skills directory\nln -s /path/to/ccpm/skill/ccpm ~/.factory/skills/ccpm\n```\n\n### Claude Code\n\nIn your project root, add a `skills/` directory and symlink or copy the skill:\n\n```bash\nln -s /path/to/ccpm/skill/ccpm .claude/skills/ccpm\n```\n\n### Any other Agent Skills–compatible harness\n\nPoint it at `skill/ccpm/`. It follows the [agentskills.io](https://agentskills.io) standard and works out of the box.\n\n### Prerequisites\n\n- `git` and `gh` CLI (authenticated: `gh auth login`)\n- A GitHub repository for your project\n\n---\n\n## Usage\n\nCCPM activates automatically when your agent detects PM intent. Just talk naturally — no special syntax needed.\n\n### Natural language triggers\n\n| What you say | What happens |\n|---|---|\n| \"I want to build X\" / \"let's plan X\" | Brainstorming + PRD creation |\n| \"parse the X PRD\" / \"create an epic for X\" | PRD → technical epic |\n| \"break down the X epic\" | Epic decomposition into tasks |\n| \"sync the X epic to GitHub\" | Issues created, worktree set up |\n| \"start working on issue N\" | Analysis + parallel agents launched |\n| \"standup\" / \"what's our status\" | Bash script runs instantly |\n| \"what's next\" / \"what's blocked\" | Priority queue from project files |\n| \"close issue N\" | Local + GitHub updated |\n| \"merge the X epic\" | Tests, merge, cleanup |\n\n---\n\n## Workflow Phases\n\n### 1. Plan — Capture requirements\n\n```\n\"I want to build a notification system — push, email, and in-app\"\n```\n\nCCPM conducts guided brainstorming before writing anything. It asks about the problem, users, success criteria, constraints, and what's out of scope — then creates a structured PRD at `.claude/prds/\u003cname\u003e.md`.\n\nWhen ready: \"parse the notification-system PRD\" → produces a technical epic at `.claude/epics/notification-system/epic.md` with architecture decisions, technical approach, and task preview.\n\n### 2. Structure — Break it down\n\n```\n\"break down the notification-system epic into tasks\"\n```\n\nEach task gets a file with acceptance criteria, effort estimate, `depends_on`, `parallel`, and `conflicts_with` metadata. Tasks are intelligently batched for parallel creation. ≤10 tasks per epic by default.\n\n### 3. Sync — Push to GitHub\n\n```\n\"sync the notification-system epic to GitHub\"\n```\n\nCreates an epic issue, creates sub-issues for each task, renames local files to match GitHub issue numbers, sets up a dedicated worktree (`../epic-notification-system/`), and creates a mapping file for reference.\n\n### 4. Execute — Start building\n\n```\n\"start working on issue 42\"\n```\n\nAnalyzes the issue for independent work streams, launches parallel agents scoped to their own files, and sets up progress tracking. Each agent commits with `Issue #N: description` and coordinates through Git.\n\n### 5. Track — Know where things stand\n\n```\n\"standup\" / \"what's blocked\" / \"what's next\"\n```\n\nAll tracking operations run as bash scripts — instant output, no LLM overhead. The scripts scan `.claude/epics/` and report what's in progress, what's next, and what's blocked.\n\n---\n\n## Skill Structure\n\n```\nskill/ccpm/\n├── SKILL.md                  # Entry point — detects intent, routes to reference\n└── references/\n    ├── plan.md               # PRD writing + parsing to epic\n    ├── structure.md          # Epic decomposition into tasks\n    ├── sync.md               # GitHub sync, progress comments, close, merge\n    ├── execute.md            # Issue analysis + parallel agent launch\n    ├── track.md              # Status, standup, search, next, blocked\n    ├── conventions.md        # File formats, frontmatter schemas, git rules\n    └── scripts/              # Bash scripts for deterministic operations\n        ├── status.sh\n        ├── standup.sh\n        ├── epic-list.sh\n        ├── search.sh\n        └── ...               # 14 scripts total\n```\n\nYour project files live in `.claude/` in your project root:\n\n```\n.claude/\n├── prds/                     # Product requirement documents\n├── epics/\n│   └── \u003cfeature\u003e/\n│       ├── epic.md           # Technical epic\n│       ├── \u003cN\u003e.md            # Task files (named by GitHub issue number after sync)\n│       ├── \u003cN\u003e-analysis.md   # Parallel work stream analysis\n│       └── updates/          # Agent progress tracking\n└── (archived epics)\n```\n\nFiles are the source of truth — plain markdown that lives in your repo, no external services.\n\n---\n\n## Example Flow\n\n```\nYou: \"I want to build a payment integration with Stripe — subscriptions and one-time charges\"\n\nCCPM: Asks 5 clarifying questions about scope, users, success criteria...\n\nYou: [answers]\n\nCCPM: ✅ PRD created: .claude/prds/payment-integration.md\n      Ready to create the technical epic?\n\nYou: \"yes, parse it\"\n\nCCPM: ✅ Epic created: .claude/epics/payment-integration/epic.md\n      8 task categories identified. Ready to decompose?\n\nYou: \"break it down\"\n\nCCPM: ✅ Created 7 tasks — 5 parallel, 2 sequential\n      Ready to push to GitHub?\n\nYou: \"sync it\"\n\nCCPM: ✅ Epic #1234 created\n      ✅ 7 sub-issues created (#1235–#1241)\n      ✅ Worktree: ../epic-payment-integration/\n\nYou: \"start working on issue 1235\"\n\nCCPM: Analyzed 3 parallel streams:\n      Stream A: Stripe client setup ✓ Started\n      Stream B: Webhook handler ✓ Started\n      Stream C: Database models ⏸ Waiting on A\n\nYou: \"what's our standup?\"\n\nCCPM: [runs standup.sh instantly]\n      📅 Daily Standup — 2026-03-18\n      🔄 In Progress: Issue #1235 (payment-integration) — 60%\n      ⏭️ Next: Issue #1236 — Subscription billing logic\n      📊 Tasks: 2 in progress, 5 open, 0 closed\n```\n\n---\n\n## Proven Results\n\nTeams using this system report:\n- **89% less time** lost to context switching\n- **5–8 parallel tasks** vs 1 previously\n- **75% reduction** in bug rates — due to detailed task breakdown before coding\n- **Up to 3× faster** feature delivery\n\n### Benchmark\n\nIn structured evals comparing CCPM-equipped agents vs baseline (no skill):\n\n| Scenario | With CCPM | Without |\n|---|---|---|\n| PRD creation (brainstorm-first, correct paths) | ✅ 4/4 | ❌ 2/4 |\n| Issue execution (analysis + worktree checks) | ✅ 4/4 | ❌ 0/4 |\n| Standup (runs script, real data) | ✅ 3/3 | ❌ 1/3 |\n| **Overall** | **100%** | **27.7%** |\n\n---\n\n## Local vs Remote\n\n| Operation | Local | GitHub |\n|---|---|---|\n| PRD creation | ✅ | — |\n| Implementation planning | ✅ | — |\n| Task breakdown | ✅ | ✅ (on sync) |\n| Execution | ✅ | — |\n| Progress updates | ✅ | ✅ (on sync) |\n| Final deliverables | — | ✅ |\n\n---\n\n## Technical Notes\n\n**GitHub integration** — uses `gh-sub-issue` extension for proper parent-child relationships. Falls back to task lists if not installed. Install with: `gh extension install yahsan2/gh-sub-issue`\n\n**File naming** — tasks start as `001.md`, `002.md` during decomposition. After GitHub sync, renamed to `{issue-id}.md` (e.g. `1234.md`). Issue #1234 = file `1234.md`.\n\n**Design decisions** — intentionally avoids GitHub Projects API complexity. All operations work on local files first for speed. GitHub sync is explicit and controlled. Worktrees provide clean git isolation for parallel work.\n\n**Looking for v1?** — The original `/pm:*` Claude Code slash command system is preserved on the [`v1` branch](https://github.com/automazeio/ccpm/tree/v1).\n\n---\n\n## Who's behind this project\n\nCCPM was developed at [Automaze](https://automaze.io) **for developers who ship, by developers who ship**.\n\nIf CCPM 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\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 ›](https://automaze.io)**\n\n---\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"}