Claude-Code-Workflow/.claude/skills/ccw/phases/actions/coupled.md

Action: Coupled Workflow

复杂耦合工作流：完整规划 + 验证 + 执行

Pattern

plan → action-plan-verify → execute

Trigger Conditions

• Complexity: High
• Keywords: "refactor", "重构", "migrate", "迁移", "architect", "架构"
• Cross-module changes
• System-level modifications

Execution Flow

sequenceDiagram
    participant U as User
    participant O as CCW Orchestrator
    participant PL as plan
    participant VF as verify
    participant EX as execute
    participant RV as review
    
    U->>O: Complex task
    O->>O: Classify: coupled (high complexity)
    
    Note over PL: Phase 1: Comprehensive Planning
    O->>PL: /workflow:plan
    PL->>PL: Multi-phase planning
    PL->>PL: Generate IMPL_PLAN.md
    PL->>PL: Generate task JSONs
    PL-->>U: Present plan
    
    Note over VF: Phase 2: Verification
    U->>VF: /workflow:action-plan-verify
    VF->>VF: Cross-artifact consistency
    VF->>VF: Dependency validation
    VF->>VF: Quality gate checks
    VF-->>U: Verification report
    
    alt Verification failed
        U->>PL: Replan with issues
    else Verification passed
        Note over EX: Phase 3: Execution
        U->>EX: /workflow:execute
        EX->>EX: DAG-based parallel execution
        EX-->>U: Execution complete
    end
    
    Note over RV: Phase 4: Review
    U->>RV: /workflow:review
    RV-->>U: Review findings

When to Use

✅ Ideal scenarios:

• 大规模重构
• 架构迁移
• 跨模块功能开发
• 技术栈升级
• 团队协作项目

❌ Avoid when:

• 简单的局部修改
• 时间紧迫
• 独立的小功能

Verification Checks

Check	Description	Severity
Dependency Cycles	检测循环依赖	Critical
Missing Tasks	计划与实际不符	High
File Conflicts	多任务修改同文件	Medium
Coverage Gaps	未覆盖的需求	Medium

Configuration

const coupledConfig = {
  plan: {
    phases: 5,  // Full 5-phase planning
    taskGeneration: 'action-planning-agent',
    outputFormat: {
      implPlan: '.workflow/plans/IMPL_PLAN.md',
      taskJsons: '.workflow/tasks/IMPL-*.json'
    }
  },
  
  verify: {
    required: true,  // Always verify before execute
    autoReplan: false,  // Manual replan on failure
    qualityGates: ['no-cycles', 'no-conflicts', 'complete-coverage']
  },
  
  execute: {
    dagParallel: true,
    checkpointInterval: 3,  // Checkpoint every 3 tasks
    rollbackOnFailure: true
  },
  
  review: {
    types: ['architecture', 'security'],
    required: true
  }
}

Task JSON Structure

{
  "id": "IMPL-001",
  "title": "重构认证模块核心逻辑",
  "scope": "src/auth/**",
  "action": "refactor",
  "depends_on": [],
  "modification_points": [
    {
      "file": "src/auth/service.ts",
      "target": "AuthService",
      "change": "Extract OAuth2 logic"
    }
  ],
  "acceptance": [
    "所有现有测试通过",
    "OAuth2 流程可用"
  ]
}

Example Invocations

# Architecture refactoring
ccw "重构整个认证模块，从 session 迁移到 JWT"
→ plan (5 phases)
→ verify
→ execute

# System migration
ccw "将数据库从 MySQL 迁移到 PostgreSQL"
→ plan (migration strategy)
→ verify (data integrity checks)
→ execute (staged migration)

# Cross-module feature
ccw "实现跨服务的分布式事务支持"
→ plan (architectural design)
→ verify (consistency checks)
→ execute (incremental rollout)

Output Artifacts

.workflow/
├── plans/
│   └── IMPL_PLAN.md           # Comprehensive plan
├── tasks/
│   ├── IMPL-001.json
│   ├── IMPL-002.json
│   └── ...
├── verify/
│   └── verification-report.md  # Verification results
└── reviews/
    └── {review-type}.md        # Review findings

Replan Flow

When verification fails:

if (verificationResult.status === 'failed') {
  console.log(`
## Verification Failed

**Issues found**:
${verificationResult.issues.map(i => `- ${i.severity}: ${i.message}`).join('\n')}

**Options**:
1. /workflow:replan - Address issues and regenerate plan
2. /workflow:plan --force - Proceed despite issues (not recommended)
3. Review issues manually and fix plan files
`)
}