claude-code-workflow 7.2.16 → 7.2.17

package/.codex/skills/review-cycle/phases/04-iterative-deep-dive.md

@@ -79,18 +79,18 @@ const deepDiveAgents = [];
 
 selectedFindings.forEach(finding => {
   const agentId = spawn_agent({
+    agent_type: "cli_explore_agent",
     message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
-2. Read original finding: ${dimensionJsonPath}
-3. Read affected file: ${finding.file}
-4. Identify related code: bash(grep -r "import.*${basename(finding.file)}" ${projectDir}/src --include="*.ts")
-5. Read test files: bash(find ${projectDir}/tests -name "*${basename(finding.file, '.ts')}*" -type f)
-6. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-deep-dive-results-schema.json (get output schema reference)
-7. Read: ${projectRoot}/.workflow/project-tech.json (technology stack and architecture context)
-8. Read: ${projectRoot}/.workflow/specs/*.md (user-defined constraints for remediation compliance)
+1. Read original finding: ${dimensionJsonPath}
+2. Read affected file: ${finding.file}
+3. Identify related code: bash(grep -r "import.*${basename(finding.file)}" ${projectDir}/src --include="*.ts")
+4. Read test files: bash(find ${projectDir}/tests -name "*${basename(finding.file, '.ts')}*" -type f)
+5. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-deep-dive-results-schema.json (get output schema reference)
+6. Read: ${projectRoot}/.workflow/project-tech.json (technology stack and architecture context)
+7. Read: ${projectRoot}/.workflow/specs/*.md (user-defined constraints for remediation compliance)
 
 ---
 
@@ -125,7 +125,7 @@ Then apply **Deep Scan mode** for semantic analysis:
 
 ## Expected Deliverables
 
-**Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 6, follow schema exactly
+**Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 5, follow schema exactly
 
 1. Deep-Dive Results JSON: ${outputDir}/iterations/iteration-${iteration}-finding-${finding.id}.json
 
@@ -190,18 +190,18 @@ const deepDiveAgents = [];
 
 selectedFindings.forEach(finding => {
   const agentId = spawn_agent({
+    agent_type: "cli_explore_agent",
     message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
-2. Read original finding: ${dimensionJsonPath}
-3. Read affected file: ${finding.file}
-4. Identify related code: bash(grep -r "import.*${basename(finding.file)}" ${workflowDir}/src --include="*.ts")
-5. Read test files: bash(find ${workflowDir}/tests -name "*${basename(finding.file, '.ts')}*" -type f)
-6. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-deep-dive-results-schema.json (get output schema reference)
-7. Read: ${projectRoot}/.workflow/project-tech.json (technology stack and architecture context)
-8. Read: ${projectRoot}/.workflow/specs/*.md (user-defined constraints for remediation compliance)
+1. Read original finding: ${dimensionJsonPath}
+2. Read affected file: ${finding.file}
+3. Identify related code: bash(grep -r "import.*${basename(finding.file)}" ${workflowDir}/src --include="*.ts")
+4. Read test files: bash(find ${workflowDir}/tests -name "*${basename(finding.file, '.ts')}*" -type f)
+5. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-deep-dive-results-schema.json (get output schema reference)
+6. Read: ${projectRoot}/.workflow/project-tech.json (technology stack and architecture context)
+7. Read: ${projectRoot}/.workflow/specs/*.md (user-defined constraints for remediation compliance)
 
 ---
 
@@ -237,7 +237,7 @@ Then apply **Deep Scan mode** for semantic analysis:
 
 ## Expected Deliverables
 
-**Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 6, follow schema exactly
+**Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 5, follow schema exactly
 
 1. Deep-Dive Results JSON: ${outputDir}/iterations/iteration-${iteration}-finding-${finding.id}.json
 

package/.codex/skills/review-cycle/phases/07-fix-parallel-planning.md

@@ -100,12 +100,12 @@ for (let i = 1; i <= aggregatedPlan.groups.length; i++) {
 ```javascript
 // Spawn planning agent for a batch
 const agentId = spawn_agent({
+  agent_type: "cli_planning_agent",
   message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/cli-planning-agent.md (MUST read first)
-2. Execute: ccw spec load --category planning
+1. Execute: ccw spec load --category planning
 
 ---
 

package/.codex/skills/review-cycle/phases/08-fix-execution.md

@@ -55,12 +55,12 @@ if (result.passRate < 100%) {
 ```javascript
 // Spawn execution agent for a group
 const execAgentId = spawn_agent({
+  agent_type: "cli_execution_agent",
   message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/cli-execution-agent.md (MUST read first)
-2. Execute: ccw spec load --category execution
+1. Execute: ccw spec load --category execution
 
 ---
 

package/.codex/skills/roadmap-with-file/SKILL.md

@@ -39,13 +39,13 @@ Create a new subagent with task assignment.
 
 ```javascript
 const agentId = spawn_agent({
+  agent_type: "{agent_type}",
   message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/{agent-type}.md (MUST read first)
-2. Read: .workflow/project-tech.json
-3. Read: .workflow/project-guidelines.json
+1. Read: .workflow/project-tech.json
+2. Read: .workflow/project-guidelines.json
 
 ## TASK CONTEXT
 ${taskContext}
@@ -502,13 +502,13 @@ Bash(`mkdir -p ${sessionFolder}`)
 
    if (hasCodebase !== 'none') {
      const exploreAgentId = spawn_agent({
+       agent_type: "cli_explore_agent",
        message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
-2. Read: .workflow/project-tech.json
-3. Read: .workflow/project-guidelines.json
+1. Read: .workflow/project-tech.json
+2. Read: .workflow/project-guidelines.json
 
 ---
 
@@ -553,13 +553,13 @@ Return findings as JSON with schema:
 2. **Execute Decomposition Agent**
    ```javascript
    const decompositionAgentId = spawn_agent({
+     agent_type: "cli_roadmap_plan_agent",
      message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/cli-roadmap-plan-agent.md (MUST read first)
-2. Read: .workflow/project-tech.json
-3. Read: .workflow/project-guidelines.json
+1. Read: .workflow/project-tech.json
+2. Read: .workflow/project-guidelines.json
 
 ---
 

package/.codex/skills/spec-setup/SKILL.md

@@ -122,12 +122,12 @@ let exploreAgent = null
 
 try {
   exploreAgent = spawn_agent({
+    agent_type: "cli_explore_agent",
     message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
-2. Read: .workflow/project-tech.json (if exists, for --regenerate)
+1. Read: .workflow/project-tech.json (if exists, for --regenerate)
 
 ---
 

package/.codex/skills/workflow-plan/SKILL.md

@@ -242,7 +242,7 @@ console.log(`Session: ${sessionId}`)
 console.log(`\n## Phase 2: Context Gathering\n`)
 
 const ctxAgent = spawn_agent({
-  agent: `~/.codex/agents/context-search-agent.md`,
+  agent_type: "context_search_agent",
   instruction: `
 Gather implementation context for planning.
 
@@ -376,7 +376,7 @@ TASK DESCRIPTION: ${taskDescription}" --tool gemini --mode analysis --rule analy
    ```javascript
    if (!isMultiModule) {
      const planAgent = spawn_agent({
-       agent: `~/.codex/agents/action-planning-agent.md`,
+       agent_type: "action_planning_agent",
        instruction: `
 Generate implementation plan and task JSONs.
 
@@ -421,7 +421,7 @@ ${contextPkg.conflict_risk === 'medium' || contextPkg.conflict_risk === 'high'
        const mod = uniqueModules[i]
 
        const agentId = spawn_agent({
-         agent: `~/.codex/agents/action-planning-agent.md`,
+         agent_type: "action_planning_agent",
          instruction: `
 Plan module: ${mod} (prefix: ${prefix})
 
@@ -444,7 +444,7 @@ Mark cross-module dependencies as CROSS::${'{module}'}::${'{task}'}
 
      // +1 Coordinator: integrate all modules
      const coordAgent = spawn_agent({
-       agent: `~/.codex/agents/action-planning-agent.md`,
+       agent_type: "action_planning_agent",
        instruction: `
 Integrate ${uniqueModules.length} module plans into unified IMPL_PLAN.md.
 
@@ -576,7 +576,7 @@ if (mode === 'replan') {
 
   // 2. Replan via agent
   const replanAgent = spawn_agent({
-    agent: `~/.codex/agents/action-planning-agent.md`,
+    agent_type: "action_planning_agent",
     instruction: `
 Replan ${scope === 'task' ? `task ${replanTaskId}` : 'entire session'}.
 

package/.codex/skills/workflow-tdd-plan/SKILL.md

@@ -269,7 +269,7 @@ console.log(`Session: ${sessionId}`)
 console.log(`\n## Phase 2: Context Gathering\n`)
 
 const ctxAgent = spawn_agent({
-  agent: `~/.codex/agents/context-search-agent.md`,
+  agent_type: "context_search_agent",
   instruction: `
 Gather implementation context for TDD planning.
 
@@ -329,7 +329,7 @@ console.log(`  Context gathered. Conflict risk: ${conflictRisk}`)
 console.log(`\n## Phase 3: Test Coverage Analysis\n`)
 
 const testAgent = spawn_agent({
-  agent: `~/.codex/agents/cli-explore-agent.md`,
+  agent_type: "cli_explore_agent",
   instruction: `
 Analyze test coverage and framework for TDD planning.
 
@@ -452,7 +452,7 @@ TASK DESCRIPTION: ${taskDescription}" --tool gemini --mode analysis --rule analy
 console.log(`\n## Phase 5: TDD Task Generation\n`)
 
 const planAgent = spawn_agent({
-  agent: `~/.codex/agents/action-planning-agent.md`,
+  agent_type: "action_planning_agent",
   instruction: `
 Generate TDD implementation plan with Red-Green-Refactor cycles.
 
@@ -628,7 +628,7 @@ if (mode === 'verify' || /* auto-verify from Phase 6 */) {
   }
 
   const verifyAgent = spawn_agent({
-    agent: `~/.codex/agents/cli-explore-agent.md`,
+    agent_type: "cli_explore_agent",
     instruction: `
 Verify TDD compliance across 4 dimensions.
 

package/.codex/skills/workflow-test-fix-cycle/SKILL.md

@@ -83,12 +83,12 @@ Create a new subagent with task assignment.
 
 ```javascript
 const agentId = spawn_agent({
+  agent_type: "{agent_type}",
   message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/{agent-type}.md (MUST read first)
-2. Run: `ccw spec load --category "planning execution"`
+1. Run: `ccw spec load --category "planning execution"`
 
 ## TASK CONTEXT
 ${taskContext}
@@ -241,10 +241,10 @@ Phase 2: Test-Cycle Execution (phases/02-test-cycle-execute.md)
 5. Phase 1 Summary → **⛔ MANDATORY: Present plan and wait for user confirmation before Phase 2**
 
 **Agents Used** (via spawn_agent):
-- `test-context-search-agent` (~/.codex/agents/test-context-search-agent.md) - Context gathering (Session Mode)
-- `context-search-agent` (~/.codex/agents/context-search-agent.md) - Context gathering (Prompt Mode)
-- `cli-execution-agent` (~/.codex/agents/cli-execution-agent.md) - Test analysis with Gemini
-- `action-planning-agent` (~/.codex/agents/action-planning-agent.md) - Task JSON generation
+- `test_context_search_agent` (agent_type: test_context_search_agent) - Context gathering (Session Mode)
+- `context_search_agent` (agent_type: context_search_agent) - Context gathering (Prompt Mode)
+- `cli_execution_agent` (agent_type: cli_execution_agent) - Test analysis with Gemini
+- `action_planning_agent` (agent_type: action_planning_agent) - Task JSON generation
 
 ### Phase 2: Test-Cycle Execution
 
@@ -256,8 +256,8 @@ Phase 2: Test-Cycle Execution (phases/02-test-cycle-execute.md)
 3. Completion - Final validation → Summary → Auto-complete session
 
 **Agents Used** (via spawn_agent):
-- `cli-planning-agent` (~/.codex/agents/cli-planning-agent.md) - Failure analysis, root cause extraction, fix task generation
-- `test-fix-agent` (~/.codex/agents/test-fix-agent.md) - Test execution, code fixes, criticality assignment
+- `cli_planning_agent` (agent_type: cli_planning_agent) - Failure analysis, root cause extraction, fix task generation
+- `test_fix_agent` (agent_type: test_fix_agent) - Test execution, code fixes, criticality assignment
 
 **Strategy Engine**: conservative (iteration 1-2) → aggressive (pass >80%) → surgical (regression)
 
@@ -387,14 +387,14 @@ try {
 - None for Prompt Mode
 
 **Phase 1 Agents** (used by phases/01-test-fix-gen.md via spawn_agent):
-- `test-context-search-agent` (~/.codex/agents/test-context-search-agent.md) - Test coverage analysis (Session Mode)
-- `context-search-agent` (~/.codex/agents/context-search-agent.md) - Codebase analysis (Prompt Mode)
-- `cli-execution-agent` (~/.codex/agents/cli-execution-agent.md) - Test requirements with Gemini
-- `action-planning-agent` (~/.codex/agents/action-planning-agent.md) - Task JSON generation
+- `test_context_search_agent` (agent_type: test_context_search_agent) - Test coverage analysis (Session Mode)
+- `context_search_agent` (agent_type: context_search_agent) - Codebase analysis (Prompt Mode)
+- `cli_execution_agent` (agent_type: cli_execution_agent) - Test requirements with Gemini
+- `action_planning_agent` (agent_type: action_planning_agent) - Task JSON generation
 
 **Phase 2 Agents** (used by phases/02-test-cycle-execute.md via spawn_agent):
-- `cli-planning-agent` (~/.codex/agents/cli-planning-agent.md) - CLI analysis, root cause extraction, task generation
-- `test-fix-agent` (~/.codex/agents/test-fix-agent.md) - Test execution, code fixes, criticality assignment
+- `cli_planning_agent` (agent_type: cli_planning_agent) - CLI analysis, root cause extraction, task generation
+- `test_fix_agent` (agent_type: test_fix_agent) - Test execution, code fixes, criticality assignment
 
 **Follow-up**:
 - Session sync: `$session-sync -y "Test-fix cycle complete: {pass_rate}% pass rate"`

package/.codex/skills/workflow-test-fix-cycle/phases/01-test-fix-gen.md

@@ -70,13 +70,13 @@ if (input.startsWith("WFS-")) {
 ```javascript
 // Session Mode - gather from source session via test-context-search-agent
 const contextAgentId = spawn_agent({
+  agent_type: "test_context_search_agent",
   message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/test-context-search-agent.md (MUST read first)
-2. Run: `ccw spec load --category planning`
-3. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
+1. Run: `ccw spec load --category planning`
+2. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
 
 ---
 
@@ -97,13 +97,13 @@ close_agent({ id: contextAgentId });
 
 // Prompt Mode - gather from codebase via context-search-agent
 const contextAgentId = spawn_agent({
+  agent_type: "context_search_agent",
   message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/context-search-agent.md (MUST read first)
-2. Run: `ccw spec load --category planning`
-3. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
+1. Run: `ccw spec load --category planning`
+2. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
 
 ---
 
@@ -171,13 +171,13 @@ close_agent({ id: contextAgentId });
 
 ```javascript
 const analysisAgentId = spawn_agent({
+  agent_type: "cli_execution_agent",
   message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/cli-execution-agent.md (MUST read first)
-2. Run: `ccw spec load --category planning`
-3. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
+1. Run: `ccw spec load --category planning`
+2. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
 
 ---
 
@@ -240,13 +240,13 @@ close_agent({ id: analysisAgentId });
 
 ```javascript
 const taskGenAgentId = spawn_agent({
+  agent_type: "action_planning_agent",
   message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/action-planning-agent.md (MUST read first)
-2. Run: `ccw spec load --category planning`
-3. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
+1. Run: `ccw spec load --category planning`
+2. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
 
 ---
 

package/.codex/skills/workflow-test-fix-cycle/phases/02-test-cycle-execute.md

@@ -85,13 +85,13 @@ return "conservative";
 ```javascript
 // Spawn agent for failure analysis
 const analysisAgentId = spawn_agent({
+  agent_type: "cli_planning_agent",
   message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/cli-planning-agent.md (MUST read first)
-2. Run: `ccw spec load --category planning`
-3. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
+1. Run: `ccw spec load --category planning`
+2. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
 
 ---
 
@@ -152,13 +152,13 @@ close_agent({ id: analysisAgentId });
 ```javascript
 // Spawn agent for test execution/fixing
 const fixAgentId = spawn_agent({
+  agent_type: "test_fix_agent",
   message: `
 ## TASK ASSIGNMENT
 
 ### MANDATORY FIRST STEPS (Agent Execute)
-1. **Read role definition**: ~/.codex/agents/test-fix-agent.md (MUST read first)
-2. Run: `ccw spec load --category execution`
-3. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
+1. Run: `ccw spec load --category execution`
+2. Run: `ccw spec load --category test` (test framework, coverage targets, conventions)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-workflow",
-  "version": "7.2.16",
+  "version": "7.2.17",
   "description": "JSON-driven multi-agent development framework with intelligent CLI orchestration (Gemini/Qwen/Codex), context-first architecture, and automated workflow execution",
   "type": "module",
   "main": "ccw/dist/index.js",