Natural Workflow Skill

Welcome to CCPM's natural workflow guide! This skill teaches you the 6-command lifecycle that takes you from task creation to completion.

Why Natural Workflow?

CCPM's natural workflow commands (plan, work, sync, commit, verify, done) are designed to feel intuitive and conversational, following the natural progression of development work:

1. Plan the work
2. Work on implementation
3. Sync progress to your team
4. Commit code changes
5. Verify quality
6. Done - complete and create PR

Instead of remembering complex command hierarchies like /ccpm:plan, /ccpm:work, or /ccpm:done, you use simple verbs that match how you think about work.

The 6 Commands

1. /ccpm:plan - Create or Update Task Plans

The starting point for any work. This command intelligently detects what you want to do and helps you plan it.

What it does:

• Creates a new Linear task with a comprehensive implementation plan
• Plans an existing task that doesn't have a plan yet
• Updates an existing plan when requirements change

3 Modes:

# CREATE - New task
/ccpm:plan "Add user authentication"
/ccpm:plan "Fix login button" my-project JIRA-123

# PLAN - Plan existing task
/ccpm:plan PSN-27

# UPDATE - Change the plan
/ccpm:plan PSN-27 "Also add email notifications"

Behind the scenes:

• Auto-detects your project context
• Gathers research from Jira, Confluence, and codebase
• Generates implementation checklist (5-10 specific subtasks)
• Identifies files to modify
• Estimates complexity (low/medium/high)
• Saves everything to Linear

Next command: /ccpm:work

---

2. /ccpm:work - Start or Resume Implementation

Begin coding or resume work on an in-progress task.

What it does:

• Starts implementation if task is planned but not yet started
• Shows progress and next action if work is in progress
• Prevents accidental work on completed tasks

Usage:

# Auto-detect from branch name
/ccpm:work
# Works with branches like: feature/PSN-27-add-auth

# Explicit issue ID
/ccpm:work PSN-27

START mode (fresh task):

• Updates status to "In Progress"
• Analyzes codebase with smart agents
• Creates implementation plan in Linear
• Shows you what to do next

RESUME mode (continue work):

• Shows current progress (% complete)
• Lists remaining checklist items
• Suggests next action
• Shows quick command shortcuts

Next command: /ccpm:sync or /ccpm:commit

---

3. /ccpm:sync - Save Progress to Linear

Keep your team updated by syncing your progress to Linear.

What it does:

• Detects what you've changed in git
• Auto-marks checklist items as complete
• Adds progress comment to Linear
• Gives you a clear summary of work done

Usage:

# Auto-detect issue from branch
/ccpm:sync

# With custom summary
/ccpm:sync PSN-27 "Completed authentication endpoints"

# Auto-detect with summary
/ccpm:sync "Finished UI components"

Interactive mode:

• Shows all uncommitted changes
• AI analyzes your code changes against checklist items
• Suggests which items you completed
• Asks you to confirm (or manually select items)

Quick sync mode:

• If you provide a summary, skips the interactive part
• Just adds a comment with your summary
• Fast and simple

Next command: /ccpm:commit

---

4. /ccpm:commit - Create Conventional Git Commits

Make clean, meaningful git commits that follow best practices.

What it does:

• Auto-detects commit type (feat/fix/docs/etc) from your changes
• Generates meaningful commit message from issue context
• Links commits to Linear issues
• Follows conventional commits format

Usage:

# Auto-detect everything
/ccpm:commit

# With explicit message
/ccpm:commit "Add JWT token validation"

# Full conventional format
/ccpm:commit "fix(PSN-27): resolve login handler"

Smart detection:

• Extracts issue ID from your branch name
• Fetches issue title from Linear
• Analyzes changed files to determine commit type
• Generates professional commit message

Confirmation:

• Shows exactly what will be committed
• Lets you edit the message if needed
• Creates commit with all proper formatting

Output:

✅ Commit created successfully!
Commit: feat(PSN-27): Add user authentication
Next steps:
  /ccpm:sync        # Sync progress to Linear
  /ccpm:work        # Continue working
  git push          # Push to remote

Next command: /ccpm:verify

---

5. /ccpm:verify - Run Quality Checks and Verification

Before completing, make sure everything is production-ready.

What it does:

• Runs automated quality checks (linting, tests, build)
• Performs final code review and verification
• Identifies issues that need fixing
• Confirms work meets acceptance criteria

Usage:

# Auto-detect from branch
/ccpm:verify

# Explicit issue ID
/ccpm:verify PSN-27

Sequential checks:

1. Linting - Code style and format
2. **T

...