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:
duongdev