Files
gh-duongdev-ccpm/commands/utils:cheatsheet.md
2025-11-29 18:24:24 +08:00

20 KiB
Raw Blame History

description, allowed-tools
description allowed-tools
Visual workflow cheatsheet - Quick reference for all CCPM commands

CCPM Workflow Cheatsheet

Quick visual reference for CCPM commands and workflows.

I'll show you a comprehensive CCPM workflow cheatsheet with visual diagrams.

---

# 🗺️ CCPM Workflow Cheatsheet

## 📊 Quick Command Finder

**What do you want to do?**

┌─────────────────────────────────────────────────────────────┐ │ Starting a new project/feature? │ │ → Spec-First Workflow (Section 1) │ ├─────────────────────────────────────────────────────────────┤ │ Working on a small task? │ │ → Task-First Workflow (Section 2) │ ├─────────────────────────────────────────────────────────────┤ │ Have existing markdown specs? │ │ → /ccpm:spec:migrate │ ├─────────────────────────────────────────────────────────────┤ │ Resuming work on a task? │ │ → /ccpm:utils:context │ ├─────────────────────────────────────────────────────────────┤ │ Need project overview? │ │ → /ccpm:utils:report │ ├─────────────────────────────────────────────────────────────┤ │ Stuck or need help? │ │ → /ccpm:utils:help [issue-id] │ └─────────────────────────────────────────────────────────────┘


---

## 1⃣ Spec-First Workflow (Recommended for Features)

**Use when:** Building new features, major projects, or anything requiring detailed planning

START │ ├─► 📋 Create Epic/Feature │ /ccpm:spec:create epic "User Authentication" │ /ccpm:spec:create feature "JWT Auth" EPIC-123 │ ├─► ✍️ Write Comprehensive Spec │ /ccpm:spec:write DOC-123 all │ OR write section by section: │ /ccpm:spec:write DOC-123 requirements │ /ccpm:spec:write DOC-123 architecture │ /ccpm:spec:write DOC-123 api-design │ /ccpm:spec:write DOC-123 data-model │ /ccpm:spec:write DOC-123 testing │ /ccpm:spec:write DOC-123 security │ ├─► 🔍 Review & Validate Spec │ /ccpm:spec:review DOC-123 │ (AI grades A-F, suggests improvements) │ ├─► 📦 Break Down into Tasks │ /ccpm:spec:break-down WORK-100 │ (Creates Features from Epic, or Tasks from Feature) │ ├─► 🚀 Implementation Phase │ [Continue with Task-First Workflow below] │ └─► 🔄 Keep Spec in Sync /ccpm:spec:sync WORK-100 (Run periodically during implementation)


**Spec Sections Available:**
- `requirements` - Functional, non-functional, acceptance criteria
- `architecture` - System design, component breakdown
- `api-design` - Endpoints, request/response schemas
- `data-model` - Database schema, TypeScript types
- `testing` - Test strategies (unit, integration, E2E)
- `security` - Auth, validation, rate limiting
- `user-flow` - User journeys, wireframes
- `timeline` - Task breakdown, estimates
- `all` - Write all sections sequentially

---

## 2⃣ Task-First Workflow (Quick Implementation)

**Use when:** Small tasks, bug fixes, or quick features

START │ ├─► 📝 Create Task + Plan │ /ccpm:planning:create "Add dark mode" my-project JIRA-123 │ OR (without external PM): │ /ccpm:planning:quick-plan "Add dark mode" my-project │ ├─► 🎯 Get AI Insights (Optional) │ /ccpm:utils:insights WORK-200 │ (Complexity scoring, risk analysis) │ ├─► 🤖 Auto-Assign Agents (Optional) │ /ccpm:utils:auto-assign WORK-200 │ (AI suggests optimal agent for each subtask) │ ├─► 🚀 Start Implementation │ /ccpm:implementation:start WORK-200 │ (Agent coordination begins) │ ├─► 🔄 Work on Subtasks │ /ccpm:implementation:next WORK-200 │ (AI suggests optimal next subtask) │ │ Update progress: │ /ccpm:implementation:update WORK-200 0 completed "Done" │ │ Save progress & findings: │ /ccpm:implementation:sync WORK-200 │ ├─► Quality Checks │ /ccpm:verification:check WORK-200 │ (Lint, tests, IDE warnings) │ ├─► 🔍 Final Verification │ /ccpm:verification:verify WORK-200 │ (Comprehensive review by verification-agent) │ │ If failures: │ /ccpm:verification:fix WORK-200 │ └─► 🎉 Finalize & Complete /ccpm:complete:finalize WORK-200 (PR creation, Jira sync, Slack notification)


---

## 3⃣ Planning Phase Commands

┌──────────────────────────────────────────────────────────────┐ │ Create new task + plan in one step │ │ /ccpm:planning:create "