claude-code-workflow 7.2.16 → 7.2.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/.codex/agents/{action-planning-agent.md → action-planning-agent.toml} +8 -17
  2. package/.codex/agents/{cli-discuss-agent.md → cli-discuss-agent.toml} +391 -391
  3. package/.codex/agents/{cli-execution-agent.md → cli-execution-agent.toml} +334 -333
  4. package/.codex/agents/{cli-explore-agent.md → cli-explore-agent.toml} +8 -7
  5. package/.codex/agents/{cli-lite-planning-agent.md → cli-lite-planning-agent.toml} +8 -13
  6. package/.codex/agents/{cli-planning-agent.md → cli-planning-agent.toml} +553 -562
  7. package/.codex/agents/{code-developer.md → code-developer.toml} +9 -18
  8. package/.codex/agents/{conceptual-planning-agent.md → conceptual-planning-agent.toml} +304 -321
  9. package/.codex/agents/{context-search-agent.md → context-search-agent.toml} +8 -17
  10. package/.codex/agents/{debug-explore-agent.md → debug-explore-agent.toml} +437 -436
  11. package/.codex/agents/{doc-generator.md → doc-generator.toml} +325 -334
  12. package/.codex/agents/{issue-plan-agent.md → issue-plan-agent.toml} +8 -7
  13. package/.codex/agents/{issue-queue-agent.md → issue-queue-agent.toml} +312 -311
  14. package/.codex/agents/{memory-bridge.md → memory-bridge.toml} +9 -6
  15. package/.codex/agents/{tdd-developer.md → tdd-developer.toml} +500 -512
  16. package/.codex/agents/{test-action-planning-agent.md → test-action-planning-agent.toml} +676 -684
  17. package/.codex/agents/{test-context-search-agent.md → test-context-search-agent.toml} +8 -18
  18. package/.codex/agents/{test-fix-agent.md → test-fix-agent.toml} +9 -23
  19. package/.codex/agents/{ui-design-agent.md → ui-design-agent.toml} +8 -26
  20. package/.codex/agents/{universal-executor.md → universal-executor.toml} +9 -18
  21. package/.codex/skills/brainstorm/SKILL.md +3 -3
  22. package/.codex/skills/brainstorm-with-file/SKILL.md +17 -19
  23. package/.codex/skills/clean/SKILL.md +2 -2
  24. package/.codex/skills/issue-discover/SKILL.md +3 -3
  25. package/.codex/skills/issue-discover/phases/02-discover.md +6 -6
  26. package/.codex/skills/issue-discover/phases/03-discover-by-prompt.md +4 -4
  27. package/.codex/skills/parallel-dev-cycle/phases/02-agent-execution.md +8 -8
  28. package/.codex/skills/review-cycle/SKILL.md +3 -3
  29. package/.codex/skills/review-cycle/phases/02-parallel-review.md +26 -26
  30. package/.codex/skills/review-cycle/phases/04-iterative-deep-dive.md +18 -18
  31. package/.codex/skills/review-cycle/phases/07-fix-parallel-planning.md +2 -2
  32. package/.codex/skills/review-cycle/phases/08-fix-execution.md +2 -2
  33. package/.codex/skills/roadmap-with-file/SKILL.md +9 -9
  34. package/.codex/skills/spec-setup/SKILL.md +2 -2
  35. package/.codex/skills/workflow-plan/SKILL.md +5 -5
  36. package/.codex/skills/workflow-tdd-plan/SKILL.md +4 -4
  37. package/.codex/skills/workflow-test-fix-cycle/SKILL.md +14 -14
  38. package/.codex/skills/workflow-test-fix-cycle/phases/01-test-fix-gen.md +12 -12
  39. package/.codex/skills/workflow-test-fix-cycle/phases/02-test-cycle-execute.md +6 -6
  40. package/package.json +1 -1
@@ -1,20 +1,10 @@
1
- ---
2
- name: test-context-search-agent
3
- description: |
4
- Specialized context collector for test generation workflows. Analyzes test coverage, identifies missing tests, loads implementation context from source sessions, and generates standardized test-context packages.
5
-
6
- Examples:
7
- - Context: Test session with source session reference
8
- user: "Gather test context for WFS-test-auth session"
9
- assistant: "I'll load source implementation, analyze test coverage, and generate test-context package"
10
- commentary: Execute autonomous coverage analysis with source context loading
11
-
12
- - Context: Multi-framework detection needed
13
- user: "Collect test context for full-stack project"
14
- assistant: "I'll detect Jest frontend and pytest backend frameworks, analyze coverage gaps"
15
- commentary: Identify framework patterns and conventions for each stack
16
- color: blue
17
- ---
1
+ name = "test_context_search_agent"
2
+ description = "Specialized context collector for test generation workflows. Analyzes test coverage, identifies missing tests, loads implementation context from source sessions, and generates standardized test-context packages."
3
+ model = "gpt-5.4"
4
+ model_reasoning_effort = "high"
5
+ sandbox_mode = "read-only"
6
+
7
+ developer_instructions = """
18
8
 
19
9
  You are a test context discovery specialist focused on gathering test coverage information and implementation context for test generation workflows. Execute multi-phase analysis autonomously to build comprehensive test-context packages.
20
10
 
@@ -399,4 +389,4 @@ function detect_framework_from_config() {
399
389
  - ✅ Valid test-context-package.json generated
400
390
  - ✅ All missing tests catalogued with priority
401
391
  - ✅ Execution time < 30 seconds (< 60s for large codebases)
402
-
392
+ """
@@ -1,25 +1,10 @@
1
- ---
2
- name: test-fix-agent
3
- description: |
4
- Execute tests, diagnose failures, and fix code until all tests pass. This agent focuses on running test suites, analyzing failures, and modifying source code to resolve issues. When all tests pass, the code is considered approved and ready for deployment.
5
-
6
- Examples:
7
- - Context: After implementation with tests completed
8
- user: "The authentication module implementation is complete with tests"
9
- assistant: "I'll use the test-fix-agent to execute the test suite and fix any failures"
10
- commentary: Use test-fix-agent to validate implementation through comprehensive test execution.
11
-
12
- - Context: When tests are failing
13
- user: "The integration tests are failing for the payment module"
14
- assistant: "I'll have the test-fix-agent diagnose the failures and fix the source code"
15
- commentary: test-fix-agent analyzes test failures and modifies code to resolve them.
16
-
17
- - Context: Continuous validation
18
- user: "Run the full test suite and ensure everything passes"
19
- assistant: "I'll use the test-fix-agent to execute all tests and fix any issues found"
20
- commentary: test-fix-agent serves as the quality gate - passing tests = approved code.
21
- color: green
22
- ---
1
+ name = "test_fix_agent"
2
+ description = "Execute tests, diagnose failures, and fix code until all tests pass. This agent focuses on running test suites, analyzing failures, and modifying source code to resolve issues. When all tests pass, the code is considered approved and ready for deployment."
3
+ model = "gpt-5.4"
4
+ model_reasoning_effort = "high"
5
+ sandbox_mode = "workspace-write"
6
+
7
+ developer_instructions = """
23
8
 
24
9
  You are a specialized **Test Execution & Fix Agent**. Your purpose is to execute test suites across multiple layers (Static, Unit, Integration, E2E), diagnose failures with layer-specific context, and fix source code until all tests pass. You operate with the precision of a senior debugging engineer, ensuring code quality through comprehensive multi-layered test validation.
25
10
 
@@ -368,4 +353,5 @@ jq --arg ts "$(date -Iseconds)" '.status="completed" | .status_history += [{"fro
368
353
 
369
354
  **Tests passing = Code approved = Mission complete** ✅
370
355
  ### Windows Path Format Guidelines
371
- - **Quick Ref**: `C:\Users` → MCP: `C:\\Users` | Bash: `/c/Users` or `C:/Users`
356
+ - **Quick Ref**: `C:\Users` → MCP: `C:\\Users` | Bash: `/c/Users` or `C:/Users`
357
+ """
@@ -1,29 +1,10 @@
1
- ---
2
- name: ui-design-agent
3
- description: |
4
- Specialized agent for UI design token management and prototype generation with W3C Design Tokens Format compliance.
5
-
6
- Core capabilities:
7
- - W3C Design Tokens Format implementation with $type metadata and structured values
8
- - State-based component definitions (default, hover, focus, active, disabled)
9
- - Complete component library coverage (12+ interactive components)
10
- - Animation-component state integration with keyframe mapping
11
- - Optimized layout templates (single source of truth, zero redundancy)
12
- - WCAG AA compliance validation and accessibility patterns
13
- - Token-driven prototype generation with semantic markup
14
- - Cross-platform responsive design (mobile, tablet, desktop)
15
-
16
- Integration points:
17
- - Exa MCP: Design trend research (web search), code implementation examples (code search), accessibility patterns
18
-
19
- Key optimizations:
20
- - Eliminates color definition redundancy via light/dark mode values
21
- - Structured component styles replacing CSS class strings
22
- - Unified layout structure (DOM + styling co-located)
23
- - Token reference integrity validation ({token.path} syntax)
24
-
25
- color: orange
26
- ---
1
+ name = "ui_design_agent"
2
+ description = "Specialized agent for UI design token management and prototype generation with W3C Design Tokens Format compliance."
3
+ model = "gpt-5.4"
4
+ model_reasoning_effort = "high"
5
+ sandbox_mode = "workspace-write"
6
+
7
+ developer_instructions = """
27
8
 
28
9
  You are a specialized **UI Design Agent** that executes design generation tasks autonomously to produce production-ready design systems and prototypes.
29
10
 
@@ -593,3 +574,4 @@ mcp__exa__get_code_context_exa(
593
574
  outline-offset: 2px;
594
575
  }
595
576
  ```
577
+ """
@@ -1,20 +1,10 @@
1
- ---
2
- name: universal-executor
3
- description: |
4
- Versatile execution agent for implementing any task efficiently. Adapts to any domain while maintaining quality standards and systematic execution. Can handle analysis, implementation, documentation, research, and complex multi-step workflows.
5
-
6
- Examples:
7
- - Context: User provides task with sufficient context
8
- user: "Analyze market trends and create presentation following these guidelines: [context]"
9
- assistant: "I'll analyze the market trends and create the presentation using the provided guidelines"
10
- commentary: Execute task directly with user-provided context
11
-
12
- - Context: User provides insufficient context
13
- user: "Organize project documentation"
14
- assistant: "I need to understand the current documentation structure first"
15
- commentary: Gather context about existing documentation, then execute
16
- color: green
17
- ---
1
+ name = "universal_executor"
2
+ description = "Versatile execution agent for implementing any task efficiently. Adapts to any domain while maintaining quality standards and systematic execution. Can handle analysis, implementation, documentation, research, and complex multi-step workflows."
3
+ model = "gpt-5.4"
4
+ model_reasoning_effort = "high"
5
+ sandbox_mode = "workspace-write"
6
+
7
+ developer_instructions = """
18
8
 
19
9
  You are a versatile execution specialist focused on completing high-quality tasks efficiently across any domain. You receive tasks with context and execute them systematically using proven methodologies.
20
10
 
@@ -132,4 +122,5 @@ Before completing any task, verify:
132
122
  - Handle edge cases appropriately
133
123
  - Keep tasks focused and manageable
134
124
  - Generate detailed summary documents with complete deliverable listings
135
- - Document all key outputs and integration points for dependent tasks
125
+ - Document all key outputs and integration points for dependent tasks
126
+ """
@@ -69,7 +69,7 @@ Dual-mode brainstorming with CSV-driven parallel role analysis. Auto mode runs a
69
69
  │ ═══ Single Role Mode ═══ │
70
70
  │ │
71
71
  │ Phase 3S: Single Role Analysis (spawn_agent) │
72
- │ ├─ spawn_agent(conceptual-planning-agent) │
72
+ │ ├─ spawn_agent(conceptual_planning_agent) │
73
73
  │ └─ Output: {role}/analysis*.md │
74
74
  │ │
75
75
  └──────────────────────────────────────────────────────────────────┘
@@ -536,7 +536,7 @@ if (executionMode === 'single-role') {
536
536
  Bash(`mkdir -p "${roleDir}"`)
537
537
 
538
538
  const agentId = spawn_agent({
539
- agent: `~/.codex/agents/conceptual-planning-agent.md`,
539
+ agent_type: "conceptual_planning_agent",
540
540
  instruction: `
541
541
  Perform a ${roleName} analysis for the brainstorming session.
542
542
 
@@ -594,7 +594,7 @@ Follow the same analysis protocol as wave role analysis but with interactive ref
594
594
 
595
595
  ```javascript
596
596
  const synthesisAgent = spawn_agent({
597
- agent: `~/.codex/agents/conceptual-planning-agent.md`,
597
+ agent_type: "conceptual_planning_agent",
598
598
  instruction: `
599
599
  ## SYNTHESIS ASSIGNMENT
600
600
 
@@ -20,7 +20,7 @@ Interactive brainstorming workflow with **documented thought evolution**. Expand
20
20
 
21
21
  **Codex-Specific Features**:
22
22
  - Parallel subagent execution via `spawn_agent` + batch `wait({ ids: [...] })`
23
- - Role loading via path (agent reads `~/.codex/agents/*.md` itself)
23
+ - Role loading via TOML agent definition (agent_type parameter in spawn_agent)
24
24
  - Deep interaction with `send_input` for multi-round refinement within single agent
25
25
  - Explicit lifecycle management with `close_agent`
26
26
 
@@ -208,12 +208,10 @@ Generate key questions that guide the brainstorming exploration. Use a subagent
208
208
 
209
209
  ```javascript
210
210
  const vectorAgent = spawn_agent({
211
+ agent_type: "cli_explore_agent",
211
212
  message: `
212
213
  ## TASK ASSIGNMENT
213
214
 
214
- ### MANDATORY FIRST STEPS (Agent Execute)
215
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
216
-
217
215
  ---
218
216
 
219
217
  ## Context
@@ -302,9 +300,9 @@ Spawn 3 perspective agents in parallel: Creative + Pragmatic + Systematic.
302
300
 
303
301
  | Perspective | Role File | Focus |
304
302
  |-------------|-----------|-------|
305
- | Creative | `~/.codex/agents/cli-explore-agent.md` | Innovation, cross-domain inspiration, challenging assumptions |
306
- | Pragmatic | `~/.codex/agents/cli-explore-agent.md` | Implementation feasibility, effort estimates, blockers |
307
- | Systematic | `~/.codex/agents/cli-explore-agent.md` | Problem decomposition, patterns, scalability |
303
+ | Creative | `cli_explore_agent` | Innovation, cross-domain inspiration, challenging assumptions |
304
+ | Pragmatic | `cli_explore_agent` | Implementation feasibility, effort estimates, blockers |
305
+ | Systematic | `cli_explore_agent` | Problem decomposition, patterns, scalability |
308
306
 
309
307
  **Parallel Subagent Execution**:
310
308
 
@@ -353,13 +351,13 @@ const perspectives = [
353
351
  // Parallel spawn - all agents start immediately
354
352
  const agentIds = perspectives.map(perspective => {
355
353
  return spawn_agent({
354
+ agent_type: "cli_explore_agent",
356
355
  message: `
357
356
  ## TASK ASSIGNMENT
358
357
 
359
358
  ### MANDATORY FIRST STEPS (Agent Execute)
360
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
361
- 2. Run: `ccw spec load --category "exploration planning"`
362
- 3. Read project tech context from loaded specs
359
+ 1. Run: `ccw spec load --category "exploration planning"`
360
+ 2. Read project tech context from loaded specs
363
361
 
364
362
  ---
365
363
 
@@ -560,13 +558,13 @@ const deepDiveResult = wait({ ids: [perspectiveAgent], timeout_ms: 600000 })
560
558
 
561
559
  ```javascript
562
560
  const deepDiveAgent = spawn_agent({
561
+ agent_type: "cli_explore_agent",
563
562
  message: `
564
563
  ## TASK ASSIGNMENT
565
564
 
566
565
  ### MANDATORY FIRST STEPS (Agent Execute)
567
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
568
- 2. Read: ${sessionFolder}/perspectives.json (prior findings)
569
- 3. Run: `ccw spec load --category "exploration planning"`
566
+ 1. Read: ${sessionFolder}/perspectives.json (prior findings)
567
+ 2. Run: `ccw spec load --category "exploration planning"`
570
568
 
571
569
  ---
572
570
 
@@ -606,12 +604,12 @@ When user selects "challenge", spawn a dedicated challenge agent.
606
604
 
607
605
  ```javascript
608
606
  const challengeAgent = spawn_agent({
607
+ agent_type: "cli_explore_agent",
609
608
  message: `
610
609
  ## TASK ASSIGNMENT
611
610
 
612
611
  ### MANDATORY FIRST STEPS (Agent Execute)
613
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
614
- 2. Read: ${sessionFolder}/perspectives.json (ideas to challenge)
612
+ 1. Read: ${sessionFolder}/perspectives.json (ideas to challenge)
615
613
 
616
614
  ---
617
615
 
@@ -659,12 +657,12 @@ When user selects "merge", synthesize complementary ideas.
659
657
 
660
658
  ```javascript
661
659
  const mergeAgent = spawn_agent({
660
+ agent_type: "cli_explore_agent",
662
661
  message: `
663
662
  ## TASK ASSIGNMENT
664
663
 
665
664
  ### MANDATORY FIRST STEPS (Agent Execute)
666
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
667
- 2. Read: ${sessionFolder}/perspectives.json (source ideas)
665
+ 1. Read: ${sessionFolder}/perspectives.json (source ideas)
668
666
 
669
667
  ---
670
668
 
@@ -888,7 +886,7 @@ Dimensions guide brainstorming scope and focus:
888
886
  ```javascript
889
887
  // Safe parallel execution with error handling
890
888
  try {
891
- const agentIds = perspectives.map(p => spawn_agent({ message: buildPrompt(p) }))
889
+ const agentIds = perspectives.map(p => spawn_agent({ agent_type: "cli_explore_agent", message: buildPrompt(p) }))
892
890
 
893
891
  const results = wait({ ids: agentIds, timeout_ms: 600000 })
894
892
 
@@ -1014,7 +1012,7 @@ Final synthesis:
1014
1012
 
1015
1013
  ### Codex Subagent Best Practices
1016
1014
 
1017
- 1. **Role Path, Not Content**: Pass `~/.codex/agents/*.md` path in message, let agent read itself
1015
+ 1. **Agent Type, Not Path**: Use `agent_type` parameter in spawn_agent, not manual file path reading
1018
1016
  2. **Parallel for Perspectives**: Use batch spawn + wait for 3 perspective agents
1019
1017
  3. **Delay close_agent for Refinement**: Keep perspective agents alive for `send_input` reuse
1020
1018
  4. **Batch wait**: Use `wait({ ids: [a, b, c] })` for parallel agents, not sequential waits
@@ -159,12 +159,12 @@ let exploreAgent = null
159
159
  try {
160
160
  // Launch cli-explore-agent
161
161
  exploreAgent = spawn_agent({
162
+ agent_type: "cli_explore_agent",
162
163
  message: `
163
164
  ## TASK ASSIGNMENT
164
165
 
165
166
  ### MANDATORY FIRST STEPS
166
- 1. Read: ~/.codex/agents/cli-explore-agent.md
167
- 2. Read: ${projectRoot}/.workflow/project-tech.json (if exists)
167
+ 1. Read: ${projectRoot}/.workflow/project-tech.json (if exists)
168
168
 
169
169
  ## Task Objective
170
170
  Discover stale artifacts for cleanup.
@@ -229,13 +229,13 @@ Create a new subagent with task assignment.
229
229
 
230
230
  ```javascript
231
231
  const agentId = spawn_agent({
232
+ agent_type: "{agent_type}",
232
233
  message: `
233
234
  ## TASK ASSIGNMENT
234
235
 
235
236
  ### MANDATORY FIRST STEPS (Agent Execute)
236
- 1. **Read role definition**: ~/.codex/agents/{agent-type}.md (MUST read first)
237
- 2. Execute: ccw spec load --category exploration
238
- 3. Execute: ccw spec load --category debug (known issues cross-reference)
237
+ 1. Execute: ccw spec load --category exploration
238
+ 2. Execute: ccw spec load --category debug (known issues cross-reference)
239
239
 
240
240
  ## TASK CONTEXT
241
241
  ${taskContext}
@@ -114,13 +114,13 @@ const perspectiveAgents = [];
114
114
 
115
115
  selectedPerspectives.forEach(perspective => {
116
116
  const agentId = spawn_agent({
117
+ agent_type: "cli_explore_agent",
117
118
  message: `
118
119
  ## TASK ASSIGNMENT
119
120
 
120
121
  ### MANDATORY FIRST STEPS (Agent Execute)
121
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
122
- 2. Read: {projectRoot}/.workflow/project-tech.json
123
- 3. Read: {projectRoot}/.workflow/specs/*.md
122
+ 1. Read: {projectRoot}/.workflow/project-tech.json
123
+ 2. Read: {projectRoot}/.workflow/specs/*.md
124
124
 
125
125
  ---
126
126
 
@@ -192,13 +192,13 @@ agentIds.forEach(id => close_agent({ id }));
192
192
  // Only spawn if perspective requires external research
193
193
  if (selectedPerspectives.includes('security') || selectedPerspectives.includes('best-practices') || args.external) {
194
194
  const exaAgentId = spawn_agent({
195
+ agent_type: "cli_explore_agent",
195
196
  message: `
196
197
  ## TASK ASSIGNMENT
197
198
 
198
199
  ### MANDATORY FIRST STEPS (Agent Execute)
199
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
200
- 2. Read: {projectRoot}/.workflow/project-tech.json
201
- 3. Read: {projectRoot}/.workflow/specs/*.md
200
+ 1. Read: {projectRoot}/.workflow/project-tech.json
201
+ 2. Read: {projectRoot}/.workflow/specs/*.md
202
202
 
203
203
  ---
204
204
 
@@ -234,6 +234,7 @@ while (shouldContinue && iteration < maxIterations) {
234
234
 
235
235
  iterationPlan.dimensions.forEach(dimension => {
236
236
  const agentId = spawn_agent({
237
+ agent_type: "cli_explore_agent",
237
238
  message: buildDimensionPromptWithACE(dimension, iteration, cumulativeFindings, iterationAceResults, iterationDir)
238
239
  });
239
240
  dimensionAgents.push({ agentId, dimension });
@@ -413,12 +414,11 @@ function buildDimensionPromptWithACE(dimension, iteration, previousFindings, ace
413
414
  );
414
415
 
415
416
  return `
416
- ## TASK ASSIGNMENT
417
+ ## TASK ASSIGNMENT (agent_type: cli_explore_agent)
417
418
 
418
419
  ### MANDATORY FIRST STEPS (Agent Execute)
419
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
420
- 2. Read: {projectRoot}/.workflow/project-tech.json
421
- 3. Read: {projectRoot}/.workflow/specs/*.md
420
+ 1. Read: {projectRoot}/.workflow/project-tech.json
421
+ 2. Read: {projectRoot}/.workflow/specs/*.md
422
422
 
423
423
  ---
424
424
 
@@ -80,12 +80,12 @@ Cross-reference the task description against these documents for completeness.
80
80
  const focusDirective = getAgentFocusDirective('ra', state)
81
81
 
82
82
  return spawn_agent({
83
+ agent_type: "requirements_analyst",
83
84
  message: `
84
85
  ## TASK ASSIGNMENT
85
86
 
86
87
  ### MANDATORY FIRST STEPS (Agent Execute)
87
- 1. **Read role definition**: ~/.codex/agents/requirements-analyst.md
88
- 2. Read: ${projectRoot}/.workflow/project-tech.json (if exists)
88
+ 1. Read: ${projectRoot}/.workflow/project-tech.json (if exists)
89
89
  3. Read: ${projectRoot}/.workflow/specs/*.md (if exists)
90
90
  4. Read: ${projectRoot}/.workflow/.cycle/${cycleId}.progress/coordination/feedback.md (if exists)
91
91
 
@@ -163,12 +163,12 @@ PHASE_RESULT:
163
163
  ```javascript
164
164
  function spawnEPAgent(cycleId, state, progressDir) {
165
165
  return spawn_agent({
166
+ agent_type: "exploration_planner",
166
167
  message: `
167
168
  ## TASK ASSIGNMENT
168
169
 
169
170
  ### MANDATORY FIRST STEPS (Agent Execute)
170
- 1. **Read role definition**: ~/.codex/agents/exploration-planner.md
171
- 2. Read: ${projectRoot}/.workflow/project-tech.json
171
+ 1. Read: ${projectRoot}/.workflow/project-tech.json
172
172
  3. Read: ${projectRoot}/.workflow/specs/*.md
173
173
  4. Read: ${progressDir}/ra/requirements.md
174
174
 
@@ -242,12 +242,12 @@ PHASE_RESULT:
242
242
  ```javascript
243
243
  function spawnCDAgent(cycleId, state, progressDir) {
244
244
  return spawn_agent({
245
+ agent_type: "code_developer",
245
246
  message: `
246
247
  ## TASK ASSIGNMENT
247
248
 
248
249
  ### MANDATORY FIRST STEPS (Agent Execute)
249
- 1. **Read role definition**: ~/.codex/agents/code-developer.md
250
- 2. Read: ${progressDir}/ep/plan.json
250
+ 1. Read: ${progressDir}/ep/plan.json
251
251
  3. Read: ${progressDir}/ra/requirements.md
252
252
 
253
253
  ---
@@ -320,12 +320,12 @@ PHASE_RESULT:
320
320
  ```javascript
321
321
  function spawnVASAgent(cycleId, state, progressDir) {
322
322
  return spawn_agent({
323
+ agent_type: "validation_archivist",
323
324
  message: `
324
325
  ## TASK ASSIGNMENT
325
326
 
326
327
  ### MANDATORY FIRST STEPS (Agent Execute)
327
- 1. **Read role definition**: ~/.codex/agents/validation-archivist.md
328
- 2. Read: ${progressDir}/cd/changes.log
328
+ 1. Read: ${progressDir}/cd/changes.log
329
329
 
330
330
  ---
331
331
 
@@ -50,7 +50,7 @@ Unified multi-dimensional code review orchestrator with dual-mode (session/modul
50
50
  3. **Progressive Phase Loading**: Phase docs are read on-demand when that phase executes, not all at once
51
51
  4. **Auto-Continue**: All phases run autonomously without user intervention between phases
52
52
  5. **Subagent Lifecycle**: Explicit lifecycle management with spawn_agent → wait → close_agent
53
- 6. **Role Path Loading**: Subagent roles loaded via path reference in MANDATORY FIRST STEPS
53
+ 6. **Role via agent_type**: Subagent roles loaded via TOML `agent_type` parameter in spawn_agent (e.g., `"cli_explore_agent"`)
54
54
  7. **Optional Fix Pipeline**: Phase 6-9 triggered only by explicit `--fix` flag or user confirmation after Phase 5
55
55
  8. **Content Preservation**: All agent prompts, code, schemas preserved verbatim from source commands
56
56
 
@@ -298,12 +298,12 @@ Create a new subagent with task assignment.
298
298
 
299
299
  ```javascript
300
300
  const agentId = spawn_agent({
301
+ agent_type: "{agent_type}", // TOML agent definition name (e.g., "cli_explore_agent")
301
302
  message: `
302
303
  ## TASK ASSIGNMENT
303
304
 
304
305
  ### MANDATORY FIRST STEPS (Agent Execute)
305
- 1. **Read role definition**: ~/.codex/agents/{agent-type}.md (MUST read first)
306
- 2. Execute: ccw spec load --category "exploration execution"
306
+ 1. Execute: ccw spec load --category "exploration execution"
307
307
 
308
308
  ---
309
309
 
@@ -85,17 +85,17 @@ const dimensions = ['security', 'architecture', 'quality', 'action-items', 'perf
85
85
 
86
86
  dimensions.forEach(dimension => {
87
87
  const agentId = spawn_agent({
88
+ agent_type: "cli_explore_agent",
88
89
  message: `
89
90
  ## TASK ASSIGNMENT
90
91
 
91
92
  ### MANDATORY FIRST STEPS (Agent Execute)
92
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
93
- 2. Read review state: ${reviewStateJsonPath}
94
- 3. Get target files: Read resolved_files from review-state.json
95
- 4. Validate file access: bash(ls -la ${targetFiles.join(' ')})
96
- 5. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-dimension-results-schema.json (get output schema reference)
97
- 6. Execute: ccw spec load --category "exploration execution" (technology stack and constraints)
98
- 7. Execute: ccw spec load --category review (review standards and checklists)
93
+ 1. Read review state: ${reviewStateJsonPath}
94
+ 2. Get target files: Read resolved_files from review-state.json
95
+ 3. Validate file access: bash(ls -la ${targetFiles.join(' ')})
96
+ 4. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-dimension-results-schema.json (get output schema reference)
97
+ 5. Execute: ccw spec load --category "exploration execution" (technology stack and constraints)
98
+ 6. Execute: ccw spec load --category review (review standards and checklists)
99
99
 
100
100
  ---
101
101
 
@@ -124,7 +124,7 @@ Use **Deep Scan mode** for this review:
124
124
 
125
125
  ## Expected Deliverables
126
126
 
127
- **Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 5, follow schema exactly
127
+ **Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 4, follow schema exactly
128
128
 
129
129
  1. Dimension Results JSON: ${outputDir}/dimensions/${dimension}.json
130
130
 
@@ -207,18 +207,18 @@ const dimensions = ['security', 'architecture', 'quality', 'action-items', 'perf
207
207
 
208
208
  dimensions.forEach(dimension => {
209
209
  const agentId = spawn_agent({
210
+ agent_type: "cli_explore_agent",
210
211
  message: `
211
212
  ## TASK ASSIGNMENT
212
213
 
213
214
  ### MANDATORY FIRST STEPS (Agent Execute)
214
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
215
- 2. Read session metadata: ${sessionMetadataPath}
216
- 3. Read completed task summaries: bash(find ${summariesDir} -name "IMPL-*.md" -type f)
217
- 4. Get changed files: bash(cd ${workflowDir} && git log --since="${sessionCreatedAt}" --name-only --pretty=format: | sort -u)
218
- 5. Read review state: ${reviewStateJsonPath}
219
- 6. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-dimension-results-schema.json (get output schema reference)
220
- 7. Execute: ccw spec load --category "exploration execution" (technology stack and constraints)
221
- 8. Execute: ccw spec load --category review (review standards and checklists)
215
+ 1. Read session metadata: ${sessionMetadataPath}
216
+ 2. Read completed task summaries: bash(find ${summariesDir} -name "IMPL-*.md" -type f)
217
+ 3. Get changed files: bash(cd ${workflowDir} && git log --since="${sessionCreatedAt}" --name-only --pretty=format: | sort -u)
218
+ 4. Read review state: ${reviewStateJsonPath}
219
+ 5. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-dimension-results-schema.json (get output schema reference)
220
+ 6. Execute: ccw spec load --category "exploration execution" (technology stack and constraints)
221
+ 7. Execute: ccw spec load --category review (review standards and checklists)
222
222
 
223
223
  ---
224
224
 
@@ -247,7 +247,7 @@ Use **Deep Scan mode** for this review:
247
247
 
248
248
  ## Expected Deliverables
249
249
 
250
- **Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 6, follow schema exactly
250
+ **Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 5, follow schema exactly
251
251
 
252
252
  1. Dimension Results JSON: ${outputDir}/dimensions/${dimension}.json
253
253
 
@@ -326,18 +326,18 @@ reviewAgents.forEach(id => close_agent({ id }));
326
326
  ```javascript
327
327
  // Spawn deep-dive agent
328
328
  const deepDiveAgentId = spawn_agent({
329
+ agent_type: "cli_explore_agent",
329
330
  message: `
330
331
  ## TASK ASSIGNMENT
331
332
 
332
333
  ### MANDATORY FIRST STEPS (Agent Execute)
333
- 1. **Read role definition**: ~/.codex/agents/cli-explore-agent.md (MUST read first)
334
- 2. Read original finding: ${dimensionJsonPath}
335
- 3. Read affected file: ${file}
336
- 4. Identify related code: bash(grep -r "import.*${basename(file)}" ${projectDir}/src --include="*.ts")
337
- 5. Read test files: bash(find ${projectDir}/tests -name "*${basename(file, '.ts')}*" -type f)
338
- 6. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-deep-dive-results-schema.json (get output schema reference)
339
- 7. Execute: ccw spec load --category "exploration execution" (technology stack and constraints for remediation)
340
- 8. Execute: ccw spec load --category review (review standards and checklists)
334
+ 1. Read original finding: ${dimensionJsonPath}
335
+ 2. Read affected file: ${file}
336
+ 3. Identify related code: bash(grep -r "import.*${basename(file)}" ${projectDir}/src --include="*.ts")
337
+ 4. Read test files: bash(find ${projectDir}/tests -name "*${basename(file, '.ts')}*" -type f)
338
+ 5. Execute: cat ~/.ccw/workflows/cli-templates/schemas/review-deep-dive-results-schema.json (get output schema reference)
339
+ 6. Execute: ccw spec load --category "exploration execution" (technology stack and constraints for remediation)
340
+ 7. Execute: ccw spec load --category review (review standards and checklists)
341
341
 
342
342
  ---
343
343
 
@@ -372,7 +372,7 @@ Then apply **Deep Scan mode** for semantic analysis:
372
372
 
373
373
  ## Expected Deliverables
374
374
 
375
- **Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 6, follow schema exactly
375
+ **Schema Reference**: Schema obtained in MANDATORY FIRST STEPS step 5, follow schema exactly
376
376
 
377
377
  1. Deep-Dive Results JSON: ${outputDir}/iterations/iteration-${iteration}-finding-${findingId}.json
378
378