claude-code-workflow 7.2.27 → 7.2.29

package/.codex/skills/team-visual-a11y/specs/pipelines.md

@@ -0,0 +1,98 @@
+# Pipeline Definitions
+
+Visual accessibility pipeline modes and task registry.
+
+## Pipeline Modes
+
+| Mode | Description | Task Count |
+|------|-------------|------------|
+| audit-only | 3 parallel auditors -> remediation plan | 4 tasks |
+| full | 3 parallel auditors -> remediation -> fix -> 2 parallel re-auditors | 7 tasks |
+
+## Audit-Only Pipeline Task Registry
+
+| Task ID | Role | deps | Description |
+|---------|------|------|-------------|
+| COLOR-001 | color-auditor | [] | OKLCH color contrast audit: WCAG 2.1 + APCA ratios, color blindness simulation |
+| TYPO-001 | typo-auditor | [] | Typography readability: font size at breakpoints, line-height, reading width |
+| FOCUS-001 | focus-auditor | [] | Focus management: tab order, indicators, skip link, ARIA, keyboard |
+| REMED-001 | remediation-planner | [COLOR-001, TYPO-001, FOCUS-001] | Prioritized remediation plan with code-level fixes |
+
+**CRITICAL**: COLOR-001, TYPO-001, FOCUS-001 have NO deps -- they run in PARALLEL.
+
+## Full Pipeline Task Registry
+
+| Task ID | Role | deps | Description |
+|---------|------|------|-------------|
+| COLOR-001 | color-auditor | [] | OKLCH color contrast audit (initial) |
+| TYPO-001 | typo-auditor | [] | Typography readability audit |
+| FOCUS-001 | focus-auditor | [] | Focus management audit (initial) |
+| REMED-001 | remediation-planner | [COLOR-001, TYPO-001, FOCUS-001] | Prioritized remediation plan |
+| FIX-001 | fix-implementer | [REMED-001] | Implement a11y fixes from remediation plan |
+| COLOR-002 | color-auditor | [FIX-001] | Re-audit color contrast after fixes |
+| FOCUS-002 | focus-auditor | [FIX-001] | Re-audit focus management after fixes |
+
+**CRITICAL**: COLOR-002 and FOCUS-002 both blocked only by FIX-001 -- they run in PARALLEL.
+
+## Dependency Graphs
+
+### Audit-Only
+
+```
+COLOR-001 --+
+            |
+TYPO-001  --+--> REMED-001
+            |
+FOCUS-001 --+
+```
+
+### Full
+
+```
+COLOR-001 --+
+            |
+TYPO-001  --+--> REMED-001 --> FIX-001 --+--> COLOR-002
+            |                             |
+FOCUS-001 --+                             +--> FOCUS-002
+```
+
+## Fan-In Points
+
+| Point | Waiting For | Gate Task | Action |
+|-------|------------|-----------|--------|
+| Audit fan-in | COLOR-001 + TYPO-001 + FOCUS-001 (all 3) | REMED-001 | Unblock REMED-001 when all 3 complete |
+| Re-audit fan-in | COLOR-002 + FOCUS-002 (both) | Pipeline complete | Check GC convergence |
+
+## GC Loop Behavior (Full Mode)
+
+After re-audit fan-in (COLOR-002 + FOCUS-002 both complete):
+
+| Signal | Condition | Action |
+|--------|-----------|--------|
+| All pass | 0 critical + 0 high issues remaining | GC converged -> pipeline complete |
+| Issues remain | Critical or high issues found | gc_rounds < 2 -> create FIX-002 + re-audit tasks |
+| Max rounds | gc_rounds >= 2 | Escalate to user: accept / try one more / terminate |
+
+## Parallel Spawn Rules
+
+| Mode | Scenario | Spawn Behavior |
+|------|----------|---------------|
+| audit-only | Initial | Spawn COLOR-001 + TYPO-001 + FOCUS-001 in parallel |
+| audit-only | After 3 audits | Spawn REMED-001 |
+| full | Initial | Spawn COLOR-001 + TYPO-001 + FOCUS-001 in parallel |
+| full | After 3 audits | Spawn REMED-001 |
+| full | After REMED-001 | Spawn FIX-001 |
+| full | After FIX-001 | Spawn COLOR-002 + FOCUS-002 in parallel |
+| full (GC) | After re-audit fan-in | If issues: spawn FIX-002, then new re-audits |
+
+## Output Artifacts
+
+| Task | Output Path |
+|------|-------------|
+| COLOR-001 | <session>/audits/color/color-audit-001.md |
+| TYPO-001 | <session>/audits/typography/typo-audit-001.md |
+| FOCUS-001 | <session>/audits/focus/focus-audit-001.md |
+| REMED-001 | <session>/remediation/remediation-plan.md |
+| FIX-001 | Modified source files + <session>/fixes/fix-summary-001.md |
+| COLOR-002 | <session>/re-audit/color-audit-002.md |
+| FOCUS-002 | <session>/re-audit/focus-audit-002.md |

package/.codex/skills/team-visual-a11y/specs/team-config.json

@@ -0,0 +1,109 @@
+{
+  "team_name": "visual-a11y",
+  "team_display_name": "Visual Accessibility",
+  "description": "Visual accessibility QA team with parallel auditors, remediation planning, and fix implementation with re-audit verification",
+  "version": "1.0.0",
+
+  "roles": {
+    "coordinator": {
+      "task_prefix": null,
+      "responsibility": "Scope assessment (page/component/full site), pipeline orchestration, parallel fan-in coordination",
+      "message_types": ["task_unblocked", "fan_in_complete", "gc_check", "error", "shutdown"]
+    },
+    "color-auditor": {
+      "task_prefix": "COLOR",
+      "responsibility": "OKLCH lightness/chroma analysis, contrast ratio (WCAG 2.1 + APCA), color blindness simulation",
+      "message_types": ["audit_complete", "audit_progress", "error"]
+    },
+    "typo-auditor": {
+      "task_prefix": "TYPO",
+      "responsibility": "Typography readability: font size at breakpoints, line-height ratios, clamp() validation, reading width",
+      "message_types": ["audit_complete", "audit_progress", "error"]
+    },
+    "focus-auditor": {
+      "task_prefix": "FOCUS",
+      "responsibility": "Focus-visible completeness: tab-order, focus indicator visibility, skip-link, focus traps, ARIA live regions",
+      "message_types": ["audit_complete", "audit_progress", "error"]
+    },
+    "remediation-planner": {
+      "task_prefix": "REMED",
+      "responsibility": "Synthesize audit findings into prioritized remediation plan with code-level fix guidance",
+      "message_types": ["plan_ready", "plan_progress", "error"]
+    },
+    "fix-implementer": {
+      "task_prefix": "FIX",
+      "inner_loop": true,
+      "responsibility": "Implement a11y fixes: OKLCH color corrections, focus styles, ARIA attributes, reduced-motion queries",
+      "message_types": ["fix_complete", "fix_progress", "error"]
+    }
+  },
+
+  "pipelines": {
+    "audit-only": {
+      "description": "3 parallel auditors -> remediation plan",
+      "task_chain": [
+        "COLOR-001 || TYPO-001 || FOCUS-001",
+        "REMED-001"
+      ],
+      "fan_in_points": ["REMED-001"],
+      "complexity": "medium"
+    },
+    "full": {
+      "description": "3 parallel auditors -> remediation -> fix -> 2 parallel re-auditors",
+      "task_chain": [
+        "COLOR-001 || TYPO-001 || FOCUS-001",
+        "REMED-001",
+        "FIX-001",
+        "COLOR-002 || FOCUS-002"
+      ],
+      "fan_in_points": ["REMED-001"],
+      "gc_points": ["COLOR-002", "FOCUS-002"],
+      "complexity": "high"
+    }
+  },
+
+  "innovation_patterns": {
+    "parallel_fan_in": {
+      "pattern": "CP-3",
+      "description": "3 auditors run simultaneously, remediation waits for all 3",
+      "fan_in_count": 3,
+      "fan_in_roles": ["color-auditor", "typo-auditor", "focus-auditor"],
+      "gate_task": "REMED-001"
+    },
+    "generator_critic": {
+      "pattern": "CP-2",
+      "generator": "fix-implementer",
+      "critic": ["color-auditor", "focus-auditor"],
+      "max_rounds": 2,
+      "convergence": "re-audit finds 0 critical and 0 high issues",
+      "escalation": "Coordinator intervenes after max rounds"
+    },
+    "shared_memory": {
+      "file": ".msg/meta.json",
+      "fields": {
+        "color-auditor": ["total_combinations", "pass_count", "fail_count", "critical_count"],
+        "typo-auditor": ["total_rules", "pass_count", "fail_count", "breakpoints_tested"],
+        "focus-auditor": ["total_elements", "pass_count", "fail_count", "skip_link_present"],
+        "remediation-planner": ["total_issues", "critical", "high", "medium", "low"],
+        "fix-implementer": ["total_fixes", "critical_fixed", "high_fixed", "files_modified"]
+      }
+    },
+    "chrome_devtools": {
+      "description": "Chrome DevTools integration for rendered verification",
+      "tools": ["evaluate_script", "take_screenshot", "navigate_page", "resize_page", "emulate", "lighthouse_audit"],
+      "degradation": "If unavailable, degrade to static analysis only"
+    }
+  },
+
+  "session_dirs": {
+    "base": ".workflow/.team/VA-{slug}-{YYYY-MM-DD}/",
+    "color_audit": "audits/color/",
+    "typo_audit": "audits/typography/",
+    "focus_audit": "audits/focus/",
+    "remediation": "remediation/",
+    "fixes": "fixes/",
+    "re_audit": "re-audit/",
+    "evidence": "evidence/",
+    "messages": ".workflow/.team-msg/{team-name}/"
+  }
+}

package/.codex/skills/team-visual-a11y/specs/typography-scale.md

@@ -0,0 +1,165 @@
+# Typography Accessibility Standards
+
+Reference guide for typography readability analysis. Used by typo-auditor and fix-implementer roles.
+
+## Font Stack Hierarchy
+
+| Purpose | Category | Example | Usage |
+|---------|----------|---------|-------|
+| Display | Serif | Cormorant Garamond, Georgia, serif | Headings, hero text |
+| Body | Sans-serif | Instrument Sans, Inter, system-ui, sans-serif | Paragraphs, UI text |
+| Mono | Monospace | Space Grotesk, Fira Code, monospace | Code blocks, labels |
+
+### System Font Stack (Fallback)
+
+```css
+--font-body: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+--font-mono: ui-monospace, "Cascadia Code", "Fira Code", Menlo, monospace;
+```
+
+## Responsive Size Scale
+
+### clamp() Formula Pattern
+
+```css
+/* clamp(minimum, preferred, maximum) */
+/* preferred = slope * 100vw + intercept */
+/* slope = (max - min) / (max-viewport - min-viewport) */
+```
+
+### Recommended Scale
+
+| Element | clamp() Value | Min (320px) | Max (1400px) | WCAG |
+|---------|--------------|-------------|-------------|------|
+| Hero | `clamp(2.5rem, 7vw, 4.5rem)` | 40px | 72px | -- |
+| Section title | `clamp(1.75rem, 4vw, 2.5rem)` | 28px | 40px | -- |
+| H1 | `clamp(2rem, 5vw, 3rem)` | 32px | 48px | -- |
+| H2 | `clamp(1.5rem, 3vw, 2.25rem)` | 24px | 36px | -- |
+| H3 | `clamp(1.25rem, 2vw, 1.75rem)` | 20px | 28px | -- |
+| Body | `clamp(1rem, 1vw + 0.875rem, 1.25rem)` | 16px | 20px | 1.4.4 |
+| Small/caption | 14px (fixed floor) | 14px | 14px | 1.4.4 |
+
+### Absolute Minimums
+
+| Element | Minimum | Rationale |
+|---------|---------|-----------|
+| Body text | 16px | WCAG 1.4.4 baseline readability |
+| Small text / caption | 14px | Absolute floor for legibility |
+| Interactive labels | 14px | Touch/click target readability |
+
+**Never**: Set body text below 14px at any viewport width.
+
+## Line Height Scale
+
+| Element Type | Range | Optimal | Rationale |
+|-------------|-------|---------|-----------|
+| Body text | 1.5 - 1.75 | 1.625 | WCAG 1.4.12, optimal readability |
+| Headings | 1.1 - 1.3 | 1.2 | Tight for visual impact, still readable |
+| Code blocks | 1.5 - 1.7 | 1.6 | Generous for scanning |
+| Buttons/labels | 1.2 - 1.5 | 1.3 | Compact UI element |
+| Lists | 1.4 - 1.6 | 1.5 | Slightly tighter than body |
+
+### Line Height Rules
+
+- Use unitless values (not px or em) for proper inheritance
+- `line-height: 1.5` (unitless) is preferred over `line-height: 24px` (fixed)
+- WCAG 1.4.12 requires text to remain readable at 1.5x font-size line-height
+
+## Letter Spacing Scale
+
+| Element Type | Range | Optimal | Notes |
+|-------------|-------|---------|-------|
+| Display headings | -0.02em to 0 | -0.015em | Tight for visual weight |
+| Body text | 0 (default) | 0 | Browser default is optimal |
+| Uppercase labels | 0.05em - 0.1em | 0.08em | Open for legibility |
+| Monospace code | 0.08em - 0.15em | 0.1em | Wide for character distinction |
+| Small caps | 0.05em - 0.08em | 0.06em | Slight opening |
+
+### WCAG 1.4.12 Override Requirements
+
+Content must remain readable when user applies:
+- Letter spacing: 0.12em
+- Word spacing: 0.16em
+- These overrides should not cause content overflow or overlap
+
+## Reading Width
+
+| Metric | Optimal | Acceptable | Flag |
+|--------|---------|-----------|------|
+| Characters per line | 66ch | 45-75ch | < 45 (too narrow) or > 75 (too wide) |
+| Container max-width | 65ch | 60ch-75ch | > 80ch |
+| Content column width | Up to 900px | Up to 1000px | > 1000px without columns |
+
+### Implementation
+
+```css
+/* Preferred: ch-based */
+.content { max-width: 70ch; }
+
+/* Alternative: px-based */
+.content { max-width: 700px; }
+
+/* With centering */
+.content {
+  max-width: 70ch;
+  margin-inline: auto;
+  padding-inline: 1rem;
+}
+```
+
+## Font Loading Strategy
+
+### font-display Values
+
+| Value | Behavior | Recommended For |
+|-------|----------|----------------|
+| `swap` | Show fallback immediately, swap when loaded | Body text |
+| `optional` | Show fallback, swap only if already cached | Display/decorative fonts |
+| `fallback` | Brief invisible period (~100ms), then fallback | Important fonts |
+| `block` | Invisible text up to 3s | Avoid for body text |
+| `auto` | Browser decides | Avoid (unpredictable) |
+
+### Best Practices
+
+```css
+/* Body font: swap for immediate readability */
+@font-face {
+  font-family: "Body Font";
+  src: url("body.woff2") format("woff2");
+  font-display: swap;
+}
+
+/* Display font: optional to prevent layout shift */
+@font-face {
+  font-family: "Display Font";
+  src: url("display.woff2") format("woff2");
+  font-display: optional;
+}
+```
+
+### Preloading Critical Fonts
+
+```html
+<link rel="preload" href="/fonts/body.woff2" as="font" type="font/woff2" crossorigin>
+```
+
+### Fallback Stack Requirements
+
+- Every custom font must have a system fallback
+- Fallback should have similar metrics (x-height, width) to minimize layout shift
+- Use `size-adjust`, `ascent-override`, `descent-override` for metric matching
+
+## Responsive Typography Checklist
+
+| # | Check | Standard | Method |
+|---|-------|----------|--------|
+| 1 | Body text >= 16px at 320px | WCAG 1.4.4 | Computed style at mobile viewport |
+| 2 | No text below 14px at any viewport | Best practice | Search for font-size values |
+| 3 | clamp() min >= 14px | Best practice | Parse clamp() functions |
+| 4 | Line-height unitless | Best practice | Search for px/em line-height |
+| 5 | Body line-height 1.5-1.75 | WCAG 1.4.12 | Computed style check |
+| 6 | Reading width 45-75ch | Best practice | Measure container + font size |
+| 7 | font-display: swap on body | Best practice | Parse @font-face rules |
+| 8 | System fallback defined | Best practice | Parse font-family stacks |
+| 9 | 200% zoom no overflow | WCAG 1.4.4 | Zoom test |
+| 10 | Text spacing override safe | WCAG 1.4.12 | Apply overrides, check layout |

package/.codex/skills/team-visual-a11y/specs/wcag-matrix.md

@@ -0,0 +1,133 @@
+# WCAG 2.1 Criteria Matrix
+
+Reference matrix for visual accessibility audit. Maps WCAG success criteria to audit methods and responsible roles.
+
+## Criteria Covered by This Team
+
+| Criterion | Level | Automated | Manual | Check Method | Primary Role |
+|-----------|-------|-----------|--------|-------------|-------------|
+| 1.4.3 Contrast (Minimum) | AA | Yes | - | Color ratio calculation (4.5:1 normal, 3:1 large) | color-auditor |
+| 1.4.6 Contrast (Enhanced) | AAA | Yes | - | Color ratio calculation (7:1 normal, 4.5:1 large) | color-auditor |
+| 1.4.11 Non-text Contrast | AA | Partial | Yes | UI component border/fill contrast >= 3:1 | color-auditor |
+| 1.4.4 Resize Text | AA | Yes | - | 200% zoom, no content loss | typo-auditor |
+| 1.4.12 Text Spacing | AA | Partial | Yes | Override line-height 1.5x, letter-spacing 0.12em, word-spacing 0.16em | typo-auditor |
+| 2.1.1 Keyboard | A | Partial | Yes | Tab through all interactive elements | focus-auditor |
+| 2.1.2 No Keyboard Trap | A | - | Yes | Tab can escape all contexts (except intentional traps with Escape) | focus-auditor |
+| 2.4.1 Bypass Blocks | A | Yes | - | Skip link present and functional | focus-auditor |
+| 2.4.3 Focus Order | A | - | Yes | Logical tab sequence | focus-auditor |
+| 2.4.7 Focus Visible | AA | Partial | Yes | Visible focus indicator on all interactive elements | focus-auditor |
+| 2.4.11 Focus Not Obscured (Min) | AA | - | Yes | Focus indicator not hidden by overlays, sticky headers | focus-auditor |
+| 2.5.8 Target Size (Minimum) | AA | Yes | - | Minimum 24x24px CSS pixel touch targets | focus-auditor |
+| 4.1.2 Name, Role, Value | A | Yes | - | ARIA roles, labels, and states on interactive elements | focus-auditor |
+| 4.1.3 Status Messages | AA | Partial | Yes | aria-live regions for dynamic status updates | focus-auditor |
+
+## Audit Method Legend
+
+| Method | Description |
+|--------|-------------|
+| Automated | Can be verified programmatically (CSS parsing, contrast calculation) |
+| Manual | Requires human judgment or runtime interaction |
+| Partial | Automated detection of presence, manual verification of correctness |
+
+## Criterion Details
+
+### 1.4.3 Contrast (Minimum) - AA
+
+**Requirement**: Text and images of text have a contrast ratio of at least 4.5:1 (3:1 for large text).
+
+**Large text definition**: >= 18pt (24px) or >= 14pt bold (18.66px bold).
+
+**Exceptions**: Decorative text, logos, inactive UI components.
+
+**Check**: Extract foreground/background colors -> calculate contrast ratio -> compare against threshold.
+
+### 1.4.6 Contrast (Enhanced) - AAA
+
+**Requirement**: Text has contrast ratio of at least 7:1 (4.5:1 for large text).
+
+**Check**: Same as 1.4.3 but with higher thresholds.
+
+### 1.4.11 Non-text Contrast - AA
+
+**Requirement**: UI components and graphical objects have at least 3:1 contrast against adjacent colors.
+
+**Applies to**: Buttons, inputs, icons, focus indicators, charts, custom controls.
+
+**Check**: Extract border/fill colors of UI components -> calculate contrast against background.
+
+### 1.4.4 Resize Text - AA
+
+**Requirement**: Text can be resized up to 200% without loss of content or functionality.
+
+**Check**: Zoom to 200% -> verify no horizontal scrolling, no content clipping, no overlap.
+
+### 1.4.12 Text Spacing - AA
+
+**Requirement**: Content must remain readable when user overrides:
+- Line height to 1.5x font size
+- Paragraph spacing to 2x font size
+- Letter spacing to 0.12x font size
+- Word spacing to 0.16x font size
+
+**Check**: Apply overrides via JavaScript/CSS -> verify no content loss or overlap.
+
+### 2.1.1 Keyboard - A
+
+**Requirement**: All functionality available via keyboard (Enter, Space, Tab, Arrow keys, Escape).
+
+**Check**: Tab to every interactive element -> activate with Enter/Space -> navigate composites with Arrows.
+
+### 2.1.2 No Keyboard Trap - A
+
+**Requirement**: Keyboard focus can be moved away from any component using standard keys.
+
+**Exception**: Modal dialogs that trap focus intentionally (must have Escape to exit).
+
+**Check**: Tab forward and backward through all elements -> verify escape from all containers.
+
+### 2.4.1 Bypass Blocks - A
+
+**Requirement**: Mechanism to bypass repeated content blocks (skip links, landmarks, headings).
+
+**Check**: Verify skip link as first focusable element, target exists, focus moves correctly.
+
+### 2.4.3 Focus Order - A
+
+**Requirement**: Focus order preserves meaning and operability (logical sequence).
+
+**Check**: Tab through page -> verify order matches visual/reading order.
+
+### 2.4.7 Focus Visible - AA
+
+**Requirement**: Keyboard focus indicator is visible on all interactive elements.
+
+**Check**: Tab to each element -> verify visible outline/border/shadow change.
+
+### 2.4.11 Focus Not Obscured (Minimum) - AA
+
+**Requirement**: Focused element is not entirely hidden by other content (sticky headers, overlays, banners).
+
+**Check**: Tab through elements near sticky/fixed positioned elements -> verify focus indicator partially visible.
+
+### 2.5.8 Target Size (Minimum) - AA
+
+**Requirement**: Interactive targets are at least 24x24 CSS pixels, or have adequate spacing.
+
+**Exceptions**: Inline links within text, user agent default controls, essential presentation.
+
+**Check**: Measure interactive element dimensions -> verify >= 24x24px or adequate spacing.
+
+### 4.1.2 Name, Role, Value - A
+
+**Requirement**: All UI components have accessible name, role, and state programmatically determined.
+
+**Check**: Verify interactive elements have:
+- Accessible name (text content, aria-label, aria-labelledby)
+- Appropriate role (native HTML or ARIA role)
+- Current state (aria-expanded, aria-pressed, aria-selected, aria-checked)
+
+### 4.1.3 Status Messages - AA
+
+**Requirement**: Status messages can be programmatically determined through role or properties without receiving focus.
+
+**Check**: Verify dynamic content updates use `aria-live` or appropriate roles (`status`, `alert`, `log`).

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

@@ -6,7 +6,7 @@ description: |
   (spawn_agent or N+1 parallel agents) → plan verification → interactive replan.
   Produces IMPL_PLAN.md, task JSONs, TODO_LIST.md.
 argument-hint: "[-y|--yes] [--session ID] \"task description\" | verify [--session ID] | replan [--session ID] [IMPL-N] \"changes\""
-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
 ---
 
 ## Auto Mode
@@ -271,7 +271,7 @@ Format: {
 `
 })
 
-wait({ id: ctxAgent })
+wait_agent({ targets: [ctxAgent] })
 close_agent({ id: ctxAgent })
 
 // Parse outputs
@@ -403,7 +403,7 @@ ${contextPkg.conflict_risk === 'medium' || contextPkg.conflict_risk === 'high'
 `
      })
 
-     wait({ id: planAgent })
+     wait_agent({ targets: [planAgent] })
      close_agent({ id: planAgent })
    }
    ```
@@ -439,7 +439,7 @@ Mark cross-module dependencies as CROSS::${'{module}'}::${'{task}'}
      }
 
      // Wait for all module planners
-     wait({ ids: moduleAgents.map(a => a.id) })
+     wait_agent({ targets: moduleAgents.map(a => a.id) })
      moduleAgents.forEach(a => close_agent({ id: a.id }))
 
      // +1 Coordinator: integrate all modules
@@ -460,7 +460,7 @@ Integrate ${uniqueModules.length} module plans into unified IMPL_PLAN.md.
 `
      })
 
-     wait({ id: coordAgent })
+     wait_agent({ targets: [coordAgent] })
      close_agent({ id: coordAgent })
    }
    ```
@@ -601,7 +601,7 @@ ${replanTaskId ? `**Target Task**: ${sessionFolder}/.task/${replanTaskId}.json`
 `
   })
 
-  wait({ id: replanAgent })
+  wait_agent({ targets: [replanAgent] })
   close_agent({ id: replanAgent })
 
   console.log(`  Replan complete. Review: ${sessionFolder}/IMPL_PLAN.md`)

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

@@ -7,7 +7,7 @@ description: |
   interactive verification. Produces IMPL_PLAN.md with Red-Green-Refactor cycles,
   task JSONs, TODO_LIST.md.
 argument-hint: "[-y|--yes] [--session ID] \"task description\" | verify [--session ID]"
-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
 ---
 
 ## Auto Mode
@@ -298,7 +298,7 @@ Format: {
 `
 })
 
-wait({ id: ctxAgent })
+wait_agent({ targets: [ctxAgent] })
 close_agent({ id: ctxAgent })
 
 // Parse outputs
@@ -367,7 +367,7 @@ Format: {
 `
 })
 
-wait({ id: testAgent })
+wait_agent({ targets: [testAgent] })
 close_agent({ id: testAgent })
 
 const testContext = JSON.parse(Read(`${sessionFolder}/.process/test-context-package.json`) || '{}')
@@ -500,7 +500,7 @@ Each task MUST include Red-Green-Refactor cycle:
 `
 })
 
-wait({ id: planAgent })
+wait_agent({ targets: [planAgent] })
 close_agent({ id: planAgent })
 
 console.log(`  TDD tasks generated`)
@@ -690,7 +690,7 @@ BLOCKED: Critical failures, must fix before execution
 `
   })
 
-  wait({ id: verifyAgent })
+  wait_agent({ targets: [verifyAgent] })
   close_agent({ id: verifyAgent })
 
   const report = Read(`${sessionFolder}/.process/TDD_COMPLIANCE_REPORT.md`)