claude-code-workflow 7.2.28 → 7.2.29

package/.codex/skills/brainstorm/SKILL.md

@@ -5,7 +5,7 @@ description: |
   (spawn_agents_on_csv) → cross-role synthesis. Single role mode: individual role analysis.
   CSV-driven parallel coordination with NDJSON discovery board.
 argument-hint: "[-y|--yes] [--count N] [--session ID] [--skip-questions] [--style-skill PKG] \"topic\" | <role-name> [--session ID]"
-allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, request_user_input, Read, Write, Edit, Bash, Glob, Grep
+allowed-tools: spawn_agents_on_csv, spawn_agent, wait_agent, send_message, assign_task, close_agent, request_user_input, Read, Write, Edit, Bash, Glob, Grep
 ---
 
 ## Auto Mode
@@ -556,7 +556,7 @@ Follow the same analysis protocol as wave role analysis but with interactive ref
 `
   })
 
-  wait({ id: agentId })
+  wait_agent({ targets: [agentId] })
   close_agent({ id: agentId })
 
   console.log(`\n✓ ${roleName} analysis complete: ${roleDir}/analysis.md`)
@@ -631,7 +631,7 @@ Evaluate complexity score (0-8):
 `
    })
 
-   wait({ id: synthesisAgent })
+   wait_agent({ targets: [synthesisAgent] })
    close_agent({ id: synthesisAgent })
    ```
 

package/.codex/skills/clean/SKILL.md

@@ -204,11 +204,11 @@ Format:
   })
 
   // Wait with timeout handling
-  let result = wait({ ids: [exploreAgent], timeout_ms: 600000 })
+  let result = wait_agent({ targets: [exploreAgent], timeout_ms: 600000 })
 
   if (result.timed_out) {
-    send_input({ id: exploreAgent, message: 'Complete now and write cleanup-manifest.json.' })
-    result = wait({ ids: [exploreAgent], timeout_ms: 300000 })
+    assign_task({ target: exploreAgent, items: [{ type: "text", text: "Complete now and write cleanup-manifest.json." }] })
+    result = wait_agent({ targets: [exploreAgent], timeout_ms: 300000 })
     if (result.timed_out) throw new Error('Agent timeout')
   }
 

package/.codex/skills/issue-discover/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: issue-discover
 description: "Unified issue discovery and creation. Create issues from GitHub/text, discover issues via multi-perspective analysis, or prompt-driven iterative exploration. Triggers on \"issue:new\", \"issue:discover\", \"issue:discover-by-prompt\", \"create issue\", \"discover issues\", \"find issues\"."
-allowed-tools: spawn_agent, wait, send_input, close_agent, request_user_input, Read, Write, Edit, Bash, Glob, Grep, mcp__ace-tool__search_context, mcp__exa__search
+allowed-tools: spawn_agent, wait_agent, send_message, assign_task, close_agent, request_user_input, Read, Write, Edit, Bash, Glob, Grep, mcp__ace-tool__search_context, mcp__exa__search
 ---
 
 # Issue Discover
@@ -54,7 +54,7 @@ Unified issue discovery and creation skill covering three entry points: manual i
 2. **Progressive Phase Loading**: Only read the selected phase document
 3. **CLI-First Data Access**: All issue CRUD via `ccw issue` CLI commands
 4. **Auto Mode Support**: `-y` flag skips action selection with auto-detection
-5. **Subagent Lifecycle**: Explicit lifecycle management with spawn_agent → wait → close_agent
+5. **Subagent Lifecycle**: Explicit lifecycle management with spawn_agent → wait_agent → close_agent
 6. **Role Path Loading**: Subagent roles loaded via path reference in MANDATORY FIRST STEPS
 
 ## Auto Mode
@@ -130,7 +130,7 @@ Post-Phase:
 5. **Auto-Detect Input**: Smart input parsing reduces need for explicit --action flag
 6. **⚠️ CRITICAL: DO NOT STOP**: Continuous multi-phase workflow. After completing each phase, immediately proceed to next
 7. **Progressive Phase Loading**: Read phase docs ONLY when that phase is about to execute
-8. **Explicit Lifecycle**: Always close_agent after wait completes to free resources
+8. **Explicit Lifecycle**: Always close_agent after wait_agent completes to free resources
 
 ## Input Processing
 
@@ -246,18 +246,18 @@ ${deliverables}
 })
 ```
 
-### wait
+### wait_agent
 
 Get results from subagent (only way to retrieve results).
 
 ```javascript
-const result = wait({
-  ids: [agentId],
+const result = wait_agent({
+  targets: [agentId],
   timeout_ms: 600000  // 10 minutes
 })
 
 if (result.timed_out) {
-  // Handle timeout - can continue waiting or send_input to prompt completion
+  // Handle timeout - can use assign_task to prompt completion
 }
 
 // Check completion status
@@ -266,20 +266,20 @@ if (result.status[agentId].completed) {
 }
 ```
 
-### send_input
+### assign_task
 
-Continue interaction with active subagent (for clarification or follow-up).
+Assign new work to active subagent (for clarification or follow-up).
 
 ```javascript
-send_input({
-  id: agentId,
-  message: `
+assign_task({
+  target: agentId,
+  items: [{ type: "text", text: `
 ## CLARIFICATION ANSWERS
 ${answers}
 
 ## NEXT STEP
 Continue with plan generation.
-`
+` }]
 })
 ```
 

package/.codex/skills/issue-discover/phases/02-discover.md

@@ -164,8 +164,8 @@ ${getPerspectiveGuidance(perspective)}
 
 // Step 2: Batch wait for all agents
 const agentIds = perspectiveAgents.map(a => a.agentId);
-const results = wait({
-  ids: agentIds,
+const results = wait_agent({
+  targets: agentIds,
   timeout_ms: 600000  // 10 minutes
 });
 
@@ -220,8 +220,8 @@ Research industry best practices for ${perspective} using Exa search
 `
   });
 
-  const exaResult = wait({
-    ids: [exaAgentId],
+  const exaResult = wait_agent({
+    targets: [exaAgentId],
     timeout_ms: 300000  // 5 minutes
   });
 

package/.codex/skills/issue-discover/phases/03-discover-by-prompt.md

@@ -242,8 +242,8 @@ while (shouldContinue && iteration < maxIterations) {
 
   // Step 2: Batch wait for all dimension agents
   const dimensionAgentIds = dimensionAgents.map(a => a.agentId);
-  const iterationResults = wait({
-    ids: dimensionAgentIds,
+  const iterationResults = wait_agent({
+    targets: dimensionAgentIds,
     timeout_ms: 600000  // 10 minutes
   });
 
@@ -297,7 +297,7 @@ while (shouldContinue && iteration < maxIterations) {
 │                                                             │
 │  2. Execute: Spawn agents for this iteration                │
 │     └─ Each agent: explore → collect → return summary       │
-│     └─ Lifecycle: spawn_agent → batch wait → close_agent    │
+│     └─ Lifecycle: spawn_agent → batch wait_agent → close_agent    │
 │                                                             │
 │  3. Analyze: Process iteration results                      │
 │     └─ New findings? Gaps? Contradictions?                  │

package/.codex/skills/parallel-dev-cycle/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: parallel-dev-cycle
 description: Multi-agent parallel development cycle with requirement analysis, exploration planning, code development, and validation. Orchestration runs inline in main flow (no separate orchestrator agent). Supports continuous iteration with markdown progress documentation. Triggers on "parallel-dev-cycle".
-allowed-tools: spawn_agent, wait, send_input, close_agent, request_user_input, Read, Write, Edit, Bash, Glob, Grep
+allowed-tools: spawn_agent, wait_agent, send_message, assign_task, close_agent, request_user_input, Read, Write, Edit, Bash, Glob, Grep
 ---
 
 # Parallel Dev Cycle
@@ -111,7 +111,7 @@ Phase 3: Result Aggregation & Iteration
       ├─ Parse PHASE_RESULT from each agent
       ├─ Detect issues (test failures, blockers)
       ├─ Decision: Issues found AND iteration < max?
-      │   ├─ Yes → Send feedback via send_input, loop back to Phase 2
+      │   ├─ Yes → Send feedback via assign_task, loop back to Phase 2
       │   └─ No → Proceed to Phase 4
       └─ Output: parsedResults, iteration status
 
@@ -330,7 +330,7 @@ PHASE_RESULT:
 
 ### Main Flow → Agent Communication
 
-Feedback via `send_input` (file refs + issue summary, never full content):
+Feedback via `assign_task` (file refs + issue summary, never full content):
 ```
 ## FEEDBACK FROM [Source]
 [Issue summary with file:line references]
@@ -357,7 +357,7 @@ Feedback via `send_input` (file refs + issue summary, never full content):
 
 | Error Type | Recovery |
 |------------|----------|
-| Agent timeout | send_input requesting convergence, then retry |
+| Agent timeout | assign_task requesting convergence, then retry |
 | State corrupted | Rebuild from progress markdown files and changes.log |
 | Agent failed | Re-spawn agent with previous context |
 | Conflicting results | Main flow sends reconciliation request |

package/.codex/skills/parallel-dev-cycle/phases/02-agent-execution.md

@@ -408,8 +408,8 @@ const agents = {
 
 // Wait for all agents to complete
 console.log('Waiting for all agents...')
-const results = wait({
-  ids: [agents.ra, agents.ep, agents.cd, agents.vas],
+const results = wait_agent({
+  targets: [agents.ra, agents.ep, agents.cd, agents.vas],
   timeout_ms: 1800000  // 30 minutes
 })
 ```
@@ -421,16 +421,16 @@ if (results.timed_out) {
   console.log('Some agents timed out, sending convergence request...')
   Object.entries(agents).forEach(([name, id]) => {
     if (!results.status[id].completed) {
-      send_input({
-        id: id,
-        message: `
+      assign_task({
+        target: id,
+        items: [{ type: "text", text: `
 ## TIMEOUT NOTIFICATION
 
 Execution timeout reached. Please:
 1. Output current progress to markdown file
 2. Save all state updates
 3. Return completion status
-`
+` }]
       })
     }
   })

package/.codex/skills/parallel-dev-cycle/phases/03-result-aggregation.md

@@ -148,29 +148,29 @@ Update requirements.md if needed.
 }
 ```
 
-### Step 3.6: Send Feedback via send_input
+### Step 3.6: Send Feedback via assign_task
 
 ```javascript
 const feedback = generateFeedback(parsedResults)
 
 // Send feedback to relevant agents
 if (feedback.ra) {
-  send_input({
-    id: agents.ra,
-    message: feedback.ra
+  assign_task({
+    target: agents.ra,
+    items: [{ type: "text", text: feedback.ra }]
   })
 }
 
 if (feedback.cd) {
-  send_input({
-    id: agents.cd,
-    message: feedback.cd
+  assign_task({
+    target: agents.cd,
+    items: [{ type: "text", text: feedback.cd }]
   })
 }
 
 // Wait for agents to process feedback and update
-const updatedResults = wait({
-  ids: [agents.ra, agents.cd].filter(Boolean),
+const updatedResults = wait_agent({
+  targets: [agents.ra, agents.cd].filter(Boolean),
   timeout_ms: 900000  // 15 minutes for fixes
 })
 
@@ -213,7 +213,7 @@ Phase 3: Result Aggregation
 │   ├─ No → Phase 4 (Complete)
 │   └─ Yes
 │       ├─ iteration < max?
-│       │   ├─ Yes → Generate feedback → send_input → Wait → Back to Phase 2
+│       │   ├─ Yes → Generate feedback → assign_task → Wait → Back to Phase 2
 │       │   └─ No → Phase 4 (Complete with issues)
 ```
 

package/.codex/skills/review-cycle/SKILL.md

@@ -316,18 +316,18 @@ ${deliverables}
 })
 ```
 
-### wait
+### wait_agent
 
 Get results from subagent (only way to retrieve results).
 
 ```javascript
-const result = wait({
-  ids: [agentId],
+const result = wait_agent({
+  targets: [agentId],
   timeout_ms: 600000  // 10 minutes
 })
 
 if (result.timed_out) {
-  // Handle timeout - can continue waiting or send_input to prompt completion
+  // Handle timeout - can use assign_task to prompt completion
 }
 
 // Check completion status
@@ -336,20 +336,20 @@ if (result.status[agentId].completed) {
 }
 ```
 
-### send_input
+### assign_task
 
-Continue interaction with active subagent (for clarification or follow-up).
+Assign new work to active subagent (for clarification or follow-up).
 
 ```javascript
-send_input({
-  id: agentId,
-  message: `
+assign_task({
+  target: agentId,
+  items: [{ type: "text", text: `
 ## CLARIFICATION ANSWERS
 ${answers}
 
 ## NEXT STEP
 Continue with analysis generation.
-`
+` }]
 })
 ```
 

package/.codex/skills/review-cycle/phases/02-parallel-review.md

@@ -173,8 +173,8 @@ ${getDimensionGuidance(dimension)}
 });
 
 // Step 2: Batch wait for all 7 agents
-const reviewResults = wait({
-  ids: reviewAgents,
+const reviewResults = wait_agent({
+  targets: reviewAgents,
   timeout_ms: 3600000  // 60 minutes
 });
 
@@ -296,8 +296,8 @@ ${getDimensionGuidance(dimension)}
 });
 
 // Step 2: Batch wait for all 7 agents
-const reviewResults = wait({
-  ids: reviewAgents,
+const reviewResults = wait_agent({
+  targets: reviewAgents,
   timeout_ms: 3600000  // 60 minutes
 });
 
@@ -407,8 +407,8 @@ Then apply **Deep Scan mode** for semantic analysis:
 });
 
 // Wait for completion
-const deepDiveResult = wait({
-  ids: [deepDiveAgentId],
+const deepDiveResult = wait_agent({
+  targets: [deepDiveAgentId],
   timeout_ms: 2400000  // 40 minutes
 });
 

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

@@ -163,8 +163,8 @@ Then apply **Deep Scan mode** for semantic analysis:
 });
 
 // Step 2: Batch wait for all deep-dive agents
-const deepDiveResults = wait({
-  ids: deepDiveAgents,
+const deepDiveResults = wait_agent({
+  targets: deepDiveAgents,
   timeout_ms: 2400000  // 40 minutes
 });
 
@@ -275,8 +275,8 @@ Then apply **Deep Scan mode** for semantic analysis:
 });
 
 // Step 2: Batch wait for all deep-dive agents
-const deepDiveResults = wait({
-  ids: deepDiveAgents,
+const deepDiveResults = wait_agent({
+  targets: deepDiveAgents,
   timeout_ms: 2400000  // 40 minutes
 });
 

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

@@ -43,8 +43,8 @@ for (let i = 0; i < batches.length; i += MAX_PARALLEL) {
   console.log(`Spawned ${agentIds.length} planning agents...`);
 
   // Step 2: Batch wait for all agents in this chunk
-  const chunkResults = wait({
-    ids: agentIds.map(a => a.agentId),
+  const chunkResults = wait_agent({
+    targets: agentIds.map(a => a.agentId),
     timeout_ms: 600000  // 10 minutes
   });
 
@@ -204,8 +204,8 @@ Before finalizing outputs:
 });
 
 // Wait for completion
-const result = wait({
-  ids: [agentId],
+const result = wait_agent({
+  targets: [agentId],
   timeout_ms: 600000  // 10 minutes
 });
 

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

@@ -221,8 +221,8 @@ Use fix_strategy.test_pattern to run affected tests:
 });
 
 // Wait for completion
-const execResult = wait({
-  ids: [execAgentId],
+const execResult = wait_agent({
+  targets: [execAgentId],
   timeout_ms: 1200000  // 20 minutes per group
 });
 

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

@@ -56,33 +56,33 @@ ${deliverables}
 })
 ```
 
-### wait
+### wait_agent
 Get results from subagent (only way to retrieve results).
 
 ```javascript
-const result = wait({
-  ids: [agentId],
+const result = wait_agent({
+  targets: [agentId],
   timeout_ms: 600000  // 10 minutes
 })
 
 if (result.timed_out) {
-  // Handle timeout - can continue waiting or send_input to prompt completion
+  // Handle timeout - can use assign_task to prompt completion
 }
 ```
 
-### send_input
-Continue interaction with active subagent (for clarification or follow-up).
+### assign_task
+Assign new work to active subagent (for clarification or follow-up).
 
 ```javascript
-send_input({
-  id: agentId,
-  message: `
+assign_task({
+  target: agentId,
+  items: [{ type: "text", text: `
 ## CLARIFICATION ANSWERS
 ${answers}
 
 ## NEXT STEP
 Continue with plan generation.
-`
+` }]
 })
 ```
 
@@ -537,8 +537,8 @@ Return findings as JSON with schema:
 `
      })
 
-     const exploreResult = wait({
-       ids: [exploreAgentId],
+     const exploreResult = wait_agent({
+       targets: [exploreAgentId],
        timeout_ms: 120000
      })
 
@@ -629,8 +629,8 @@ ${selectedMode === 'progressive' ? `**Progressive Mode**:
 `
    })
 
-   const decompositionResult = wait({
-     ids: [decompositionAgentId],
+   const decompositionResult = wait_agent({
+     targets: [decompositionAgentId],
      timeout_ms: 300000  // 5 minutes for complex decomposition
    })
 

package/.codex/skills/spec-generator/README.md

@@ -107,4 +107,4 @@ After Phase 6, choose execution path:
 - **Type-specialized**: Profiles adapt templates to service/api/library/platform requirements
 - **Iterative quality**: Phase 6.5 auto-fix repairs issues, max 2 iterations before handoff
 - **Terminology-first**: glossary.json ensures consistent terminology across all documents
-- **Agent-delegated**: Heavy document phases (2-5, 6.5) run in doc-generator agents to minimize main context usage
+- **Agent-delegated**: Heavy document phases (2-5, 6.5) run in doc-generator agents via `spawn_agent/wait_agent/close_agent` (Codex v4 API) to minimize main context usage