mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-13 02:41:50 +08:00
feat: initialize monorepo with package.json for CCW workflow platform
This commit is contained in:
catlog22
237
ccw/docs-site/docs/commands/general/ccw.mdx
Normal file
237
ccw/docs-site/docs/commands/general/ccw.mdx
Normal file
@@ -0,0 +1,237 @@
|
||||
---
|
||||
title: /ccw
|
||||
sidebar_label: /ccw
|
||||
sidebar_position: 1
|
||||
description: Main CCW workflow coordinator for intelligent command orchestration
|
||||
---
|
||||
|
||||
# /ccw
|
||||
|
||||
Main CCW workflow coordinator - the unified entry point for intelligent command orchestration based on task complexity analysis.
|
||||
|
||||
## Overview
|
||||
|
||||
The `/ccw` command is the primary CCW workflow coordinator that automatically analyzes task requirements, evaluates complexity, and selects the appropriate workflow level and execution path.
|
||||
|
||||
**Core Concept**: Minimum Execution Units - commands grouped into logical units for complete workflow milestones.
|
||||
|
||||
## Features
|
||||
|
||||
- **Auto Complexity Analysis** - Evaluates task based on keywords and context
|
||||
- **Workflow Selection** - Automatically selects optimal workflow level (1-5)
|
||||
- **Unit-Based Orchestration** - Groups commands into Minimum Execution Units
|
||||
- **State Persistence** - Tracks execution state in `.workflow/.ccw-coordinator/`
|
||||
- **Intelligent Routing** - Direct execution vs CLI-based execution
|
||||
|
||||
## Usage
|
||||
|
||||
```bash
|
||||
# Let CCW analyze and select workflow
|
||||
/ccw "Implement user authentication"
|
||||
|
||||
# Explicit workflow selection
|
||||
/ccw --workflow rapid "Add logout endpoint"
|
||||
|
||||
# Skip tests
|
||||
/ccw --skip-tests "Quick config fix"
|
||||
|
||||
# Auto-confirm (skip confirmation prompts)
|
||||
/ccw --yes "Simple bug fix"
|
||||
```
|
||||
|
||||
## Command Options
|
||||
|
||||
| Option | Description | Default |
|
||||
|--------|-------------|---------|
|
||||
| `[task description]` | Task to execute (required) | - |
|
||||
| `--workflow <name>` | Explicit workflow selection | Auto-detected |
|
||||
| `--skip-tests` | Skip test validation unit | false |
|
||||
| `--yes` | Auto-confirm execution | false |
|
||||
|
||||
## Workflow Levels
|
||||
|
||||
The coordinator automatically selects from 5 workflow levels:
|
||||
|
||||
### Level 1: Rapid Execution
|
||||
**Complexity**: Low | **Artifacts**: None | **State**: Stateless
|
||||
|
||||
| Workflow | Description |
|
||||
|----------|-------------|
|
||||
| `lite-lite-lite` | Ultra-lightweight direct execution |
|
||||
|
||||
**Use for**: Quick fixes, simple features, config adjustments
|
||||
|
||||
### Level 2: Lightweight Planning
|
||||
**Complexity**: Low-Medium | **Artifacts**: Memory/Lightweight files
|
||||
|
||||
| Workflow | Description |
|
||||
|----------|-------------|
|
||||
| `rapid` | lite-plan → lite-execute (+ optional test units) |
|
||||
|
||||
**Use for**: Single-module features, bug fixes
|
||||
|
||||
### Level 3: Standard Planning
|
||||
**Complexity**: Medium-High | **Artifacts**: Persistent session files
|
||||
|
||||
| Workflow | Description |
|
||||
|----------|-------------|
|
||||
| `coupled` | plan → plan-verify → execute (+ optional test units) |
|
||||
| `tdd` | tdd-plan → execute → tdd-verify |
|
||||
|
||||
**Use for**: Multi-module changes, refactoring, TDD
|
||||
|
||||
### Level 4: Brainstorming
|
||||
**Complexity**: High | **Artifacts**: Multi-role analysis docs
|
||||
|
||||
| Workflow | Description |
|
||||
|----------|-------------|
|
||||
| `brainstorm` | brainstorm:auto-parallel → plan → execute |
|
||||
|
||||
**Use for**: New feature design, architecture refactoring
|
||||
|
||||
### Level 5: Intelligent Orchestration
|
||||
**Complexity**: All levels | **Artifacts**: Full state persistence
|
||||
|
||||
| Workflow | Description |
|
||||
|----------|-------------|
|
||||
| `full` | ccw-coordinator (auto-analyze & recommend) |
|
||||
|
||||
**Use for**: Complex multi-step workflows, uncertain commands
|
||||
|
||||
## Execution Flow
|
||||
|
||||
```
|
||||
User Input: "task description"
|
||||
↓
|
||||
Phase 1: Complexity Analysis
|
||||
├─ Extract keywords
|
||||
├─ Calculate complexity score
|
||||
└─ Detect constraints
|
||||
↓
|
||||
Phase 2: Workflow Selection
|
||||
├─ Map complexity to level
|
||||
├─ Select workflow
|
||||
└─ Build command chain
|
||||
↓
|
||||
Phase 3: User Confirmation
|
||||
├─ Display selected workflow
|
||||
└─ Show command chain
|
||||
↓
|
||||
Phase 4: Execute Command Chain
|
||||
├─ Setup TODO tracking
|
||||
├─ Execute commands sequentially
|
||||
└─ Track state
|
||||
↓
|
||||
Output completion summary
|
||||
```
|
||||
|
||||
## Complexity Evaluation
|
||||
|
||||
Auto-evaluates complexity based on keywords:
|
||||
|
||||
| Weight | Keywords |
|
||||
|--------|----------|
|
||||
| +2 | refactor, migrate, architect, system |
|
||||
| +2 | multiple, across, all, entire |
|
||||
| +1 | integrate, api, database |
|
||||
| +1 | security, performance, scale |
|
||||
|
||||
**Thresholds**:
|
||||
- **High complexity** (>=4): Level 3-4
|
||||
- **Medium complexity** (2-3): Level 2
|
||||
- **Low complexity** (<2): Level 1
|
||||
|
||||
## Minimum Execution Units
|
||||
|
||||
| Unit Name | Commands | Purpose |
|
||||
|-----------|----------|---------|
|
||||
| **Quick Implementation** | lite-plan → lite-execute | Lightweight plan and execution |
|
||||
| **Multi-CLI Planning** | multi-cli-plan → lite-execute | Multi-perspective analysis |
|
||||
| **Bug Fix** | lite-fix → lite-execute | Bug diagnosis and fix |
|
||||
| **Verified Planning** | plan → plan-verify → execute | Planning with verification |
|
||||
| **TDD Planning** | tdd-plan → execute | Test-driven development |
|
||||
| **Test Validation** | test-fix-gen → test-cycle-execute | Test fix cycle |
|
||||
| **Code Review** | review-session-cycle → review-cycle-fix | Review and fix |
|
||||
|
||||
## Command Chain Examples
|
||||
|
||||
### Rapid Workflow (Level 2)
|
||||
|
||||
```bash
|
||||
# Quick implementation
|
||||
Unit: quick-impl
|
||||
Commands:
|
||||
1. /workflow:lite-plan "Add logout endpoint"
|
||||
2. /workflow:lite-execute --in-memory
|
||||
|
||||
(Optional) Unit: test-validation
|
||||
Commands:
|
||||
3. /workflow:test-fix-gen
|
||||
4. /workflow:test-cycle-execute
|
||||
```
|
||||
|
||||
### Coupled Workflow (Level 3)
|
||||
|
||||
```bash
|
||||
# Verified planning
|
||||
Unit: verified-planning-execution
|
||||
Commands:
|
||||
1. /workflow:plan "Implement OAuth2"
|
||||
2. /workflow:plan-verify
|
||||
3. /workflow:execute
|
||||
|
||||
(Optional) Unit: test-validation
|
||||
Commands:
|
||||
4. /workflow:test-fix-gen
|
||||
5. /workflow:test-cycle-execute
|
||||
```
|
||||
|
||||
## Examples
|
||||
|
||||
### Auto Workflow Selection
|
||||
|
||||
```bash
|
||||
# CCW analyzes and selects appropriate workflow
|
||||
/ccw "Add user profile page"
|
||||
|
||||
# Output:
|
||||
# Analyzing task...
|
||||
# Complexity: Low (score: 1)
|
||||
# Selected: Level 2 - Rapid Workflow
|
||||
# Commands: lite-plan → lite-execute
|
||||
# Confirm? (y/n): y
|
||||
```
|
||||
|
||||
### Explicit Workflow
|
||||
|
||||
```bash
|
||||
# Force specific workflow
|
||||
/ccw --workflow tdd "Implement authentication with TDD"
|
||||
|
||||
# Uses TDD workflow regardless of complexity
|
||||
```
|
||||
|
||||
### Skip Tests
|
||||
|
||||
```bash
|
||||
# Quick fix without tests
|
||||
/ccw --skip-tests "Fix typo in config"
|
||||
|
||||
# Omits test-validation unit
|
||||
```
|
||||
|
||||
## Related Commands
|
||||
|
||||
- **/ccw-plan** - Planning coordinator
|
||||
- **/ccw-test** - Test workflow coordinator
|
||||
- **/ccw-coordinator** - Generic command orchestration
|
||||
- **/ccw-debug** - Debug workflow coordinator
|
||||
|
||||
## Notes
|
||||
|
||||
- **Auto-analysis** evaluates task complexity based on keywords
|
||||
- **Workflow levels** map complexity to appropriate execution paths
|
||||
- **Minimum Execution Units** ensure complete workflow milestones
|
||||
- **State persistence** in `.workflow/.ccw-coordinator/{session}/`
|
||||
- **TODO tracking** with CCW prefix for visibility
|
||||
- **CLI execution** runs in background with hook callbacks
|
||||
Reference in New Issue
Block a user