claude-code-workflow 7.2.23 → 7.2.24

package/.codex/skills/team-ux-improve/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: team-ux-improve
 description: Unified team skill for UX improvement. Systematically discovers and fixes UI/UX interaction issues including unresponsive buttons, missing feedback, and state refresh problems. Uses team-worker agent architecture with roles/ for domain logic. Coordinator orchestrates pipeline, workers are team-worker agents. Triggers on "team ux improve".
-allowed-tools: spawn_agent(*), wait_agent(*), send_input(*), close_agent(*), report_agent_job_result(*), request_user_input(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*), mcp__ace-tool__search_context(*), mcp__ccw-tools__read_file(*), mcp__ccw-tools__write_file(*), mcp__ccw-tools__edit_file(*), mcp__ccw-tools__team_msg(*)
+allowed-tools: spawn_agent(*), wait_agent(*), send_message(*), assign_task(*), close_agent(*), list_agents(*), report_agent_job_result(*), request_user_input(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*), mcp__ace-tool__search_context(*), mcp__ccw-tools__read_file(*), mcp__ccw-tools__write_file(*), mcp__ccw-tools__edit_file(*), mcp__ccw-tools__team_msg(*)
 ---
 
 # Team UX Improve
@@ -63,7 +63,8 @@ Before calling ANY tool, apply this check:
 
 | Tool Call | Verdict | Reason |
 |-----------|---------|--------|
-| `spawn_agent`, `wait_agent`, `close_agent`, `send_input` | ALLOWED | Orchestration |
+| `spawn_agent`, `wait_agent`, `close_agent`, `send_message`, `assign_task` | ALLOWED | Orchestration |
+| `list_agents` | ALLOWED | Agent health check |
 | `request_user_input` | ALLOWED | User interaction |
 | `mcp__ccw-tools__team_msg` | ALLOWED | Message bus |
 | `Read/Write` on `.workflow/.team/` files | ALLOWED | Session state |
@@ -94,6 +95,8 @@ Coordinator spawns workers using this template:
 ```
 spawn_agent({
   agent_type: "team_worker",
+  task_name: "<task-id>",
+  fork_context: false,
   items: [
     { type: "text", text: `## Role Assignment
 role: <role>
@@ -117,7 +120,21 @@ pipeline_phase: <pipeline-phase>` },
 })
 ```
 
-After spawning, use `wait_agent({ ids: [...], timeout_ms: 900000 })` to collect results, then `close_agent({ id })` each worker.
+After spawning, use `wait_agent({ targets: [...], timeout_ms: 900000 })` to collect results, then `close_agent({ target })` each worker.
+
+
+### Model Selection Guide
+
+UX improvement has an explorer utility member and a scan-diagnose-design-implement-test pipeline.
+
+| Role | reasoning_effort | Rationale |
+|------|-------------------|-----------|
+| explorer | low | File reading and pattern summarization only (utility member) |
+| scanner | medium | Broad UI/UX issue scanning, pattern-based detection |
+| diagnoser | high | Root cause diagnosis of UX issues requires deep analysis |
+| designer | high | UX improvement design needs careful user experience reasoning |
+| implementer | high | UI code changes must preserve existing behavior |
+| tester | medium | Test execution follows defined UX verification criteria |
 
 ## User Commands
 
@@ -152,6 +169,50 @@ After spawning, use `wait_agent({ ids: [...], timeout_ms: 900000 })` to collect
     └── anti-patterns/
 ```
 
+## v4 Agent Coordination
+
+### Message Semantics
+
+| Intent | API | Example |
+|--------|-----|---------|
+| Queue supplementary info (don't interrupt) | `send_message` | Send explorer findings to running scanner |
+| Assign implementation from design | `assign_task` | Assign IMPL task from designer output |
+| Check running agents | `list_agents` | Verify agent health during resume |
+
+### Agent Health Check
+
+Use `list_agents({})` in handleResume and handleComplete:
+
+```
+// Reconcile session state with actual running agents
+const running = list_agents({})
+// Compare with meta.json active tasks
+// Reset orphaned tasks (in_progress but agent gone) to pending
+```
+
+### Named Agent Targeting
+
+Workers are spawned with `task_name: "<task-id>"` enabling direct addressing:
+- `send_message({ target: "SCAN-001", items: [...] })` -- send explorer findings to scanner
+- `assign_task({ target: "IMPL-001", items: [...] })` -- assign UX fix from designer output
+- `close_agent({ target: "TEST-001" })` -- cleanup after UX testing
+
+### Explorer-Assisted Scanning
+
+Coordinator spawns explorer (utility member) early to gather codebase context, then sends findings to scanner via upstream context:
+```
+// Explorer results inform scanner's scope
+send_message({
+  target: "SCAN-001",
+  items: [
+    { type: "text", text: `## Explorer Findings
+component_patterns: <explorer's component inventory>
+framework: <detected framework>
+ui_library: <detected UI library>` }
+  ]
+})
+```
+
 ## Error Handling
 
 | Scenario | Resolution |

package/.codex/skills/team-ux-improve/roles/coordinator/commands/analyze.md

@@ -1,62 +1,62 @@
-# Analyze Task
-
-Parse user task -> detect UX improvement scope -> assess complexity -> determine pipeline configuration.
-
-**CONSTRAINT**: Text-level analysis only. NO source code reading, NO codebase exploration.
-
-## Signal Detection
-
-| Keywords | Signal | Pipeline Hint |
-|----------|--------|---------------|
-| button, click, tap, unresponsive | interaction-issues | standard |
-| loading, spinner, feedback, progress | feedback-missing | standard |
-| state, refresh, update, stale | state-issues | standard |
-| form, input, validation, error | input-issues | standard |
-| accessibility, a11y, keyboard, screen reader | accessibility | standard |
-| performance, slow, lag, freeze | performance | standard |
-| all, full, complete, comprehensive | full-scope | standard |
-
-## Framework Detection
-
-| Keywords | Framework |
-|----------|-----------|
-| react, jsx, tsx, useState, useEffect | React |
-| vue, .vue, ref(), reactive(), v-model | Vue |
-| angular, ng-, @Component | Angular |
-| Default | auto-detect |
-
-## Complexity Scoring
-
-| Factor | Points |
-|--------|--------|
-| Single component scope | +1 |
-| Multiple components | +2 |
-| Full project scope | +3 |
-| Accessibility required | +1 |
-| Performance issues | +1 |
-| Complex state management | +1 |
-
-Results: 1-2 Low (targeted fix), 3-4 Medium (standard pipeline), 5+ High (full pipeline)
-
-## Scope Determination
-
-| Signal | Pipeline Mode |
-|--------|---------------|
-| Specific component or file mentioned | targeted |
-| Multiple issues or general project | standard |
-| "Full audit" or "complete scan" | standard |
-| Unclear | ask user |
-
-## Output
-
-Write scope context to coordinator memory:
-```json
-{
-  "pipeline_mode": "standard",
-  "project_path": "<detected-or-provided-path>",
-  "framework": "<react|vue|angular|auto>",
-  "scope": "<detected-scope>",
-  "issue_signals": ["interaction", "feedback", "state"],
-  "complexity": { "score": 0, "level": "Low|Medium|High" }
-}
-```
+# Analyze Task
+
+Parse user task -> detect UX improvement scope -> assess complexity -> determine pipeline configuration.
+
+**CONSTRAINT**: Text-level analysis only. NO source code reading, NO codebase exploration.
+
+## Signal Detection
+
+| Keywords | Signal | Pipeline Hint |
+|----------|--------|---------------|
+| button, click, tap, unresponsive | interaction-issues | standard |
+| loading, spinner, feedback, progress | feedback-missing | standard |
+| state, refresh, update, stale | state-issues | standard |
+| form, input, validation, error | input-issues | standard |
+| accessibility, a11y, keyboard, screen reader | accessibility | standard |
+| performance, slow, lag, freeze | performance | standard |
+| all, full, complete, comprehensive | full-scope | standard |
+
+## Framework Detection
+
+| Keywords | Framework |
+|----------|-----------|
+| react, jsx, tsx, useState, useEffect | React |
+| vue, .vue, ref(), reactive(), v-model | Vue |
+| angular, ng-, @Component | Angular |
+| Default | auto-detect |
+
+## Complexity Scoring
+
+| Factor | Points |
+|--------|--------|
+| Single component scope | +1 |
+| Multiple components | +2 |
+| Full project scope | +3 |
+| Accessibility required | +1 |
+| Performance issues | +1 |
+| Complex state management | +1 |
+
+Results: 1-2 Low (targeted fix), 3-4 Medium (standard pipeline), 5+ High (full pipeline)
+
+## Scope Determination
+
+| Signal | Pipeline Mode |
+|--------|---------------|
+| Specific component or file mentioned | targeted |
+| Multiple issues or general project | standard |
+| "Full audit" or "complete scan" | standard |
+| Unclear | ask user |
+
+## Output
+
+Write scope context to coordinator memory:
+```json
+{
+  "pipeline_mode": "standard",
+  "project_path": "<detected-or-provided-path>",
+  "framework": "<react|vue|angular|auto>",
+  "scope": "<detected-scope>",
+  "issue_signals": ["interaction", "feedback", "state"],
+  "complexity": { "score": 0, "level": "Low|Medium|High" }
+}
+```