PM Workflow Guide

This skill helps you navigate CCPM's 49+ commands by automatically detecting your current workflow phase and suggesting the most appropriate commands.

Natural Workflow Commands (RECOMMENDED)

Start here! CCPM provides 6 simple, chainable commands that cover the complete workflow:

Quick Reference Card

Planning      → /ccpm:plan "title"              Create & plan a new task
Working       → /ccpm:work                       Start/resume implementation
Progressing   → /ccpm:sync "summary"             Save progress to Linear
Committing    → /ccpm:commit                     Create git commit (conventional)
Verifying     → /ccpm:verify                     Run quality checks
Finalizing    → /ccpm:done                       Create PR & finalize

Complete Workflow Examples

Example 1: New feature from scratch

/ccpm:plan "Add two-factor authentication" my-app
/ccpm:work                                # Start implementation
/ccpm:sync "Implemented authenticator logic"
/ccpm:commit                              # Auto-formats: feat(auth): implement 2FA
/ccpm:verify                              # Run tests, linting, build
/ccpm:done                                # Create PR and finalize

Example 2: Fixing a bug

/ccpm:plan BUG-456                        # Plan existing bug ticket
/ccpm:work                                # Resume where you left off
/ccpm:sync "Fixed race condition"
/ccpm:commit                              # Auto-formats: fix(cache): prevent race condition
/ccpm:verify                              # Ensure fix doesn't break tests
/ccpm:done                                # Ship the fix

Example 3: Documentation update

/ccpm:plan "Update API documentation" my-app
/ccpm:work
/ccpm:sync "Added deployment guide"
/ccpm:commit                              # Auto-formats: docs(api): add deployment guide
/ccpm:verify
/ccpm:done

Command Details

/ccpm:plan - Smart planning
- Create new task: /ccpm:plan "title" <project>
- Plan existing issue: /ccpm:plan <issue-id>
- Update plan: /ccpm:plan <issue-id> "changes"
/ccpm:work - Smart work
- Auto-detects: Not started → start, In progress → resume
- Auto-detects issue from git branch name
/ccpm:sync - Save progress
- Auto-detects issue from git branch
- Shows git changes summary
- Updates Linear with findings
/ccpm:commit - Git integration
- Conventional commits format (feat/fix/docs/refactor/etc)
- Links commits to Linear issues automatically
- Example: fix(auth): handle token expiration
/ccpm:verify - Quality checks
- Auto-detects issue from branch
- Runs tests, linting, build checks sequentially
- Fails fast if checks don't pass
/ccpm:done - Finalize
- Pre-flight safety checks
- Creates PR with auto-generated description
- Syncs Linear status to Jira
- Requires confirmation for external writes (safety)

When to Use Project Configuration Commands

The 6 natural commands cover 90% of workflows. Use project configuration commands for:

Project setup: /ccpm:project:add (add new project)
Project management: /ccpm:project:list, /ccpm:project:show (view projects)
Project switching: /ccpm:project:set (switch active project)
Design refresh: /ccpm:figma-refresh (refresh Figma design cache)

Instructions

Automatic Phase Detection

This skill activates when user mentions workflow-related keywords and provides context-aware command suggestions.

Planning Phase

Trigger phrases:

"plan this task"
"create new task/epic/feature"
"write a spec"
"gather requirements"
"need to understand..."
"starting a new project"

Recommended commands:

Natural command → /ccpm:plan "Task title" <project>
- Simple, chainable planning
- Creates Linear issue
- Gathers context from Jira/Confluence/Slack
- Analyzes codebase
- Generates comprehensive plan
Plan existing issue → /ccpm:plan <issue-id>
- Plans an existing Linear issue
- Gathers context and generates checklist
- Use when issue already exists
Update existing plan → /ccpm:plan <issue-id> "changes"
- Requirements changed during implementation
- Interactive clarification
- Impact analysis
- Updates plan with changes

Example conversation:

User: "I need to plan the new user authentication feature"

Claude: [pm-workflow-guide activates]

I'll help you plan this. Here's what to use:

1. NEW TASK → /ccpm:plan "User authentication" my-app
2. EXISTING ISSUE → /ccpm:plan <issue-id>
3. QUICK INTERNAL → /ccpm:plan "task" my-app

The first option is recommended - it's simple and chainable!

Which applies to your situation?

Spec Management Phase

Trigger phrases:

"write a spec"
"need architecture document"
"document this feature"
"create epic/feature"
"requirements doc"

Recommended commands:

Plan the work → /ccpm:plan "Task title" <project>
- Creates Linear issue with comprehensive plan
- Gathers context from Jira/Confluence/Slack
- Analyzes codebase
- Generates implementation checklist
Update plan with details → /ccpm:plan <issue-id> "additional requirements"
- Add architecture details
- Specify API design requirements
- Document data model needs
- Add testing and security considerations

Example conversation:

User: "Let's implement the payment gateway integration"

Claude: [pm-workflow-guide activates]

⚠️ This sounds like a complex feature that needs planning first.

Recommended workflow:
1. /ccpm:plan "Payment Gateway Integration" my-app
2. Review the plan (architecture, security, API design)
3. Update plan if needed: /ccpm:plan <issue-id> "additional details"
4. Then start implementation: /ccpm:work

Would you like to start with planning?

Implementation Phase

Trigger phrases:

"start coding"
"begin implementation"
"let's build this"
"what should I work on"
"ready to code"
"save my progress"
"commit this code"

Recommended commands:

Natural command → /ccpm:work
- Start or resume implementation
- Auto-detects issue from git branch
- Fetches full task context
- Lists available agents
- Coordinates parallel work
Save progress → /ccpm:sync "summary"
- Save work-in-progress to Linear
- Auto-detects issue from git branch
- Documents changes made
- Updates Linear context
- Maintains full history
Commit code → /ccpm:commit
- Create conventional git commit
- Auto-formats commit message
- Links to Linear issue
- Example: feat(auth): add 2FA support

Example conversation:

User: "Let's start working on AUTH-123"

Claude: [pm-workflow-guide activates]

Perfect! Use the natural workflow:

/ccpm:work                    # Start implementation (auto-detects AUTH-123)
/ccpm:sync "progress note"    # Save progress as you work
/ccpm:commit                  # Create conventional commits
/ccpm:verify                  # Check quality when done
/ccpm:done                    # Create PR and finalize

Start with: /ccpm:work
Ready to proceed?

Verification Phase

Trigger phrases:

"ready to test"
"done coding"
"check my work"
"run quality checks"
"verify implementation"

Recommended commands:

Natural command → /ccpm:verify
- Run all quality checks
- Auto-detects issue from git branch
- Runs tests, linting, build checks
- Comprehensive code review
- Final approval when passing

Example conversation:

User: "I'm done implementing, ready to test"

Claude: [pm-workflow-guide activates]

Perfect! Let's verify your work:

/ccpm:verify

This will:
✓ Run all automated checks (tests, linting, build)
✓ Perform comprehensive code review
✓ Security audit
✓ Performance check
✓ Final approval when passing

Ready to proceed?

Completion Phase

Trigger phrases:

"ready to merge"
"ship it"
"create PR"
"deploy this"
"mark as complete"

Recommended commands:

Natural command → /ccpm:done
- Auto-detects issue from git branch
- Creates PR with auto-generated description
- Syncs Linear status to Jira
- Sends Slack notification
- Marks Linear issue complete
- Requires confirmation for external writes (safety)

Example conversation:

User: "Everything looks good, ready to ship!"

Claude: [pm-workflow-guide + external-system-safety activate]

Perfect! Let's finalize:

/ccpm:done

This will:
1. Create BitBucket PR with auto-description
2. Update Linear status to "Complete"
3. Sync Jira status to "Done"
4. Send Slack notification to team

⚠️ Note: External system writes require your confirmation

Ready to proceed?

Utility Commands (Context-Aware)

When user asks "what's the status" → /ccpm:work <linear-issue-id>

Shows current Linear status
Formatted display
Progress indicators

When user asks "load this task" → /ccpm:work <linear-issue-id>

Quick context loading
Fetches issue details
Identifies related files
Sets up environment

When user asks "what's available" → /ccpm:work

Lists all available agents
Shows capabilities
From CLAUDE.md

When user asks "how complex" → /ccpm:work <linear-issue-id>

AI-powered analysis
Complexity assessment
Risk identification
Timeline estimation

When user asks "what depends on what" → /ccpm:work <linear-issue-id>

Visualizes dependencies
Shows execution order
Identifies blockers

When user asks "show progress" → /ccpm:sync <project>

Progress across all tasks
Team velocity
Burndown charts

When user asks "search tasks" → /ccpm:work <project> "<query>"

Text search in Linear
Lists matching tasks
Quick access

When user is stuck → /ccpm:work [issue-id]

Context-aware help
Command suggestions
Workflow guidance

Workflow State Machine

┌─────────────┐
│   IDEA      │ "I need to..."
└──────┬──────┘
       │ /ccpm:plan (for epics/features)
       │ /ccpm:plan (for tasks)
       ▼
┌─────────────┐
│  PLANNED    │ "Plan is ready"
└──────┬──────┘
       │ /ccpm:work
       ▼
┌─────────────┐
│IMPLEMENTING │ "Working on it"
└──────┬──────┘
       │ /ccpm:verify
       ▼
┌─────────────┐
│  VERIFYING  │ "Testing & reviewing"
└──────┬──────┘
       │ /ccpm:verify
       ▼
┌─────────────┐
│  VERIFIED   │ "All checks passed"
└──────┬──────┘
       │ /ccpm:done
       ▼
┌─────────────┐
│  COMPLETE   │ "Shipped! 🚀"
└─────────────┘

Special Workflows

Repeat Project (BitBucket PR Review)

Trigger phrases:

"check this PR"
"review PR 123"
"analyze pull request"
"Repeat project PR"

Command: /ccpm:repeat:check-pr <pr-number-or-url>

Uses Playwright browser automation
Navigates BitBucket
Analyzes PR changes
Reviews code quality
Provides feedback

UI Design Workflow

Trigger phrases:

"design the UI"
"create mockups"
"need wireframes"

Commands:

/ccpm:plan <issue-id> - Generate multiple design options
/ccpm:plan <issue-id> <option-number> "<feedback>" - Iterate on design
/ccpm:plan <issue-id> <option-number> - Finalize and generate specs

Smart Suggestions Based on Context

If user mentions issue ID directly:

User: "What's the status of AUTH-123?"
Claude: Let me check: /ccpm:work AUTH-123

If user seems lost:

User: "I don't know what to do next with this task"
Claude: Let me help: /ccpm:work <issue-id>

If user mentions external ticket:

User: "I need to plan JIRA-456"
Claude: I'll create a Linear issue and plan it: /ccpm:plan

If user asks about agents:

User: "What agents can help with backend work?"
Claude: Let me show you: /ccpm:work

Integration with Other Skills

This skill works alongside:

external-system-safety: Reminds user about confirmation requirements

Claude: Note: /ccpm:done will require confirmation for:
- Jira status update
- Slack notification

spec-first-development: Encourages spec creation before implementation

Claude: Before using /ccpm:work, consider:
- Does this task have a spec?
- For complex features, use /ccpm:plan first

tdd-practices: Reminds about TDD workflow

Claude: Remember: Write tests first!
The tdd-enforcer hook will block production code without tests.

Error Prevention

Prevent common mistakes:

❌ User: "/ccpm:plan without JIRA ticket" ✅ Claude: "You'll need a Jira ticket ID. Do you have one, or should we use /ccpm:plan?"

❌ User: "/ccpm:work without planning" ✅ Claude: "I don't see a plan for this issue yet. Run /ccpm:plan first."

❌ User: "/ccpm:done before verification" ✅ Claude: "Run /ccpm:verify first to ensure quality checks pass."

Natural Workflow Activation Triggers

This skill activates with high priority when users ask about the natural workflow:

Planning triggers:

"how do I plan"
"start a new task"
"create a task"
"plan something"

Implementation triggers:

"start work" / "start working"
"save my progress"
"commit this" / "create a commit"
"how do I commit"

Verification triggers:

"how do I test"
"verify my work"
"run checks"
"before I ship"

Completion triggers:

"ready to ship"
"create a PR"
"finalize this"
"mark complete"

When these triggers appear, recommend the natural 6-command workflow first.

Learning Mode

For new users, provide extra context:

User: "How do I plan a task?"

Claude: [pm-workflow-guide activates - detects new user]

CCPM has a simple 6-command workflow:

1. /ccpm:plan "task title" <project>   - Create & plan
2. /ccpm:work                           - Start coding
3. /ccpm:sync "summary"                 - Save progress
4. /ccpm:commit                         - Git commit
5. /ccpm:verify                         - Quality checks
6. /ccpm:done                           - Create PR

These commands are chainable and auto-detect your issue from git branch!

For more control, extended commands like /ccpm:plan also available.

Which matches your situation?

(Tip: For complex features, consider /ccpm:plan first)

Examples

Example 1: New Feature from Scratch

User: "I need to implement a new export feature for reports"

Claude: [pm-workflow-guide + spec-first-development activate]

Perfect! Let's use the natural workflow:

/ccpm:plan "Export reports feature" my-app

This will:
✓ Create Linear issue
✓ Gather context from Jira/Slack/Confluence
✓ Analyze codebase
✓ Generate comprehensive plan

Then continue with:
/ccpm:work           # Start coding
/ccpm:sync "notes"   # Save progress
/ccpm:commit         # Git commit
/ccpm:verify         # Quality checks
/ccpm:done           # Create PR & ship

For complex features, add /ccpm:plan before /ccpm:work

Shall I start planning?

Example 2: Mid-Implementation Questions

User: "I'm stuck on this auth task, not sure what to do next"

Claude: [pm-workflow-guide activates]

Let me help! Continue with the natural workflow:

/ccpm:sync "stuck on session management"    # Save progress with note

Then I can help debug and suggest next steps.

What's your issue ID or branch name?

Example 3: Ready to Ship

User: "I think I'm done, how do I finish this?"

Claude: [pm-workflow-guide activates]

Great! Use the natural workflow:

/ccpm:verify          # Run all quality checks

Once passing, continue:

/ccpm:done            # Create PR, sync Jira, ship

That's it! The natural workflow handles everything.

Ready to verify?

Command Reference Quick Access

Full command list: /ccpm:work Visual workflow: /ccpm:work Search commands: Ask "what command should I use for..."

Summary

This skill helps you:

✅ Use 6 simple commands for the complete workflow (plan, work, sync, commit, verify, done)
✅ Chain commands naturally - they auto-detect context from git branch
✅ Never worry about options - natural commands make the best choice
✅ Follow optimal workflows - each phase has a clear recommended path
✅ Avoid common mistakes - skill prevents implementing without planning, shipping without verification
✅ Explore 49+ commands when you need more control (extended options always available)

Quick Start: The 6-Command Workflow

/ccpm:plan "title" <project>   →  Create and plan a task
/ccpm:work                     →  Start or resume coding
/ccpm:sync "summary"           →  Save progress
/ccpm:commit                   →  Create conventional git commit
/ccpm:verify                   →  Run quality checks
/ccpm:done                     →  Create PR and finalize

That's it! These 6 commands cover 90% of all CCPM workflows. The skill activates automatically when you mention planning, implementation, verification, or completion—providing intelligent suggestions based on your exact context.

For advanced workflows (specs, UI design, multi-agent projects), extended commands are always available.