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.
- package/.claude/commands/workflow/analyze-with-file.md +7 -0
- package/.codex/skills/analyze-with-file/SKILL.md +1181 -1182
- package/.codex/skills/brainstorm/SKILL.md +723 -725
- package/.codex/skills/brainstorm-with-file/SKILL.md +10 -5
- package/.codex/skills/clean/SKILL.md +33 -26
- package/.codex/skills/collaborative-plan-with-file/SKILL.md +830 -831
- package/.codex/skills/csv-wave-pipeline/SKILL.md +906 -906
- package/.codex/skills/issue-discover/SKILL.md +57 -50
- package/.codex/skills/issue-discover/phases/01-issue-new.md +18 -11
- package/.codex/skills/issue-discover/phases/02-discover.md +31 -26
- package/.codex/skills/issue-discover/phases/03-discover-by-prompt.md +13 -11
- package/.codex/skills/issue-discover/phases/04-quick-execute.md +32 -27
- package/.codex/skills/parallel-dev-cycle/SKILL.md +402 -402
- package/.codex/skills/project-documentation-workflow/SKILL.md +13 -3
- package/.codex/skills/roadmap-with-file/SKILL.md +901 -897
- package/.codex/skills/session-sync/SKILL.md +222 -212
- package/.codex/skills/spec-add/SKILL.md +620 -613
- package/.codex/skills/spec-generator/SKILL.md +2 -2
- package/.codex/skills/spec-generator/phases/01-5-requirement-clarification.md +10 -10
- package/.codex/skills/spec-generator/phases/01-discovery.md +11 -18
- package/.codex/skills/spec-generator/phases/02-product-brief.md +5 -5
- package/.codex/skills/spec-generator/phases/03-requirements.md +7 -7
- package/.codex/skills/spec-generator/phases/04-architecture.md +4 -4
- package/.codex/skills/spec-generator/phases/05-epics-stories.md +5 -6
- package/.codex/skills/spec-generator/phases/06-readiness-check.md +10 -17
- package/.codex/skills/spec-generator/phases/07-issue-export.md +326 -329
- package/.codex/skills/spec-setup/SKILL.md +669 -657
- package/.codex/skills/team-arch-opt/SKILL.md +50 -50
- package/.codex/skills/team-arch-opt/agents/completion-handler.md +3 -3
- package/.codex/skills/team-brainstorm/SKILL.md +724 -725
- package/.codex/skills/team-coordinate/SKILL.md +51 -51
- package/.codex/skills/team-coordinate/agents/completion-handler.md +3 -3
- package/.codex/skills/team-coordinate/agents/plan-reviewer.md +4 -4
- package/.codex/skills/team-designer/SKILL.md +691 -691
- package/.codex/skills/team-designer/agents/requirement-clarifier.md +11 -12
- package/.codex/skills/team-executor/SKILL.md +45 -45
- package/.codex/skills/team-frontend/SKILL.md +45 -45
- package/.codex/skills/team-frontend/agents/completion-handler.md +3 -3
- package/.codex/skills/team-frontend/agents/qa-gate-reviewer.md +4 -4
- package/.codex/skills/team-frontend-debug/SKILL.md +50 -50
- package/.codex/skills/team-frontend-debug/agents/completion-handler.md +3 -3
- package/.codex/skills/team-frontend-debug/agents/conditional-skip-gate.md +4 -4
- package/.codex/skills/team-issue/SKILL.md +751 -740
- package/.codex/skills/team-iterdev/SKILL.md +825 -826
- package/.codex/skills/team-lifecycle-v4/SKILL.md +775 -775
- package/.codex/skills/team-lifecycle-v4/agents/quality-gate.md +165 -165
- package/.codex/skills/team-lifecycle-v4/agents/requirement-clarifier.md +163 -163
- package/.codex/skills/team-perf-opt/SKILL.md +50 -50
- package/.codex/skills/team-perf-opt/agents/completion-handler.md +3 -3
- package/.codex/skills/team-planex-v2/SKILL.md +652 -637
- package/.codex/skills/team-quality-assurance/SKILL.md +51 -52
- package/.codex/skills/team-review/SKILL.md +40 -40
- package/.codex/skills/team-roadmap-dev/SKILL.md +51 -51
- package/.codex/skills/team-roadmap-dev/agents/roadmap-discusser.md +8 -8
- package/.codex/skills/team-tech-debt/SKILL.md +50 -50
- package/.codex/skills/team-tech-debt/agents/plan-approver.md +5 -5
- package/.codex/skills/team-testing/SKILL.md +51 -52
- package/.codex/skills/team-uidesign/SKILL.md +40 -40
- package/.codex/skills/team-uidesign/agents/completion-handler.md +177 -177
- package/.codex/skills/team-ultra-analyze/SKILL.md +786 -787
- package/.codex/skills/team-ultra-analyze/agents/discussion-feedback.md +8 -8
- package/.codex/skills/team-ux-improve/SKILL.md +51 -52
- package/.codex/skills/team-ux-improve/agents/ux-designer.md +2 -2
- package/.codex/skills/team-ux-improve/agents/ux-explorer.md +1 -1
- package/.codex/skills/unified-execute-with-file/SKILL.md +797 -796
- package/.codex/skills/workflow-execute/SKILL.md +1117 -1118
- package/.codex/skills/workflow-lite-planex/SKILL.md +1144 -1141
- package/.codex/skills/workflow-plan/SKILL.md +631 -636
- package/.codex/skills/workflow-tdd-plan/SKILL.md +753 -759
- package/.codex/skills/workflow-test-fix-cycle/SKILL.md +402 -392
- package/README.md +25 -0
- package/ccw/dist/commands/install.d.ts.map +1 -1
- package/ccw/dist/commands/install.js +12 -0
- package/ccw/dist/commands/install.js.map +1 -1
- 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
|
|
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
|
-
| `
|
|
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
|
|
78
|
+
2. Present options via request_user_input:
|
|
79
79
|
|
|
80
80
|
```
|
|
81
|
-
|
|
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: "
|
|
85
|
-
|
|
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
|
|
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,
|
|
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 =
|
|
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: "
|
|
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 =
|
|
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: "
|
|
537
|
-
multiSelect: false,
|
|
537
|
+
header: "Done",
|
|
538
538
|
options: [
|
|
539
|
-
{ label: "Archive
|
|
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
|
|
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 |
|
|
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
|
-
| `
|
|
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
|
|
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
|
|
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 |
|