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

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

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

# Install the plugin
/plugin install ccpm

# Verify installation
/ccpm:status

# 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

# 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

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

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)

All Linear operations are automatic and optimized:

• No confirmation needed - Linear is internal tracking
• 50-60% token reduction - Session-level caching
• 85-95% cache hit rate - Teams, labels, statuses cached
• Auto-detection - Issue ID extracted from git branch

# Branch naming enables auto-detection
git checkout -b feature/PSN-29-add-auth

# Now all commands auto-detect PSN-29
/ccpm:work    # Works on PSN-29
/ccpm:sync    # Syncs PSN-29
/ccpm:done    # Finalizes PSN-29

CCPM supports visual context for pixel-perfect UI implementation:

Figma Integration:

• Automatic design system extraction
• Color palette to Tailwind class mapping
• Typography and spacing conversion
• Cached in Linear for performance

Image Analysis:

• UI mockups analyzed during planning
• Screenshots passed to implementation agents
• 95-100% design fidelity (vs 70-80% text-based)

# Refresh Figma cache after designer updates
/ccpm:figma-refresh PSN-123

# Run comprehensive review from multiple perspectives
/ccpm:review --staged --multi

Perspectives analyzed:

• Code Quality - Bugs, style, complexity
• Security - OWASP Top 10, injection flaws
• Architecture - Patterns, coupling, scalability
• UX/Accessibility - A11y, responsive design

Execute workflow templates or custom chains:

# Built-in templates
/ccpm:chain full PSN-123       # plan -> work -> verify -> commit -> done
/ccpm:chain bugfix PSN-456     # work -> commit -> verify
/ccpm:chain ship               # verify -> done
/ccpm:chain morning            # status; search --mine

# Custom chains
/ccpm:chain "/ccpm:verify && /ccpm:done"

CCPM includes intelligent hooks that run automatically:

CCPM stores configuration in ~/.claude/ccpm-config.yaml:

version: "1.0"
default_project: my-app

projects:
  my-app:
    name: "My Application"
    path: /path/to/my-app
    linear:
      team: "Engineering"
      project: "My App"
    git:
      protected_branches:
        - main
        - production
      branch_prefix: feature/

# Use a template when adding projects
/ccpm:project:add my-app --template fullstack-with-jira
/ccpm:project:add lib --template simple-linear
/ccpm:project:add oss-project --template open-source

CCPM includes installable skills for extended functionality:

CCPM follows strict safety rules:

Automatic (no confirmation):

• Linear operations (internal tracking)
• Local file operations
• Git operations (except push)

Requires confirmation:

• External PM systems (Jira, Azure DevOps)
• Documentation platforms (Confluence, Notion)
• Team communication (Slack, Teams)
• Push operations to remote

# Verify plugin is installed
/plugin list

# Reinstall if needed
/plugin install ccpm --force

• Check Linear MCP server is running
• Verify team/project names match exactly
• Use /ccpm:status to check connection

# Check hook permissions
chmod +x ~/.claude/plugins/ccpm/hooks/scripts/*.sh
chmod +x ~/.claude/plugins/ccpm/hooks/scripts/*.cjs

# Check what agents are discovered
cat /tmp/ccpm-session-*.json | jq '.agents'

When session ends with uncommitted changes, CCPM warns you:

# Commit your changes
/ccpm:commit

# Or rollback if needed
/ccpm:rollback --files

ccpm/
├── commands/           # 19 slash commands
├── agents/             # 17 specialized agents
├── helpers/            # 22 reusable utilities
├── hooks/              # 6 intelligent hooks
├── skills/             # 17 installable skills
├── scripts/            # Helper scripts
└── .claude-plugin/     # Plugin manifest

# Plan with deep research
/ccpm:plan:deep "Implement OAuth2 with Google, GitHub, and email login"

# Start implementation (agent selection is automatic)
/ccpm:work

# Save progress periodically
/ccpm:sync "Completed Google OAuth"

# Review your code
/ccpm:review --staged --multi

# Commit when ready
/ccpm:commit

# Final verification
/ccpm:verify

# Create PR and finalize
/ccpm:done

# Fast planning for simple fix
/ccpm:plan:quick "Fix null pointer in user service"

# Work and commit
/ccpm:work
/ccpm:commit

# Quick verify and ship
/ccpm:chain ship

# Get overview of your work
/ccpm:chain morning

# Or manually
/ccpm:status
/ccpm:search --mine --status="In Progress"

# Wrap up and save progress
/ccpm:sync "EOD: Completed auth module, tests pending"
/ccpm:commit

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Follow existing code patterns
4. Submit a pull request

• Issues: GitHub Issues
• Documentation: This README and inline command help

MIT License - see LICENSE for details.