claude-code-workflow 7.2.14 → 7.2.15

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 (75) hide show
  1. package/.claude/commands/workflow/analyze-with-file.md +7 -0
  2. package/.codex/skills/analyze-with-file/SKILL.md +1181 -1182
  3. package/.codex/skills/brainstorm/SKILL.md +723 -725
  4. package/.codex/skills/brainstorm-with-file/SKILL.md +10 -5
  5. package/.codex/skills/clean/SKILL.md +33 -26
  6. package/.codex/skills/collaborative-plan-with-file/SKILL.md +830 -831
  7. package/.codex/skills/csv-wave-pipeline/SKILL.md +906 -906
  8. package/.codex/skills/issue-discover/SKILL.md +57 -50
  9. package/.codex/skills/issue-discover/phases/01-issue-new.md +18 -11
  10. package/.codex/skills/issue-discover/phases/02-discover.md +31 -26
  11. package/.codex/skills/issue-discover/phases/03-discover-by-prompt.md +13 -11
  12. package/.codex/skills/issue-discover/phases/04-quick-execute.md +32 -27
  13. package/.codex/skills/parallel-dev-cycle/SKILL.md +402 -402
  14. package/.codex/skills/project-documentation-workflow/SKILL.md +13 -3
  15. package/.codex/skills/roadmap-with-file/SKILL.md +901 -897
  16. package/.codex/skills/session-sync/SKILL.md +222 -212
  17. package/.codex/skills/spec-add/SKILL.md +620 -613
  18. package/.codex/skills/spec-generator/SKILL.md +2 -2
  19. package/.codex/skills/spec-generator/phases/01-5-requirement-clarification.md +10 -10
  20. package/.codex/skills/spec-generator/phases/01-discovery.md +11 -18
  21. package/.codex/skills/spec-generator/phases/02-product-brief.md +5 -5
  22. package/.codex/skills/spec-generator/phases/03-requirements.md +7 -7
  23. package/.codex/skills/spec-generator/phases/04-architecture.md +4 -4
  24. package/.codex/skills/spec-generator/phases/05-epics-stories.md +5 -6
  25. package/.codex/skills/spec-generator/phases/06-readiness-check.md +10 -17
  26. package/.codex/skills/spec-generator/phases/07-issue-export.md +326 -329
  27. package/.codex/skills/spec-setup/SKILL.md +669 -657
  28. package/.codex/skills/team-arch-opt/SKILL.md +50 -50
  29. package/.codex/skills/team-arch-opt/agents/completion-handler.md +3 -3
  30. package/.codex/skills/team-brainstorm/SKILL.md +724 -725
  31. package/.codex/skills/team-coordinate/SKILL.md +51 -51
  32. package/.codex/skills/team-coordinate/agents/completion-handler.md +3 -3
  33. package/.codex/skills/team-coordinate/agents/plan-reviewer.md +4 -4
  34. package/.codex/skills/team-designer/SKILL.md +691 -691
  35. package/.codex/skills/team-designer/agents/requirement-clarifier.md +11 -12
  36. package/.codex/skills/team-executor/SKILL.md +45 -45
  37. package/.codex/skills/team-frontend/SKILL.md +45 -45
  38. package/.codex/skills/team-frontend/agents/completion-handler.md +3 -3
  39. package/.codex/skills/team-frontend/agents/qa-gate-reviewer.md +4 -4
  40. package/.codex/skills/team-frontend-debug/SKILL.md +50 -50
  41. package/.codex/skills/team-frontend-debug/agents/completion-handler.md +3 -3
  42. package/.codex/skills/team-frontend-debug/agents/conditional-skip-gate.md +4 -4
  43. package/.codex/skills/team-issue/SKILL.md +751 -740
  44. package/.codex/skills/team-iterdev/SKILL.md +825 -826
  45. package/.codex/skills/team-lifecycle-v4/SKILL.md +775 -775
  46. package/.codex/skills/team-lifecycle-v4/agents/quality-gate.md +165 -165
  47. package/.codex/skills/team-lifecycle-v4/agents/requirement-clarifier.md +163 -163
  48. package/.codex/skills/team-perf-opt/SKILL.md +50 -50
  49. package/.codex/skills/team-perf-opt/agents/completion-handler.md +3 -3
  50. package/.codex/skills/team-planex-v2/SKILL.md +652 -637
  51. package/.codex/skills/team-quality-assurance/SKILL.md +51 -52
  52. package/.codex/skills/team-review/SKILL.md +40 -40
  53. package/.codex/skills/team-roadmap-dev/SKILL.md +51 -51
  54. package/.codex/skills/team-roadmap-dev/agents/roadmap-discusser.md +8 -8
  55. package/.codex/skills/team-tech-debt/SKILL.md +50 -50
  56. package/.codex/skills/team-tech-debt/agents/plan-approver.md +5 -5
  57. package/.codex/skills/team-testing/SKILL.md +51 -52
  58. package/.codex/skills/team-uidesign/SKILL.md +40 -40
  59. package/.codex/skills/team-uidesign/agents/completion-handler.md +177 -177
  60. package/.codex/skills/team-ultra-analyze/SKILL.md +786 -787
  61. package/.codex/skills/team-ultra-analyze/agents/discussion-feedback.md +8 -8
  62. package/.codex/skills/team-ux-improve/SKILL.md +51 -52
  63. package/.codex/skills/team-ux-improve/agents/ux-designer.md +2 -2
  64. package/.codex/skills/team-ux-improve/agents/ux-explorer.md +1 -1
  65. package/.codex/skills/unified-execute-with-file/SKILL.md +797 -796
  66. package/.codex/skills/workflow-execute/SKILL.md +1117 -1118
  67. package/.codex/skills/workflow-lite-planex/SKILL.md +1144 -1141
  68. package/.codex/skills/workflow-plan/SKILL.md +631 -636
  69. package/.codex/skills/workflow-tdd-plan/SKILL.md +753 -759
  70. package/.codex/skills/workflow-test-fix-cycle/SKILL.md +402 -392
  71. package/README.md +25 -0
  72. package/ccw/dist/commands/install.d.ts.map +1 -1
  73. package/ccw/dist/commands/install.js +12 -0
  74. package/ccw/dist/commands/install.js.map +1 -1
  75. package/package.json +1 -1
@@ -13,7 +13,7 @@ Collect user feedback after a discussion round and determine next action for the
13
13
 
14
14
  - Load role definition via MANDATORY FIRST STEPS pattern
15
15
  - Present discussion results to the user clearly
16
- - Collect explicit user feedback via AskUserQuestion
16
+ - Collect explicit user feedback via request_user_input
17
17
  - Return structured decision for orchestrator to act on
18
18
  - Respect max discussion round limits
19
19
 
@@ -33,7 +33,7 @@ Collect user feedback after a discussion round and determine next action for the
33
33
  | Tool | Type | Purpose |
34
34
  |------|------|---------|
35
35
  | `Read` | builtin | Load discussion results and session state |
36
- | `AskUserQuestion` | builtin | Collect user feedback on discussion |
36
+ | `request_user_input` | builtin | Collect user feedback on discussion |
37
37
 
38
38
  ---
39
39
 
@@ -75,16 +75,16 @@ Collect user feedback after a discussion round and determine next action for the
75
75
  - Top open questions
76
76
  - Round progress (current/max)
77
77
 
78
- 2. Present options via AskUserQuestion:
78
+ 2. Present options via request_user_input:
79
79
 
80
80
  ```
81
- AskUserQuestion({
81
+ request_user_input({
82
82
  questions: [{
83
83
  question: "Discussion round <N>/<max> complete.\n\nThemes: <themes>\nConflicts: <conflicts>\nOpen Questions: <questions>\n\nWhat next?",
84
- header: "Discussion Feedback",
85
- multiSelect: false,
84
+ header: "Feedback",
85
+ id: "discussion_next",
86
86
  options: [
87
- { label: "Continue deeper", description: "Current direction is good, investigate open questions deeper" },
87
+ { label: "Continue deeper (Recommended)", description: "Current direction is good, investigate open questions deeper" },
88
88
  { label: "Adjust direction", description: "Shift analysis focus to a different area" },
89
89
  { label: "Done", description: "Sufficient depth reached, proceed to final synthesis" }
90
90
  ]
@@ -93,7 +93,7 @@ AskUserQuestion({
93
93
  ```
94
94
 
95
95
  3. If user chooses "Adjust direction":
96
- - Follow up with another AskUserQuestion asking for the new focus area
96
+ - Follow up with another request_user_input asking for the new focus area
97
97
  - Capture the adjusted focus text
98
98
 
99
99
  **Output**: User decision and optional adjusted focus
@@ -2,7 +2,7 @@
2
2
  name: team-ux-improve
3
3
  description: Systematic UX improvement pipeline. Discovers and fixes UI/UX interaction issues including unresponsive buttons, missing feedback, and state refresh problems using scan->diagnose->design->implement->test workflow.
4
4
  argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] \"<project-path> [--framework react|vue]\""
5
- allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
5
+ allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, Read, Write, Edit, Bash, Glob, Grep, request_user_input
6
6
  ---
7
7
 
8
8
  ## Auto Mode
@@ -452,19 +452,19 @@ writeMasterCSV(`${sessionDir}/tasks.csv`, tasksWithWaves)
452
452
 
453
453
  // User validation (skip if autoYes)
454
454
  if (!autoYes) {
455
- const approval = AskUserQuestion({
455
+ const approval = request_user_input({
456
456
  questions: [{
457
+ id: "task_approval",
457
458
  question: `Generated ${tasksWithWaves.length} tasks for ${components.length} components. Proceed?`,
458
- header: "Task Breakdown Validation",
459
- multiSelect: false,
459
+ header: "Validate",
460
460
  options: [
461
- { label: "Proceed", description: "Start UX improvement pipeline" },
461
+ { label: "Proceed (Recommended)", description: "Start UX improvement pipeline" },
462
462
  { label: "Cancel", description: "Abort workflow" }
463
463
  ]
464
464
  }]
465
465
  })
466
466
 
467
- if (approval.answers[0] !== "Proceed") {
467
+ if (approval.answers.task_approval.answers[0] !== "Proceed (Recommended)") {
468
468
  throw new Error("User cancelled workflow")
469
469
  }
470
470
  }
@@ -530,20 +530,19 @@ console.log(`\nResults: ${sessionDir}/results.csv`)
530
530
  console.log(`Report: ${sessionDir}/context.md`)
531
531
 
532
532
  // Offer next steps
533
- const nextStep = AskUserQuestion({
533
+ const nextStep = request_user_input({
534
534
  questions: [{
535
+ id: "completion",
535
536
  question: "UX Improvement pipeline complete. What would you like to do?",
536
- header: "Completion",
537
- multiSelect: false,
537
+ header: "Done",
538
538
  options: [
539
- { label: "Archive & Clean", description: "Archive session and clean up team resources" },
540
- { label: "Keep Active", description: "Keep session for follow-up work" },
541
- { label: "Export Results", description: "Export deliverables to specified location" }
539
+ { label: "Archive (Recommended)", description: "Archive session and clean up team resources" },
540
+ { label: "Keep Active", description: "Keep session for follow-up work" }
542
541
  ]
543
542
  }]
544
543
  })
545
544
 
546
- if (nextStep.answers[0] === "Archive & Clean") {
545
+ if (nextStep.answers.completion.answers[0] === "Archive (Recommended)") {
547
546
  Bash(`tar -czf "${sessionDir}.tar.gz" "${sessionDir}" && rm -rf "${sessionDir}"`)
548
547
  console.log(`Session archived to ${sessionDir}.tar.gz`)
549
548
  }
@@ -576,7 +575,7 @@ All agents share `discoveries.ndjson` for UX findings.
576
575
 
577
576
  | Error | Resolution |
578
577
  |-------|------------|
579
- | Framework detection fails | AskUserQuestion for framework selection |
578
+ | Framework detection fails | request_user_input for framework selection |
580
579
  | No components found | Complete with empty report, note in findings |
581
580
  | Circular dependency | Detect in wave computation, abort with error |
582
581
  | CSV agent timeout | Mark as failed, continue with wave |
@@ -599,41 +598,41 @@ All agents share `discoveries.ndjson` for UX findings.
599
598
  8. **Lifecycle Balance**: Every spawn_agent has matching close_agent
600
599
  9. **Cleanup Temp Files**: Remove wave-{N}.csv after merge
601
600
  10. **DO NOT STOP**: Continuous execution until all waves complete
602
-
603
-
604
- ---
605
-
606
- ## Coordinator Role Constraints (Main Agent)
607
-
608
- **CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
609
-
610
- 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:
611
- - Spawns agents with task assignments
612
- - Waits for agent callbacks
613
- - Merges results and coordinates workflow
614
- - Manages workflow transitions between phases
615
-
616
- 16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
617
- - Wait patiently for `wait()` calls to complete
618
- - NOT skip workflow steps due to perceived delays
619
- - NOT assume agents have failed just because they're taking time
620
- - Trust the timeout mechanisms defined in the skill
621
-
622
- 17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
623
- - Use `send_input()` to ask questions or provide clarification
624
- - NOT skip the agent or move to next phase prematurely
625
- - Give agents opportunity to respond before escalating
626
- - Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
627
-
628
- 18. **No Workflow Shortcuts**: The coordinator MUST NOT:
629
- - Skip phases or stages defined in the workflow
630
- - Bypass required approval or review steps
631
- - Execute dependent tasks before prerequisites complete
632
- - Assume task completion without explicit agent callback
633
- - Make up or fabricate agent results
634
-
635
- 19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
636
- - Total execution time may range from 30-90 minutes or longer
637
- - Each phase may take 10-30 minutes depending on complexity
638
- - The coordinator must remain active and attentive throughout the entire process
639
- - Do not terminate or skip steps due to time concerns
601
+
602
+
603
+ ---
604
+
605
+ ## Coordinator Role Constraints (Main Agent)
606
+
607
+ **CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
608
+
609
+ 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:
610
+ - Spawns agents with task assignments
611
+ - Waits for agent callbacks
612
+ - Merges results and coordinates workflow
613
+ - Manages workflow transitions between phases
614
+
615
+ 16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
616
+ - Wait patiently for `wait()` calls to complete
617
+ - NOT skip workflow steps due to perceived delays
618
+ - NOT assume agents have failed just because they're taking time
619
+ - Trust the timeout mechanisms defined in the skill
620
+
621
+ 17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
622
+ - Use `send_input()` to ask questions or provide clarification
623
+ - NOT skip the agent or move to next phase prematurely
624
+ - Give agents opportunity to respond before escalating
625
+ - Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
626
+
627
+ 18. **No Workflow Shortcuts**: The coordinator MUST NOT:
628
+ - Skip phases or stages defined in the workflow
629
+ - Bypass required approval or review steps
630
+ - Execute dependent tasks before prerequisites complete
631
+ - Assume task completion without explicit agent callback
632
+ - Make up or fabricate agent results
633
+
634
+ 19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
635
+ - Total execution time may range from 30-90 minutes or longer
636
+ - Each phase may take 10-30 minutes depending on complexity
637
+ - The coordinator must remain active and attentive throughout the entire process
638
+ - Do not terminate or skip steps due to time concerns
@@ -34,7 +34,7 @@ Interactive agent for designing fix approaches for identified UX issues. Propose
34
34
  |------|------|---------|
35
35
  | `Read` | File I/O | Load diagnosis, exploration cache |
36
36
  | `Write` | File I/O | Generate design guide |
37
- | `AskUserQuestion` | Human interaction | Clarify design decisions if needed |
37
+ | `request_user_input` | Human interaction | Clarify design decisions if needed |
38
38
 
39
39
  ---
40
40
 
@@ -132,5 +132,5 @@ Interactive agent for designing fix approaches for identified UX issues. Propose
132
132
  | Scenario | Resolution |
133
133
  |----------|------------|
134
134
  | No issues found | Generate empty design guide, note in findings |
135
- | Ambiguous fix approach | Ask user for guidance via AskUserQuestion |
135
+ | Ambiguous fix approach | Ask user for guidance via request_user_input |
136
136
  | Conflicting patterns | Document trade-offs, recommend approach |
@@ -153,6 +153,6 @@ Interactive agent for exploring codebase to identify UI component patterns and f
153
153
 
154
154
  | Scenario | Resolution |
155
155
  |----------|------------|
156
- | Framework detection fails | Ask user via AskUserQuestion |
156
+ | Framework detection fails | Ask user via request_user_input |
157
157
  | No components found | Return empty inventory, note in findings |
158
158
  | Invalid project path | Report error, request valid path |