claude-code-workflow 6.3.53 → 7.0.0

package/.claude/commands/workflow/tools/task-generate-agent.md

@@ -1,667 +0,0 @@
----
-name: task-generate-agent
-description: Generate implementation plan documents (IMPL_PLAN.md, task JSONs, TODO_LIST.md) using action-planning-agent - produces planning artifacts, does NOT execute code implementation
-argument-hint: "[-y|--yes] --session WFS-session-id"
-examples:
-  - /workflow:tools:task-generate-agent --session WFS-auth
-  - /workflow:tools:task-generate-agent -y --session WFS-auth
----
-
-## Auto Mode
-
-When `--yes` or `-y`: Skip user questions, use defaults (no materials, Agent executor, Codex CLI tool).
-
-# Generate Implementation Plan Command
-
-## Overview
-Generate implementation planning documents (IMPL_PLAN.md, task JSONs, TODO_LIST.md) using action-planning-agent. This command produces **planning artifacts only** - it does NOT execute code implementation. Actual code implementation requires separate execution command (e.g., /workflow:execute).
-
-## Core Philosophy
-- **Planning Only**: Generate planning documents (IMPL_PLAN.md, task JSONs, TODO_LIST.md) - does NOT implement code
-- **Agent-Driven Document Generation**: Delegate plan generation to action-planning-agent
-- **NO Redundant Context Sorting**: Context priority sorting is ALREADY completed in context-gather Phase 2/3
-  - Use `context-package.json.prioritized_context` directly
-  - DO NOT re-sort files or re-compute priorities
-  - `priority_tiers` and `dependency_order` are pre-computed and ready-to-use
-- **N+1 Parallel Planning**: Auto-detect multi-module projects, enable parallel planning (2+1 or 3+1 mode)
-- **Progressive Loading**: Load context incrementally (Core → Selective → On-Demand) due to analysis.md file size
-- **Memory-First**: Reuse loaded documents from conversation memory
-- **Smart Selection**: Load synthesis_output OR guidance + relevant role analyses, NOT all role analyses
-- **MCP-Enhanced**: Use MCP tools for advanced code analysis and research
-- **Path Clarity**: All `focus_paths` prefer absolute paths (e.g., `D:\\project\\src\\module`), or clear relative paths from project root (e.g., `./src/module`)
-
-## Execution Process
-
-```
-Input Parsing:
-   ├─ Parse flags: --session
-   └─ Validation: session_id REQUIRED
-
-Phase 0: User Configuration (Interactive)
-   ├─ Question 1: Supplementary materials/guidelines?
-   ├─ Question 2: Execution method preference (Agent/CLI/Hybrid)
-   ├─ Question 3: CLI tool preference (if CLI selected)
-   └─ Store: userConfig for agent prompt
-
-Phase 1: Context Preparation & Module Detection (Command)
-   ├─ Assemble session paths (metadata, context package, output dirs)
-   ├─ Provide metadata (session_id, execution_mode, mcp_capabilities)
-   ├─ Auto-detect modules from context-package + directory structure
-   └─ Decision:
-      ├─ modules.length == 1 → Single Agent Mode (Phase 2A)
-      └─ modules.length >= 2 → Parallel Mode (Phase 2B + Phase 3)
-
-Phase 2A: Single Agent Planning (Original Flow)
-   ├─ Load context package (progressive loading strategy)
-   ├─ Generate Task JSON Files (.task/IMPL-*.json)
-   ├─ Create IMPL_PLAN.md
-   └─ Generate TODO_LIST.md
-
-Phase 2B: N Parallel Planning (Multi-Module)
-   ├─ Launch N action-planning-agents simultaneously (one per module)
-   ├─ Each agent generates module-scoped tasks (IMPL-{prefix}{seq}.json)
-   ├─ Task ID format: IMPL-A1, IMPL-A2... / IMPL-B1, IMPL-B2...
-   └─ Each module limited to ≤9 tasks
-
-Phase 3: Integration (+1 Coordinator, Multi-Module Only)
-   ├─ Collect all module task JSONs
-   ├─ Resolve cross-module dependencies (CROSS::{module}::{pattern} → actual ID)
-   ├─ Generate unified IMPL_PLAN.md (grouped by module)
-   └─ Generate TODO_LIST.md (hierarchical: module → tasks)
-```
-
-## Document Generation Lifecycle
-
-### Phase 0: User Configuration (Interactive)
-
-**Purpose**: Collect user preferences before task generation to ensure generated tasks match execution expectations.
-
-**Auto Mode Check**:
-```javascript
-const autoYes = $ARGUMENTS.includes('--yes') || $ARGUMENTS.includes('-y')
-
-if (autoYes) {
-  console.log(`[--yes] Using defaults: No materials, Agent executor, Codex CLI`)
-  userConfig = {
-    supplementaryMaterials: { type: "none", content: [] },
-    executionMethod: "agent",
-    preferredCliTool: "codex",
-    enableResume: true
-  }
-  // Skip to Phase 1
-}
-```
-
-**User Questions** (skipped if autoYes):
-```javascript
-if (!autoYes) AskUserQuestion({
-  questions: [
-    {
-      question: "Do you have supplementary materials or guidelines to include?",
-      header: "Materials",
-      multiSelect: false,
-      options: [
-        { label: "No additional materials", description: "Use existing context only" },
-        { label: "Provide file paths", description: "I'll specify paths to include" },
-        { label: "Provide inline content", description: "I'll paste content directly" }
-      ]
-    },
-    {
-      question: "Select execution method for generated tasks:",
-      header: "Execution",
-      multiSelect: false,
-      options: [
-        { label: "Agent (Recommended)", description: "Claude agent executes tasks directly" },
-        { label: "Hybrid", description: "Agent orchestrates, calls CLI for complex steps" },
-        { label: "CLI Only", description: "All execution via CLI tools (codex/gemini/qwen)" }
-      ]
-    },
-    {
-      question: "If using CLI, which tool do you prefer?",
-      header: "CLI Tool",
-      multiSelect: false,
-      options: [
-        { label: "Codex (Recommended)", description: "Best for implementation tasks" },
-        { label: "Gemini", description: "Best for analysis and large context" },
-        { label: "Qwen", description: "Alternative analysis tool" },
-        { label: "Auto", description: "Let agent decide per-task" }
-      ]
-    }
-  ]
-})
-
-**Handle Materials Response** (skipped if autoYes):
-```javascript
-if (!autoYes && userConfig.materials === "Provide file paths") {
-  // Follow-up question for file paths
-  const pathsResponse = AskUserQuestion({
-    questions: [{
-      question: "Enter file paths to include (comma-separated or one per line):",
-      header: "Paths",
-      multiSelect: false,
-      options: [
-        { label: "Enter paths", description: "Provide paths in text input" }
-      ]
-    }]
-  })
-  userConfig.supplementaryPaths = parseUserPaths(pathsResponse)
-}
-```
-
-**Build userConfig**:
-```javascript
-const userConfig = {
-  supplementaryMaterials: {
-    type: "none|paths|inline",
-    content: [...],  // Parsed paths or inline content
-  },
-  executionMethod: "agent|hybrid|cli",
-  preferredCliTool: "codex|gemini|qwen|auto",
-  enableResume: true  // Always enable resume for CLI executions
-}
-```
-
-**Pass to Agent**: Include `userConfig` in agent prompt for Phase 2A/2B.
-
-### Phase 1: Context Preparation & Module Detection (Command Responsibility)
-
-**Command prepares session paths, metadata, detects module structure. Context priority sorting is NOT performed here - it's already completed in context-gather Phase 2/3.**
-
-**Session Path Structure**:
-```
-.workflow/active/WFS-{session-id}/
-├── workflow-session.json          # Session metadata
-├── planning-notes.md              # Consolidated planning notes
-├── .process/
-│   └── context-package.json       # Context package with artifact catalog
-├── .task/                         # Output: Task JSON files
-│   ├── IMPL-A1.json               # Multi-module: prefixed by module
-│   ├── IMPL-A2.json
-│   ├── IMPL-B1.json
-│   └── ...
-├── IMPL_PLAN.md                   # Output: Implementation plan (grouped by module)
-└── TODO_LIST.md                   # Output: TODO list (hierarchical)
-```
-
-**Command Preparation**:
-1. **Assemble Session Paths** for agent prompt:
-   - `session_metadata_path`
-   - `context_package_path`
-   - Output directory paths
-
-2. **Provide Metadata** (simple values):
-   - `session_id`
-   - `mcp_capabilities` (available MCP tools)
-
-3. **Auto Module Detection** (determines single vs parallel mode):
-   ```javascript
-   function autoDetectModules(contextPackage, projectRoot) {
-     // === Complexity Gate: Only parallelize for High complexity ===
-     const complexity = contextPackage.metadata?.complexity || 'Medium';
-     if (complexity !== 'High') {
-       // Force single agent mode for Low/Medium complexity
-       // This maximizes agent context reuse for related tasks
-       return [{ name: 'main', prefix: '', paths: ['.'] }];
-     }
-
-     // Priority 1: Explicit frontend/backend separation
-     if (exists('src/frontend') && exists('src/backend')) {
-       return [
-         { name: 'frontend', prefix: 'A', paths: ['src/frontend'] },
-         { name: 'backend', prefix: 'B', paths: ['src/backend'] }
-       ];
-     }
-
-     // Priority 2: Monorepo structure
-     if (exists('packages/*') || exists('apps/*')) {
-       return detectMonorepoModules();  // Returns 2-3 main packages
-     }
-
-     // Priority 3: Context-package dependency clustering
-     const modules = clusterByDependencies(contextPackage.dependencies?.internal);
-     if (modules.length >= 2) return modules.slice(0, 3);
-
-     // Default: Single module (original flow)
-     return [{ name: 'main', prefix: '', paths: ['.'] }];
-   }
-   ```
-
-**Decision Logic**:
-- `complexity !== 'High'` → Force Phase 2A (Single Agent, maximize context reuse)
-- `modules.length == 1` → Phase 2A (Single Agent, original flow)
-- `modules.length >= 2 && complexity == 'High'` → Phase 2B + Phase 3 (N+1 Parallel)
-
-**Note**: CLI tool usage is now determined semantically by action-planning-agent based on user's task description, not by flags.
-
-### Phase 2A: Single Agent Planning (Original Flow)
-
-**Condition**: `modules.length == 1` (no multi-module detected)
-
-**Purpose**: Generate IMPL_PLAN.md, task JSONs, and TODO_LIST.md - planning documents only, NOT code implementation.
-
-**Agent Invocation**:
-```javascript
-Task(
-  subagent_type="action-planning-agent",
-  run_in_background=false,
-  description="Generate planning documents (IMPL_PLAN.md, task JSONs, TODO_LIST.md)",
-  prompt=`
-## TASK OBJECTIVE
-Generate implementation planning documents (IMPL_PLAN.md, task JSONs, TODO_LIST.md) for workflow session
-
-IMPORTANT: This is PLANNING ONLY - you are generating planning documents, NOT implementing code.
-
-CRITICAL: Follow the progressive loading strategy defined in agent specification (load analysis.md files incrementally due to file size)
-
-## PLANNING NOTES (PHASE 1-3 CONTEXT)
-Load: .workflow/active/{session-id}/planning-notes.md
-
-This document contains:
-- User Intent: Original GOAL and KEY_CONSTRAINTS from Phase 1
-- Context Findings: Critical files, architecture, and constraints from Phase 2
-- Conflict Decisions: Resolved conflicts and planning constraints from Phase 3
-- Consolidated Constraints: All constraints from all phases
-
-**USAGE**: Read planning-notes.md FIRST. Use Consolidated Constraints list to guide task sequencing and dependencies.
-
-## SESSION PATHS
-Input:
-  - Session Metadata: .workflow/active/{session-id}/workflow-session.json
-  - Planning Notes: .workflow/active/{session-id}/planning-notes.md
-  - Context Package: .workflow/active/{session-id}/.process/context-package.json
-
-Output:
-  - Task Dir: .workflow/active/{session-id}/.task/
-  - IMPL_PLAN: .workflow/active/{session-id}/IMPL_PLAN.md
-  - TODO_LIST: .workflow/active/{session-id}/TODO_LIST.md
-
-## CONTEXT METADATA
-Session ID: {session-id}
-MCP Capabilities: {exa_code, exa_web, code_index}
-
-## USER CONFIGURATION (from Phase 0)
-Execution Method: ${userConfig.executionMethod}  // agent|hybrid|cli
-Preferred CLI Tool: ${userConfig.preferredCliTool}  // codex|gemini|qwen|auto
-Supplementary Materials: ${userConfig.supplementaryMaterials}
-
-## CLI TOOL SELECTION
-Based on userConfig.executionMethod:
-- "agent": No command field in implementation_approach steps
-- "hybrid": Add command field to complex steps only (agent handles simple steps)
-- "cli": Add command field to ALL implementation_approach steps
-
-CLI Resume Support (MANDATORY for all CLI commands):
-- Use --resume parameter to continue from previous task execution
-- Read previous task's cliExecutionId from session state
-- Format: ccw cli -p "[prompt]" --resume ${previousCliId} --tool ${tool} --mode write
-
-## PRIORITIZED CONTEXT (from context-package.prioritized_context) - ALREADY SORTED
-Context sorting is ALREADY COMPLETED in context-gather Phase 2/3. DO NOT re-sort.
-Direct usage:
-- **user_intent**: Use goal/scope/key_constraints for task alignment
-- **priority_tiers.critical**: These files are PRIMARY focus for task generation
-- **priority_tiers.high**: These files are SECONDARY focus
-- **dependency_order**: Use this for task sequencing - already computed
-- **sorting_rationale**: Reference for understanding priority decisions
-
-## EXPLORATION CONTEXT (from context-package.exploration_results) - SUPPLEMENT ONLY
-If prioritized_context is incomplete, fall back to exploration_results:
-- Load exploration_results from context-package.json
-- Use aggregated_insights.critical_files for focus_paths generation
-- Apply aggregated_insights.constraints to acceptance criteria
-- Reference aggregated_insights.all_patterns for implementation approach
-- Use aggregated_insights.all_integration_points for precise modification locations
-- Use conflict_indicators for risk-aware task sequencing
-
-## CONFLICT RESOLUTION CONTEXT (if exists)
-- Check context-package.conflict_detection.resolution_file for conflict-resolution.json path
-- If exists, load .process/conflict-resolution.json:
-  - Apply planning_constraints as task constraints (for brainstorm-less workflows)
-  - Reference resolved_conflicts for implementation approach alignment
-  - Handle custom_conflicts with explicit task notes
-
-## EXPECTED DELIVERABLES
-1. Task JSON Files (.task/IMPL-*.json)
-   - 6-field schema (id, title, status, context_package_path, meta, context, flow_control)
-   - Quantified requirements with explicit counts
-   - Artifacts integration from context package
-   - **focus_paths generated directly from prioritized_context.priority_tiers (critical + high)**
-     - NO re-sorting or re-prioritization - use pre-computed tiers as-is
-     - Critical files are PRIMARY focus, High files are SECONDARY
-   - Flow control with pre_analysis steps (use prioritized_context.dependency_order for task sequencing)
-   - **CLI Execution IDs and strategies (MANDATORY)**
-
-2. Implementation Plan (IMPL_PLAN.md)
-   - Context analysis and artifact references
-   - Task breakdown and execution strategy
-   - Complete structure per agent definition
-
-3. TODO List (TODO_LIST.md)
-   - Hierarchical structure (containers, pending, completed markers)
-   - Links to task JSONs and summaries
-   - Matches task JSON hierarchy
-
-## CLI EXECUTION ID REQUIREMENTS (MANDATORY)
-Each task JSON MUST include:
-- **cli_execution_id**: Unique ID for CLI execution (format: `{session_id}-{task_id}`)
-- **cli_execution**: Strategy object based on depends_on:
-  - No deps → `{ "strategy": "new" }`
-  - 1 dep (single child) → `{ "strategy": "resume", "resume_from": "parent-cli-id" }`
-  - 1 dep (multiple children) → `{ "strategy": "fork", "resume_from": "parent-cli-id" }`
-  - N deps → `{ "strategy": "merge_fork", "merge_from": ["id1", "id2", ...] }`
-
-**CLI Execution Strategy Rules**:
-1. **new**: Task has no dependencies - starts fresh CLI conversation
-2. **resume**: Task has 1 parent AND that parent has only this child - continues same conversation
-3. **fork**: Task has 1 parent BUT parent has multiple children - creates new branch with parent context
-4. **merge_fork**: Task has multiple parents - merges all parent contexts into new conversation
-
-**Execution Command Patterns**:
-- new: `ccw cli -p "[prompt]" --tool [tool] --mode write --id [cli_execution_id]`
-- resume: `ccw cli -p "[prompt]" --resume [resume_from] --tool [tool] --mode write`
-- fork: `ccw cli -p "[prompt]" --resume [resume_from] --id [cli_execution_id] --tool [tool] --mode write`
-- merge_fork: `ccw cli -p "[prompt]" --resume [merge_from.join(',')] --id [cli_execution_id] --tool [tool] --mode write`
-
-## QUALITY STANDARDS
-Hard Constraints:
-  - Task count <= 18 (hard limit - request re-scope if exceeded)
-  - All requirements quantified (explicit counts and enumerated lists)
-  - Acceptance criteria measurable (include verification commands)
-  - Artifact references mapped from context package
-  - All documents follow agent-defined structure
-
-## SUCCESS CRITERIA
-- All planning documents generated successfully:
-  - Task JSONs valid and saved to .task/ directory
-  - IMPL_PLAN.md created with complete structure
-  - TODO_LIST.md generated matching task JSONs
-- Return completion status with document count and task breakdown summary
-
-## PLANNING NOTES RECORD (REQUIRED)
-After completing all documents, append a brief execution record to planning-notes.md:
-
-**File**: .workflow/active/{session_id}/planning-notes.md
-**Location**: Create new section after "## Consolidated Constraints"
-**Format**:
-\`\`\`
-## Task Generation (Phase 4)
-
-### [Action-Planning Agent] YYYY-MM-DD
-- **Note**: [智能补充：简短总结任务数量、关键任务、依赖关系等]
-\`\`\`
-`
-)
-```
-
-### Phase 2B: N Parallel Planning (Multi-Module)
-
-**Condition**: `modules.length >= 2` (multi-module detected)
-
-**Purpose**: Launch N action-planning-agents simultaneously, one per module, for parallel task JSON generation.
-
-**Note**: Phase 2B agents generate Task JSONs ONLY. IMPL_PLAN.md and TODO_LIST.md are generated by Phase 3 Coordinator.
-
-**Parallel Agent Invocation**:
-```javascript
-// Launch N agents in parallel (one per module)
-const planningTasks = modules.map(module =>
-  Task(
-    subagent_type="action-planning-agent",
-    run_in_background=false,
-    description=`Generate ${module.name} module task JSONs`,
-    prompt=`
-## TASK OBJECTIVE
-Generate task JSON files for ${module.name} module within workflow session
-
-IMPORTANT: This is PLANNING ONLY - generate task JSONs, NOT implementing code.
-IMPORTANT: Generate Task JSONs ONLY. IMPL_PLAN.md and TODO_LIST.md by Phase 3 Coordinator.
-
-CRITICAL: Follow the progressive loading strategy defined in agent specification (load analysis.md files incrementally due to file size)
-
-## PLANNING NOTES (PHASE 1-3 CONTEXT)
-Load: .workflow/active/{session-id}/planning-notes.md
-
-This document contains consolidated constraints and user intent to guide module-scoped task generation.
-
-## MODULE SCOPE
-- Module: ${module.name} (${module.type})
-- Focus Paths: ${module.paths.join(', ')}
-- Task ID Prefix: IMPL-${module.prefix}
-- Task Limit: ≤6 tasks (hard limit for this module)
-- Other Modules: ${otherModules.join(', ')} (reference only, do NOT generate tasks for them)
-
-## SESSION PATHS
-Input:
-  - Session Metadata: .workflow/active/{session-id}/workflow-session.json
-  - Planning Notes: .workflow/active/{session-id}/planning-notes.md
-  - Context Package: .workflow/active/{session-id}/.process/context-package.json
-
-Output:
-  - Task Dir: .workflow/active/{session-id}/.task/
-
-## CONTEXT METADATA
-Session ID: {session-id}
-MCP Capabilities: {exa_code, exa_web, code_index}
-
-## USER CONFIGURATION (from Phase 0)
-Execution Method: ${userConfig.executionMethod}  // agent|hybrid|cli
-Preferred CLI Tool: ${userConfig.preferredCliTool}  // codex|gemini|qwen|auto
-Supplementary Materials: ${userConfig.supplementaryMaterials}
-
-## CLI TOOL SELECTION
-Based on userConfig.executionMethod:
-- "agent": No command field in implementation_approach steps
-- "hybrid": Add command field to complex steps only (agent handles simple steps)
-- "cli": Add command field to ALL implementation_approach steps
-
-CLI Resume Support (MANDATORY for all CLI commands):
-- Use --resume parameter to continue from previous task execution
-- Read previous task's cliExecutionId from session state
-- Format: ccw cli -p "[prompt]" --resume ${previousCliId} --tool ${tool} --mode write
-
-## PRIORITIZED CONTEXT (from context-package.prioritized_context) - ALREADY SORTED
-Context sorting is ALREADY COMPLETED in context-gather Phase 2/3. DO NOT re-sort.
-Filter by module scope (${module.paths.join(', ')}):
-- **user_intent**: Use for task alignment within module
-- **priority_tiers.critical**: Filter for files in ${module.paths.join(', ')} → PRIMARY focus
-- **priority_tiers.high**: Filter for files in ${module.paths.join(', ')} → SECONDARY focus
-- **dependency_order**: Use module-relevant entries for task sequencing
-
-## EXPLORATION CONTEXT (from context-package.exploration_results) - SUPPLEMENT ONLY
-If prioritized_context is incomplete for this module, fall back to exploration_results:
-- Load exploration_results from context-package.json
-- Filter for ${module.name} module: Use aggregated_insights.critical_files matching ${module.paths.join(', ')}
-- Apply module-relevant constraints from aggregated_insights.constraints
-- Reference aggregated_insights.all_patterns applicable to ${module.name}
-- Use aggregated_insights.all_integration_points for precise modification locations within module scope
-- Use conflict_indicators for risk-aware task sequencing
-
-## CONFLICT RESOLUTION CONTEXT (if exists)
-- Check context-package.conflict_detection.resolution_file for conflict-resolution.json path
-- If exists, load .process/conflict-resolution.json:
-  - Apply planning_constraints relevant to ${module.name} as task constraints
-  - Reference resolved_conflicts affecting ${module.name} for implementation approach alignment
-  - Handle custom_conflicts with explicit task notes
-
-## CROSS-MODULE DEPENDENCIES
-- For dependencies ON other modules: Use placeholder depends_on: ["CROSS::{module}::{pattern}"]
-- Example: depends_on: ["CROSS::B::api-endpoint"] (this module depends on B's api-endpoint task)
-- Phase 3 Coordinator resolves to actual task IDs
-- For dependencies FROM other modules: Document in task context as "provides_for" annotation
-
-## EXPECTED DELIVERABLES
-Task JSON Files (.task/IMPL-${module.prefix}*.json):
-  - 6-field schema (id, title, status, context_package_path, meta, context, flow_control)
-  - Task ID format: IMPL-${module.prefix}1, IMPL-${module.prefix}2, ...
-  - Quantified requirements with explicit counts
-  - Artifacts integration from context package (filtered for ${module.name})
-  - **focus_paths generated directly from prioritized_context.priority_tiers filtered by ${module.paths.join(', ')}**
-    - NO re-sorting - use pre-computed tiers filtered for this module
-    - Critical files are PRIMARY focus, High files are SECONDARY
-  - Flow control with pre_analysis steps (use prioritized_context.dependency_order for module task sequencing)
-  - **CLI Execution IDs and strategies (MANDATORY)**
-  - Focus ONLY on ${module.name} module scope
-
-## CLI EXECUTION ID REQUIREMENTS (MANDATORY)
-Each task JSON MUST include:
-- **cli_execution_id**: Unique ID for CLI execution (format: `{session_id}-IMPL-${module.prefix}{seq}`)
-- **cli_execution**: Strategy object based on depends_on:
-  - No deps → `{ "strategy": "new" }`
-  - 1 dep (single child) → `{ "strategy": "resume", "resume_from": "parent-cli-id" }`
-  - 1 dep (multiple children) → `{ "strategy": "fork", "resume_from": "parent-cli-id" }`
-  - N deps → `{ "strategy": "merge_fork", "merge_from": ["id1", "id2", ...] }`
-  - Cross-module dep → `{ "strategy": "cross_module_fork", "resume_from": "CROSS::{module}::{pattern}" }`
-
-**CLI Execution Strategy Rules**:
-1. **new**: Task has no dependencies - starts fresh CLI conversation
-2. **resume**: Task has 1 parent AND that parent has only this child - continues same conversation
-3. **fork**: Task has 1 parent BUT parent has multiple children - creates new branch with parent context
-4. **merge_fork**: Task has multiple parents - merges all parent contexts into new conversation
-5. **cross_module_fork**: Task depends on task from another module - Phase 3 resolves placeholder
-
-**Execution Command Patterns**:
-- new: `ccw cli -p "[prompt]" --tool [tool] --mode write --id [cli_execution_id]`
-- resume: `ccw cli -p "[prompt]" --resume [resume_from] --tool [tool] --mode write`
-- fork: `ccw cli -p "[prompt]" --resume [resume_from] --id [cli_execution_id] --tool [tool] --mode write`
-- merge_fork: `ccw cli -p "[prompt]" --resume [merge_from.join(',')] --id [cli_execution_id] --tool [tool] --mode write`
-- cross_module_fork: (Phase 3 resolves placeholder, then uses fork pattern)
-
-## QUALITY STANDARDS
-Hard Constraints:
-  - Task count <= 9 for this module (hard limit - coordinate with Phase 3 if exceeded)
-  - All requirements quantified (explicit counts and enumerated lists)
-  - Acceptance criteria measurable (include verification commands)
-  - Artifact references mapped from context package (module-scoped filter)
-  - Focus paths use absolute paths or clear relative paths from project root
-  - Cross-module dependencies use CROSS:: placeholder format
-
-## SUCCESS CRITERIA
-- Task JSONs saved to .task/ with IMPL-${module.prefix}* naming
-- All task JSONs include cli_execution_id and cli_execution strategy
-- Cross-module dependencies use CROSS:: placeholder format consistently
-- Focus paths scoped to ${module.paths.join(', ')} only
-- Return: task count, task IDs, dependency summary (internal + cross-module)
-
-## PLANNING NOTES RECORD (REQUIRED)
-After completing module task JSONs, append a brief execution record to planning-notes.md:
-
-**File**: .workflow/active/{session_id}/planning-notes.md
-**Location**: Create new section after "## Consolidated Constraints" (if not exists)
-**Format**:
-\`\`\`
-## Task Generation (Phase 4)
-
-### [Action-Planning Agent - ${module.name}] YYYY-MM-DD
-- **Note**: [智能补充：简短总结本模块任务数量、关键任务等]
-\`\`\`
-
-**Note**: Multiple module agents will append their records. Phase 3 Integration Coordinator will add final summary.
-    `
-  )
-);
-
-// Execute all in parallel
-await Promise.all(planningTasks);
-```
-
-**Output Structure** (direct to .task/):
-```
-.task/
-├── IMPL-A1.json      # Module A (e.g., frontend)
-├── IMPL-A2.json
-├── IMPL-B1.json      # Module B (e.g., backend)
-├── IMPL-B2.json
-└── IMPL-C1.json      # Module C (e.g., shared)
-```
-
-**Task ID Naming**:
-- Format: `IMPL-{prefix}{seq}.json`
-- Prefix: A, B, C... (assigned by detection order)
-- Sequence: 1, 2, 3... (per-module increment)
-
-### Phase 3: Integration (+1 Coordinator Agent, Multi-Module Only)
-
-**Condition**: Only executed when `modules.length >= 2`
-
-**Purpose**: Collect all module tasks, resolve cross-module dependencies, generate unified IMPL_PLAN.md and TODO_LIST.md documents.
-
-**Coordinator Agent Invocation**:
-```javascript
-// Wait for all Phase 2B agents to complete
-const moduleResults = await Promise.all(planningTasks);
-
-// Launch +1 Coordinator Agent
-Task(
-  subagent_type="action-planning-agent",
-  run_in_background=false,
-  description="Integrate module tasks and generate unified documents",
-  prompt=`
-## TASK OBJECTIVE
-Integrate all module task JSONs, resolve cross-module dependencies, and generate unified IMPL_PLAN.md and TODO_LIST.md
-
-IMPORTANT: This is INTEGRATION ONLY - consolidate existing task JSONs, NOT creating new tasks.
-
-## SESSION PATHS
-Input:
-  - Session Metadata: .workflow/active/{session-id}/workflow-session.json
-  - Context Package: .workflow/active/{session-id}/.process/context-package.json
-  - Task JSONs: .workflow/active/{session-id}/.task/IMPL-*.json (from Phase 2B)
-Output:
-  - Updated Task JSONs: .workflow/active/{session-id}/.task/IMPL-*.json (resolved dependencies)
-  - IMPL_PLAN: .workflow/active/{session-id}/IMPL_PLAN.md
-  - TODO_LIST: .workflow/active/{session-id}/TODO_LIST.md
-
-## CONTEXT METADATA
-Session ID: {session-id}
-Modules: ${modules.map(m => m.name + '(' + m.prefix + ')').join(', ')}
-Module Count: ${modules.length}
-
-## INTEGRATION STEPS
-1. Collect all .task/IMPL-*.json, group by module prefix
-2. Resolve CROSS:: dependencies → actual task IDs, update task JSONs
-3. Generate IMPL_PLAN.md (multi-module format per agent specification)
-4. Generate TODO_LIST.md (hierarchical format per agent specification)
-
-## CROSS-MODULE DEPENDENCY RESOLUTION
-- Pattern: CROSS::{module}::{pattern} → IMPL-{module}* matching title/context
-- Example: CROSS::B::api-endpoint → IMPL-B1 (if B1 title contains "api-endpoint")
-- Log unresolved as warnings
-
-## EXPECTED DELIVERABLES
-1. Updated Task JSONs with resolved dependency IDs
-2. IMPL_PLAN.md - multi-module format with cross-dependency section
-3. TODO_LIST.md - hierarchical by module with cross-dependency section
-
-## SUCCESS CRITERIA
-- No CROSS:: placeholders remaining in task JSONs
-- IMPL_PLAN.md and TODO_LIST.md generated with multi-module structure
-- Return: task count, per-module breakdown, resolved dependency count
-
-## PLANNING NOTES RECORD (REQUIRED)
-After completing integration, append final summary to planning-notes.md:
-
-**File**: .workflow/active/{session_id}/planning-notes.md
-**Location**: Under "## Task Generation (Phase 4)" section (after module agent records)
-**Format**:
-\`\`\`
-### [Integration Coordinator] YYYY-MM-DD
-- **Note**: [智能补充：简短总结总任务数、跨模块依赖解决情况等]
-\`\`\`
-  `
-)
-```
-
-**Dependency Resolution Algorithm**:
-```javascript
-function resolveCrossModuleDependency(placeholder, allTasks) {
-  const [, targetModule, pattern] = placeholder.match(/CROSS::(\w+)::(.+)/);
-  const candidates = allTasks.filter(t =>
-    t.id.startsWith(`IMPL-${targetModule}`) &&
-    (t.title.toLowerCase().includes(pattern.toLowerCase()) ||
-     t.context?.description?.toLowerCase().includes(pattern.toLowerCase()))
-  );
-  return candidates.length > 0
-    ? candidates.sort((a, b) => a.id.localeCompare(b.id))[0].id
-    : placeholder; // Keep for manual resolution
-}
-```