CCPM - Claude Code Project Management

A lean, powerful Claude Code plugin for project management with Linear integration, smart agents, and visual context support.

Author: duongdev (@duongdev) License: MIT Repository: github.com/duongdev/ccpm

What is CCPM?

CCPM streamlines your development workflow with intelligent automation:

Natural workflow - 6 core commands for your entire development lifecycle
Smart agents - Context-aware automatic agent selection and delegation
Linear integration - Automatic issue tracking with 50-60% token reduction
Visual context - Figma designs and image analysis for pixel-perfect UI
Tool-agnostic - Supports Linear, Jira, Confluence via abstraction layer
Safety-first - Explicit confirmation for external system writes

Quick Start

Installation

# Add the CCPM marketplace
/plugin marketplace add duongdev/ccpm

# Install the plugin
/plugin install ccpm

# Verify installation
/ccpm:status

Configure Your First Project

# Initialize CCPM in your project
/ccpm:init

# Or add project manually
/ccpm:project:add my-app

# Set as active project
/ccpm:project:set my-app

Basic Workflow

# 1. Plan your task
/ccpm:plan "Add user authentication"

# 2. Start working
/ccpm:work

# 3. Save progress
/ccpm:sync

# 4. Commit changes
/ccpm:commit

# 5. Run quality checks
/ccpm:verify

# 6. Finalize and create PR
/ccpm:done

Commands Reference

Core Workflow Commands

Command	Description	Example
`/ccpm:plan`	Create and plan tasks with deep research	`/ccpm:plan "Add OAuth2 login"`
`/ccpm:work`	Start or resume implementation	`/ccpm:work` or `/ccpm:work PSN-29`
`/ccpm:sync`	Save progress to Linear	`/ccpm:sync "Implemented endpoints"`
`/ccpm:commit`	Git commit with conventional format	`/ccpm:commit`
`/ccpm:verify`	Run quality checks and code review	`/ccpm:verify`
`/ccpm:done`	Create PR and finalize task	`/ccpm:done`

Planning Variants

Command	Description	Example
`/ccpm:plan:quick`	Fast planning with minimal research	`/ccpm:plan:quick "Fix button"`
`/ccpm:plan:deep`	Comprehensive research and analysis	`/ccpm:plan:deep PSN-29`

Work Variants

Command	Description	Example
`/ccpm:work:parallel`	Execute independent tasks simultaneously	`/ccpm:work:parallel PSN-29`

Utility Commands

Command	Description	Example
`/ccpm:status`	Show project and task status	`/ccpm:status`
`/ccpm:search`	Search Linear issues	`/ccpm:search auth --status="In Progress"`
`/ccpm:history`	Activity timeline (git + Linear)	`/ccpm:history --days=7`
`/ccpm:branch`	Smart git branch management	`/ccpm:branch PSN-29`
`/ccpm:review`	Multi-perspective code review	`/ccpm:review --staged --multi`
`/ccpm:rollback`	Undo recent operations safely	`/ccpm:rollback --git`
`/ccpm:chain`	Execute command chains	`/ccpm:chain full PSN-123`
`/ccpm:init`	Initialize CCPM in a project	`/ccpm:init`
`/ccpm:org-docs`	Organize repository documentation	`/ccpm:org-docs`
`/ccpm:figma-refresh`	Refresh Figma design cache	`/ccpm:figma-refresh PSN-123`

Project Configuration

Command	Description	Example
`/ccpm:project:add`	Add a new project	`/ccpm:project:add my-app`
`/ccpm:project:list`	List all projects	`/ccpm:project:list`
`/ccpm:project:show`	Show project details	`/ccpm:project:show my-app`
`/ccpm:project:set`	Set active project	`/ccpm:project:set my-app`
`/ccpm:project:update`	Update project config	`/ccpm:project:update my-app`
`/ccpm:project:delete`	Remove a project	`/ccpm:project:delete old-app`

Key Features

Smart Agent System

CCPM automatically selects and invokes specialized agents based on your task:

Agent	Purpose
`frontend-developer`	React/UI components, styling, accessibility
`backend-architect`	APIs, NestJS, databases, authentication
`code-reviewer`	Quality review, security, best practices
`security-auditor`	OWASP Top 10, vulnerability detection
`debugger`	Systematic debugging and investigation
`tdd-orchestrator`	Test-driven development workflow
`linear-operations`	Optimized Linear API operations (cached)

Agent selection is automatic based on:

Keywords in your message (+10 per match)
Task type alignment (+20)
Tech stack relevance (+15)
Project-specific agents (+25 priority)

Linear Integration

All Linear operations are automatic and optimized:

No confirmation needed - Linear is internal tracking
50-60% token reduction - Session-level

...

duongdev/ccpm

README