claude-code-workflow 7.2.3 → 7.2.4

package/.claude/skills/team-testing/roles/coordinator/commands/dispatch.md

@@ -31,7 +31,7 @@ EXPECTED: <deliverable path> + <quality criteria>
 CONSTRAINTS: <scope limits, focus areas>
 ---
 InnerLoop: <true|false>
-RoleSpec: .claude/skills/team-testing/roles/<role>/role.md
+RoleSpec: ~  or <project>/.claude/skills/team-testing/roles/<role>/role.md
 ```
 
 ## Pipeline Task Registry

package/.claude/skills/team-testing/roles/coordinator/commands/monitor.md

@@ -25,10 +25,10 @@ Event-driven pipeline coordination. Beat model: coordinator wake -> process -> s
 
 | Prefix | Role | Role Spec | inner_loop |
 |--------|------|-----------|------------|
-| STRATEGY-* | strategist | `.claude/skills/team-testing/roles/strategist/role.md` | false |
-| TESTGEN-* | generator | `.claude/skills/team-testing/roles/generator/role.md` | true |
-| TESTRUN-* | executor | `.claude/skills/team-testing/roles/executor/role.md` | true |
-| TESTANA-* | analyst | `.claude/skills/team-testing/roles/analyst/role.md` | false |
+| STRATEGY-* | strategist | `~  or <project>/.claude/skills/team-testing/roles/strategist/role.md` | false |
+| TESTGEN-* | generator | `~  or <project>/.claude/skills/team-testing/roles/generator/role.md` | true |
+| TESTRUN-* | executor | `~  or <project>/.claude/skills/team-testing/roles/executor/role.md` | true |
+| TESTANA-* | analyst | `~  or <project>/.claude/skills/team-testing/roles/analyst/role.md` | false |
 
 ## handleCallback
 
@@ -68,7 +68,7 @@ EXPECTED: Revised test files in <session>/tests/<layer>/
 CONSTRAINTS: Only modify test files
 ---
 InnerLoop: true
-RoleSpec: .claude/skills/team-testing/roles/generator/role.md"
+RoleSpec: ~  or <project>/.claude/skills/team-testing/roles/generator/role.md"
 })
 TaskCreate({
   subject: "TESTRUN-<layer>-fix-<round>: Re-execute <layer> (GC #<round>)",
@@ -80,7 +80,7 @@ CONTEXT:
 EXPECTED: <session>/results/run-<N>-gc.json
 ---
 InnerLoop: true
-RoleSpec: .claude/skills/team-testing/roles/executor/role.md",
+RoleSpec: ~  or <project>/.claude/skills/team-testing/roles/executor/role.md",
   blockedBy: ["TESTGEN-<layer>-fix-<round>"]
 })
 ```
@@ -150,7 +150,7 @@ Agent({
   run_in_background: true,
   prompt: `## Role Assignment
 role: <role>
-role_spec: .claude/skills/team-testing/roles/<role>/role.md
+role_spec: ~  or <project>/.claude/skills/team-testing/roles/<role>/role.md
 session: <session-folder>
 session_id: <session-id>
 team_name: testing

package/.claude/skills/team-uidesign/SKILL.md

@@ -67,7 +67,7 @@ Agent({
   run_in_background: true,
   prompt: `## Role Assignment
 role: <role>
-role_spec: .claude/skills/team-uidesign/roles/<role>/role.md
+role_spec: ~  or <project>/.claude/skills/team-uidesign/roles/<role>/role.md
 session: <session-folder>
 session_id: <session-id>
 team_name: uidesign

package/.claude/skills/team-uidesign/roles/coordinator/commands/monitor.md

@@ -127,7 +127,7 @@ Agent({
   run_in_background: true,
   prompt: `## Role Assignment
 role: <role>
-role_spec: .claude/skills/team-uidesign/roles/<role>/role.md
+role_spec: ~  or <project>/.claude/skills/team-uidesign/roles/<role>/role.md
 session: <session-folder>
 session_id: <session-id>
 team_name: uidesign

package/.claude/skills/team-ultra-analyze/SKILL.md

@@ -75,7 +75,7 @@ Agent({
   run_in_background: true,
   prompt: `## Role Assignment
 role: <role>
-role_spec: .claude/skills/team-ultra-analyze/roles/<role>/role.md
+role_spec: ~  or <project>/.claude/skills/team-ultra-analyze/roles/<role>/role.md
 session: <session-folder>
 session_id: <session-id>
 team_name: ultra-analyze

package/.claude/skills/team-ultra-analyze/roles/coordinator/commands/monitor.md

@@ -211,10 +211,10 @@ Find and spawn the next ready tasks.
 
 | Task Prefix | Role | Role Spec |
 |-------------|------|-----------|
-| `EXPLORE-*` | explorer | `.claude/skills/team-ultra-analyze/role-specs/explorer.md` |
-| `ANALYZE-*` | analyst | `.claude/skills/team-ultra-analyze/role-specs/analyst.md` |
-| `DISCUSS-*` | discussant | `.claude/skills/team-ultra-analyze/role-specs/discussant.md` |
-| `SYNTH-*` | synthesizer | `.claude/skills/team-ultra-analyze/role-specs/synthesizer.md` |
+| `EXPLORE-*` | explorer | `~  or <project>/.claude/skills/team-ultra-analyze/role-specs/explorer.md` |
+| `ANALYZE-*` | analyst | `~  or <project>/.claude/skills/team-ultra-analyze/role-specs/analyst.md` |
+| `DISCUSS-*` | discussant | `~  or <project>/.claude/skills/team-ultra-analyze/role-specs/discussant.md` |
+| `SYNTH-*` | synthesizer | `~  or <project>/.claude/skills/team-ultra-analyze/role-specs/synthesizer.md` |
 
 3. Spawn team-worker for each ready task:
 
@@ -227,7 +227,7 @@ Agent({
   run_in_background: true,
   prompt: `## Role Assignment
 role: <role>
-role_spec: .claude/skills/team-ultra-analyze/role-specs/<role>.md
+role_spec: ~  or <project>/.claude/skills/team-ultra-analyze/role-specs/<role>.md
 session: <session-folder>
 session_id: <session-id>
 team_name: ultra-analyze

package/.claude/skills/team-ultra-analyze/roles/coordinator/role.md

@@ -152,7 +152,7 @@ Execute `commands/dispatch.md` inline (Command Execution Protocol):
 ### Initial Spawn
 
 Find first unblocked tasks and spawn their workers. Use SKILL.md Worker Spawn Template with:
-- `role_spec: .claude/skills/team-ultra-analyze/roles/<role>/role.md`
+- `role_spec: ~  or <project>/.claude/skills/team-ultra-analyze/roles/<role>/role.md`
 - `team_name: ultra-analyze`
 - `inner_loop: false`
 

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

@@ -76,7 +76,7 @@ Agent({
   run_in_background: true,
   prompt: `## Role Assignment
 role: <role>
-role_spec: .claude/skills/team-ux-improve/roles/<role>/role.md
+role_spec: ~  or <project>/.claude/skills/team-ux-improve/roles/<role>/role.md
 session: <session-folder>
 session_id: <session-id>
 team_name: ux-improve

package/.claude/skills/team-ux-improve/roles/coordinator/commands/monitor.md

@@ -102,7 +102,7 @@ Agent({
   run_in_background: true,
   prompt: `## Role Assignment
 role: <role>
-role_spec: .claude/skills/team-ux-improve/roles/<role>/role.md
+role_spec: ~  or <project>/.claude/skills/team-ux-improve/roles/<role>/role.md
 session: <session-folder>
 session_id: <session-id>
 team_name: ux-improve

package/.claude/skills/team-ux-improve/roles/coordinator/role.md

@@ -76,7 +76,7 @@ TEXT-LEVEL ONLY. No source code reading.
    ├── explorations/
    └── wisdom/contributions/
    ```
-3. **Wisdom Initialization**: Copy `.claude/skills/team-ux-improve/wisdom/` to `<session>/wisdom/`
+3. **Wisdom Initialization**: Copy `~  or <project>/.claude/skills/team-ux-improve/wisdom/` to `<session>/wisdom/`
 4. Initialize `.msg/meta.json` via team_msg state_update with pipeline metadata
 5. TeamCreate(team_name="ux-improve")
 6. Do NOT spawn workers yet - deferred to Phase 4
@@ -110,7 +110,7 @@ Delegate to `commands/monitor.md#handleSpawnNext`:
 
 3. **Wisdom Consolidation**: Check `<session>/wisdom/contributions/` for worker contributions
    - If contributions exist -> AskUserQuestion to merge to permanent wisdom
-   - If approved -> copy to `.claude/skills/team-ux-improve/wisdom/`
+   - If approved -> copy to `~  or <project>/.claude/skills/team-ux-improve/wisdom/`
 
 4. Calculate: completed_tasks, total_issues_found, issues_fixed, test_pass_rate
 5. Output pipeline summary with [coordinator] prefix

package/.claude/skills/team-ux-improve/specs/pipelines.md

@@ -44,7 +44,7 @@ UX improvement pipeline modes and task registry.
 
 ## Wisdom System
 
-Workers contribute learnings to `<session>/wisdom/contributions/`. On pipeline completion, coordinator asks user to merge approved contributions to permanent wisdom at `.claude/skills/team-ux-improve/wisdom/`.
+Workers contribute learnings to `<session>/wisdom/contributions/`. On pipeline completion, coordinator asks user to merge approved contributions to permanent wisdom at `~  or <project>/.claude/skills/team-ux-improve/wisdom/`.
 
 | Directory | Purpose |
 |-----------|---------|

package/.claude/skills/team-ux-improve/specs/team-config.json

@@ -4,7 +4,7 @@
   "team_display_name": "UX Improve",
   "team_purpose": "Systematically discover and fix UI/UX interaction issues including unresponsive buttons, missing feedback, and state refresh problems",
   "skill_name": "team-ux-improve",
-  "skill_path": ".claude/skills/team-ux-improve/",
+  "skill_path": "~  or <project>/.claude/skills/team-ux-improve/",
   "worker_agent": "team-worker",
   "pipeline_type": "Standard",
   "completion_action": "interactive",

package/.codex/skills/team-arch-opt/SKILL.md

@@ -658,3 +658,41 @@ All agents (csv-wave and interactive) share a single `discoveries.ndjson` file f
 8. **Max 3 Fix Cycles**: Review-fix cycle capped at 3 iterations; escalate to user after
 9. **Cleanup Temp Files**: Remove wave-{N}.csv after results are merged
 10. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
+
+
+---
+
+## Coordinator Role Constraints (Main Agent)
+
+**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
+
+15. **Coordinator Does NOT Execute Code**: The main agent MUST NOT write, modify, or implement any code directly. All implementation work is delegated to spawned team agents. The coordinator only:
+    - Spawns agents with task assignments
+    - Waits for agent callbacks
+    - Merges results and coordinates workflow
+    - Manages workflow transitions between phases
+
+16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
+    - Wait patiently for `wait()` calls to complete
+    - NOT skip workflow steps due to perceived delays
+    - NOT assume agents have failed just because they're taking time
+    - Trust the timeout mechanisms defined in the skill
+
+17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
+    - Use `send_input()` to ask questions or provide clarification
+    - NOT skip the agent or move to next phase prematurely
+    - Give agents opportunity to respond before escalating
+    - Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
+
+18. **No Workflow Shortcuts**: The coordinator MUST NOT:
+    - Skip phases or stages defined in the workflow
+    - Bypass required approval or review steps
+    - Execute dependent tasks before prerequisites complete
+    - Assume task completion without explicit agent callback
+    - Make up or fabricate agent results
+
+19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
+    - Total execution time may range from 30-90 minutes or longer
+    - Each phase may take 10-30 minutes depending on complexity
+    - The coordinator must remain active and attentive throughout the entire process
+    - Do not terminate or skip steps due to time concerns

package/.codex/skills/team-arch-opt/instructions/agent-instruction.md

@@ -1,114 +1,114 @@
-## TASK ASSIGNMENT
-
-### MANDATORY FIRST STEPS
-1. Read shared discoveries: {session_folder}/discoveries.ndjson (if exists, skip if not)
-2. Read project context: .workflow/project-tech.json (if exists)
-3. Read task schema: .codex/skills/team-arch-opt/schemas/tasks-schema.md
-
----
-
-## Your Task
-
-**Task ID**: {id}
-**Title**: {title}
-**Description**: {description}
-**Role**: {role}
-**Issue Type**: {issue_type}
-**Priority**: {priority}
-**Target Files**: {target_files}
-
-### Previous Tasks' Findings (Context)
-{prev_context}
-
----
-
-## Execution Protocol
-
-1. **Read discoveries**: Load {session_folder}/discoveries.ndjson for shared exploration findings
-2. **Use context**: Apply previous tasks' findings from prev_context above
-3. **Execute by role**:
-
-   **If role = analyzer**:
-   - Scan codebase for architecture issues within target scope
-   - Build import/require graph, detect circular dependencies
-   - Identify God Classes (>500 LOC, >10 public methods)
-   - Calculate coupling (fan-in/fan-out) and cohesion metrics
-   - Detect dead code, dead exports, layering violations
-   - Collect quantified baseline metrics
-   - Rank top 3-7 issues by severity (Critical/High/Medium)
-   - Write `{session_folder}/artifacts/architecture-baseline.json` (metrics)
-   - Write `{session_folder}/artifacts/architecture-report.md` (ranked issues)
-
-   **If role = designer**:
-   - Read architecture report and baseline from {session_folder}/artifacts/
-   - For each issue, select refactoring strategy by type:
-     - CYCLE: interface extraction, dependency inversion, mediator
-     - GOD_CLASS: SRP decomposition, extract class/module
-     - COUPLING: introduce interface/abstraction, DI, events
-     - DUPLICATION: extract shared utility/base class
-     - LAYER_VIOLATION: move to correct layer, add facade
-     - DEAD_CODE: safe removal with reference verification
-     - API_BLOAT: privatize internals, barrel file cleanup
-   - Prioritize by impact/effort: P0 (high impact+low effort) to P3 (low impact or high effort)
-   - Assign unique REFACTOR-IDs (REFACTOR-001, 002, ...) with non-overlapping file targets
-   - Write `{session_folder}/artifacts/refactoring-plan.md`
-
-   **If role = refactorer**:
-   - Read refactoring plan from {session_folder}/artifacts/refactoring-plan.md
-   - Apply refactorings in priority order (P0 first)
-   - Preserve existing behavior -- refactoring must not change functionality
-   - Update ALL import references when moving/renaming modules
-   - Update ALL test files referencing moved/renamed symbols
-   - Verify no dangling imports after module moves
-
-   **If role = validator**:
-   - Read baseline from {session_folder}/artifacts/architecture-baseline.json
-   - Read plan from {session_folder}/artifacts/refactoring-plan.md
-   - Build validation: compile/type-check, zero new errors
-   - Test validation: run test suite, no new failures
-   - Metric validation: coupling improved or neutral, no new cycles
-   - API validation: public signatures preserved, no dangling references
-   - Write `{session_folder}/artifacts/validation-results.json`
-   - Set verdict: PASS / WARN / FAIL
-
-   **If role = reviewer**:
-   - Read plan from {session_folder}/artifacts/refactoring-plan.md
-   - Review changed files across 5 dimensions:
-     - Correctness: no behavior changes, all references updated
-     - Pattern consistency: follows existing conventions
-     - Completeness: imports, tests, configs all updated
-     - Migration safety: no dangling refs, backward compatible
-     - Best practices: SOLID, appropriate abstraction
-   - Write `{session_folder}/artifacts/review-report.md`
-   - Set verdict: APPROVE / REVISE / REJECT
-
-4. **Share discoveries**: Append exploration findings to shared board:
-   ```bash
-   echo '{"ts":"<ISO8601>","worker":"{id}","type":"<type>","data":{...}}' >> {session_folder}/discoveries.ndjson
-   ```
-5. **Report result**: Return JSON via report_agent_job_result
-
-### Discovery Types to Share
-- `cycle_found`: `{modules, depth, description}` -- Circular dependency detected
-- `god_class_found`: `{file, loc, methods, description}` -- God Class identified
-- `coupling_issue`: `{module, fan_in, fan_out, description}` -- High coupling
-- `dead_code_found`: `{file, type, description}` -- Dead code found
-- `layer_violation`: `{from, to, description}` -- Layering violation
-- `file_modified`: `{file, change, lines_added}` -- File change recorded
-- `pattern_found`: `{pattern_name, location, description}` -- Pattern identified
-- `metric_measured`: `{metric, value, unit, module}` -- Metric measured
-- `artifact_produced`: `{name, path, producer, type}` -- Deliverable created
-
----
-
-## Output (report_agent_job_result)
-
-Return JSON:
-{
-  "id": "{id}",
-  "status": "completed" | "failed",
-  "findings": "Key discoveries and implementation notes (max 500 chars)",
-  "verdict": "PASS|WARN|FAIL|APPROVE|REVISE|REJECT or empty",
-  "artifacts_produced": "semicolon-separated artifact paths",
-  "error": ""
-}
+## TASK ASSIGNMENT
+
+### MANDATORY FIRST STEPS
+1. Read shared discoveries: {session_folder}/discoveries.ndjson (if exists, skip if not)
+2. Read project context: .workflow/project-tech.json (if exists)
+3. Read task schema: ~  or <project>/.codex/skills/team-arch-opt/schemas/tasks-schema.md
+
+---
+
+## Your Task
+
+**Task ID**: {id}
+**Title**: {title}
+**Description**: {description}
+**Role**: {role}
+**Issue Type**: {issue_type}
+**Priority**: {priority}
+**Target Files**: {target_files}
+
+### Previous Tasks' Findings (Context)
+{prev_context}
+
+---
+
+## Execution Protocol
+
+1. **Read discoveries**: Load {session_folder}/discoveries.ndjson for shared exploration findings
+2. **Use context**: Apply previous tasks' findings from prev_context above
+3. **Execute by role**:
+
+   **If role = analyzer**:
+   - Scan codebase for architecture issues within target scope
+   - Build import/require graph, detect circular dependencies
+   - Identify God Classes (>500 LOC, >10 public methods)
+   - Calculate coupling (fan-in/fan-out) and cohesion metrics
+   - Detect dead code, dead exports, layering violations
+   - Collect quantified baseline metrics
+   - Rank top 3-7 issues by severity (Critical/High/Medium)
+   - Write `{session_folder}/artifacts/architecture-baseline.json` (metrics)
+   - Write `{session_folder}/artifacts/architecture-report.md` (ranked issues)
+
+   **If role = designer**:
+   - Read architecture report and baseline from {session_folder}/artifacts/
+   - For each issue, select refactoring strategy by type:
+     - CYCLE: interface extraction, dependency inversion, mediator
+     - GOD_CLASS: SRP decomposition, extract class/module
+     - COUPLING: introduce interface/abstraction, DI, events
+     - DUPLICATION: extract shared utility/base class
+     - LAYER_VIOLATION: move to correct layer, add facade
+     - DEAD_CODE: safe removal with reference verification
+     - API_BLOAT: privatize internals, barrel file cleanup
+   - Prioritize by impact/effort: P0 (high impact+low effort) to P3 (low impact or high effort)
+   - Assign unique REFACTOR-IDs (REFACTOR-001, 002, ...) with non-overlapping file targets
+   - Write `{session_folder}/artifacts/refactoring-plan.md`
+
+   **If role = refactorer**:
+   - Read refactoring plan from {session_folder}/artifacts/refactoring-plan.md
+   - Apply refactorings in priority order (P0 first)
+   - Preserve existing behavior -- refactoring must not change functionality
+   - Update ALL import references when moving/renaming modules
+   - Update ALL test files referencing moved/renamed symbols
+   - Verify no dangling imports after module moves
+
+   **If role = validator**:
+   - Read baseline from {session_folder}/artifacts/architecture-baseline.json
+   - Read plan from {session_folder}/artifacts/refactoring-plan.md
+   - Build validation: compile/type-check, zero new errors
+   - Test validation: run test suite, no new failures
+   - Metric validation: coupling improved or neutral, no new cycles
+   - API validation: public signatures preserved, no dangling references
+   - Write `{session_folder}/artifacts/validation-results.json`
+   - Set verdict: PASS / WARN / FAIL
+
+   **If role = reviewer**:
+   - Read plan from {session_folder}/artifacts/refactoring-plan.md
+   - Review changed files across 5 dimensions:
+     - Correctness: no behavior changes, all references updated
+     - Pattern consistency: follows existing conventions
+     - Completeness: imports, tests, configs all updated
+     - Migration safety: no dangling refs, backward compatible
+     - Best practices: SOLID, appropriate abstraction
+   - Write `{session_folder}/artifacts/review-report.md`
+   - Set verdict: APPROVE / REVISE / REJECT
+
+4. **Share discoveries**: Append exploration findings to shared board:
+   ```bash
+   echo '{"ts":"<ISO8601>","worker":"{id}","type":"<type>","data":{...}}' >> {session_folder}/discoveries.ndjson
+   ```
+5. **Report result**: Return JSON via report_agent_job_result
+
+### Discovery Types to Share
+- `cycle_found`: `{modules, depth, description}` -- Circular dependency detected
+- `god_class_found`: `{file, loc, methods, description}` -- God Class identified
+- `coupling_issue`: `{module, fan_in, fan_out, description}` -- High coupling
+- `dead_code_found`: `{file, type, description}` -- Dead code found
+- `layer_violation`: `{from, to, description}` -- Layering violation
+- `file_modified`: `{file, change, lines_added}` -- File change recorded
+- `pattern_found`: `{pattern_name, location, description}` -- Pattern identified
+- `metric_measured`: `{metric, value, unit, module}` -- Metric measured
+- `artifact_produced`: `{name, path, producer, type}` -- Deliverable created
+
+---
+
+## Output (report_agent_job_result)
+
+Return JSON:
+{
+  "id": "{id}",
+  "status": "completed" | "failed",
+  "findings": "Key discoveries and implementation notes (max 500 chars)",
+  "verdict": "PASS|WARN|FAIL|APPROVE|REVISE|REJECT or empty",
+  "artifacts_produced": "semicolon-separated artifact paths",
+  "error": ""
+}