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
|
@@ -36,7 +36,7 @@ Interactive agent for gathering and refining team skill requirements from user i
|
|
|
36
36
|
| Tool | Type | Purpose |
|
|
37
37
|
|------|------|---------|
|
|
38
38
|
| `Read` | built-in | Load reference skills, existing patterns |
|
|
39
|
-
| `
|
|
39
|
+
| `request_user_input` | built-in | Gather missing details from user |
|
|
40
40
|
| `Write` | built-in | Store teamConfig.json |
|
|
41
41
|
| `Glob` | built-in | Find reference skill files |
|
|
42
42
|
|
|
@@ -94,23 +94,23 @@ Write("<session>/teamConfig.json", <config>)
|
|
|
94
94
|
1. **Core Identity** -- gather if not clear from input:
|
|
95
95
|
|
|
96
96
|
```javascript
|
|
97
|
-
|
|
97
|
+
request_user_input({
|
|
98
98
|
questions: [
|
|
99
99
|
{
|
|
100
100
|
question: "Team skill name? (kebab-case, e.g., team-code-review)",
|
|
101
101
|
header: "Skill Name",
|
|
102
|
-
|
|
102
|
+
id: "skill_name",
|
|
103
103
|
options: [
|
|
104
|
-
{ label: "<auto-suggested-name>", description: "Auto-suggested from description" },
|
|
104
|
+
{ label: "<auto-suggested-name> (Recommended)", description: "Auto-suggested from description" },
|
|
105
105
|
{ label: "Custom", description: "Enter custom name" }
|
|
106
106
|
]
|
|
107
107
|
},
|
|
108
108
|
{
|
|
109
109
|
question: "Session prefix? (3-4 chars for task IDs, e.g., TCR)",
|
|
110
110
|
header: "Prefix",
|
|
111
|
-
|
|
111
|
+
id: "session_prefix",
|
|
112
112
|
options: [
|
|
113
|
-
{ label: "<auto-suggested-prefix>", description: "Auto-suggested" },
|
|
113
|
+
{ label: "<auto-suggested-prefix> (Recommended)", description: "Auto-suggested" },
|
|
114
114
|
{ label: "Custom", description: "Enter custom prefix" }
|
|
115
115
|
]
|
|
116
116
|
}
|
|
@@ -186,16 +186,15 @@ Templates: <list or none>
|
|
|
186
186
|
2. Present confirmation:
|
|
187
187
|
|
|
188
188
|
```javascript
|
|
189
|
-
|
|
189
|
+
request_user_input({
|
|
190
190
|
questions: [{
|
|
191
191
|
question: "Confirm this team skill configuration?",
|
|
192
|
-
header: "
|
|
193
|
-
|
|
192
|
+
header: "Config Review",
|
|
193
|
+
id: "config_review",
|
|
194
194
|
options: [
|
|
195
|
-
{ label: "Confirm", description: "Proceed with generation" },
|
|
195
|
+
{ label: "Confirm (Recommended)", description: "Proceed with generation" },
|
|
196
196
|
{ label: "Modify Roles", description: "Add, remove, or change roles" },
|
|
197
|
-
{ label: "Modify Pipelines", description: "Change pipeline structure" }
|
|
198
|
-
{ label: "Cancel", description: "Abort skill generation" }
|
|
197
|
+
{ label: "Modify Pipelines", description: "Change pipeline structure" }
|
|
199
198
|
]
|
|
200
199
|
}]
|
|
201
200
|
})
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: team-executor
|
|
3
3
|
description: Lightweight session execution skill. Resumes existing team-coordinate sessions for pure execution via worker agents. No analysis, no role generation -- only loads and executes. Session path required.
|
|
4
4
|
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] \"--session=<path>\""
|
|
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
|
|
@@ -383,13 +383,13 @@ const summary = {
|
|
|
383
383
|
console.log(`Pipeline complete: ${summary.completed}/${summary.total} tasks completed`)
|
|
384
384
|
|
|
385
385
|
// Completion action
|
|
386
|
-
const action =
|
|
386
|
+
const action = request_user_input({
|
|
387
387
|
questions: [{
|
|
388
|
-
question: "Team pipeline complete.
|
|
389
|
-
header: "
|
|
390
|
-
|
|
388
|
+
question: "Team pipeline complete. Choose next action.",
|
|
389
|
+
header: "Done",
|
|
390
|
+
id: "completion",
|
|
391
391
|
options: [
|
|
392
|
-
{ label: "Archive
|
|
392
|
+
{ label: "Archive (Recommended)", description: "Archive session, clean up team" },
|
|
393
393
|
{ label: "Keep Active", description: "Keep session for follow-up work" },
|
|
394
394
|
{ label: "Export Results", description: "Export deliverables to target directory, then clean" }
|
|
395
395
|
]
|
|
@@ -397,7 +397,7 @@ const action = await AskUserQuestion({
|
|
|
397
397
|
})
|
|
398
398
|
|
|
399
399
|
// Handle completion action
|
|
400
|
-
if (action === "Archive
|
|
400
|
+
if (action.answers.completion.answers[0] === "Archive (Recommended)") {
|
|
401
401
|
// Update session status, cleanup team
|
|
402
402
|
} else if (action === "Keep Active") {
|
|
403
403
|
// Update session status to paused
|
|
@@ -475,41 +475,41 @@ if (action === "Archive & Clean") {
|
|
|
475
475
|
8. **Lifecycle Balance**: Every spawn_agent MUST have a matching close_agent (tracked in registry.json)
|
|
476
476
|
9. **Cleanup Temp Files**: Remove wave-{N}.csv after results are merged
|
|
477
477
|
10. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
---
|
|
481
|
-
|
|
482
|
-
## Coordinator Role Constraints (Main Agent)
|
|
483
|
-
|
|
484
|
-
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
485
|
-
|
|
486
|
-
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:
|
|
487
|
-
- Spawns agents with task assignments
|
|
488
|
-
- Waits for agent callbacks
|
|
489
|
-
- Merges results and coordinates workflow
|
|
490
|
-
- Manages workflow transitions between phases
|
|
491
|
-
|
|
492
|
-
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
493
|
-
- Wait patiently for `wait()` calls to complete
|
|
494
|
-
- NOT skip workflow steps due to perceived delays
|
|
495
|
-
- NOT assume agents have failed just because they're taking time
|
|
496
|
-
- Trust the timeout mechanisms defined in the skill
|
|
497
|
-
|
|
498
|
-
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
499
|
-
- Use `send_input()` to ask questions or provide clarification
|
|
500
|
-
- NOT skip the agent or move to next phase prematurely
|
|
501
|
-
- Give agents opportunity to respond before escalating
|
|
502
|
-
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
503
|
-
|
|
504
|
-
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
505
|
-
- Skip phases or stages defined in the workflow
|
|
506
|
-
- Bypass required approval or review steps
|
|
507
|
-
- Execute dependent tasks before prerequisites complete
|
|
508
|
-
- Assume task completion without explicit agent callback
|
|
509
|
-
- Make up or fabricate agent results
|
|
510
|
-
|
|
511
|
-
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
512
|
-
- Total execution time may range from 30-90 minutes or longer
|
|
513
|
-
- Each phase may take 10-30 minutes depending on complexity
|
|
514
|
-
- The coordinator must remain active and attentive throughout the entire process
|
|
515
|
-
- Do not terminate or skip steps due to time concerns
|
|
478
|
+
|
|
479
|
+
|
|
480
|
+
---
|
|
481
|
+
|
|
482
|
+
## Coordinator Role Constraints (Main Agent)
|
|
483
|
+
|
|
484
|
+
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
485
|
+
|
|
486
|
+
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:
|
|
487
|
+
- Spawns agents with task assignments
|
|
488
|
+
- Waits for agent callbacks
|
|
489
|
+
- Merges results and coordinates workflow
|
|
490
|
+
- Manages workflow transitions between phases
|
|
491
|
+
|
|
492
|
+
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
493
|
+
- Wait patiently for `wait()` calls to complete
|
|
494
|
+
- NOT skip workflow steps due to perceived delays
|
|
495
|
+
- NOT assume agents have failed just because they're taking time
|
|
496
|
+
- Trust the timeout mechanisms defined in the skill
|
|
497
|
+
|
|
498
|
+
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
499
|
+
- Use `send_input()` to ask questions or provide clarification
|
|
500
|
+
- NOT skip the agent or move to next phase prematurely
|
|
501
|
+
- Give agents opportunity to respond before escalating
|
|
502
|
+
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
503
|
+
|
|
504
|
+
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
505
|
+
- Skip phases or stages defined in the workflow
|
|
506
|
+
- Bypass required approval or review steps
|
|
507
|
+
- Execute dependent tasks before prerequisites complete
|
|
508
|
+
- Assume task completion without explicit agent callback
|
|
509
|
+
- Make up or fabricate agent results
|
|
510
|
+
|
|
511
|
+
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
512
|
+
- Total execution time may range from 30-90 minutes or longer
|
|
513
|
+
- Each phase may take 10-30 minutes depending on complexity
|
|
514
|
+
- The coordinator must remain active and attentive throughout the entire process
|
|
515
|
+
- Do not terminate or skip steps due to time concerns
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: team-frontend
|
|
3
3
|
description: Frontend development team with built-in ui-ux-pro-max design intelligence. Covers requirement analysis, design system generation, frontend implementation, and quality assurance. CSV wave pipeline with interactive QA gates.
|
|
4
4
|
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] \"frontend task description\""
|
|
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
|
|
@@ -535,13 +535,13 @@ ${deliverables.map(d => ` - ${d.name}: ${d.path}`).join('\n')}
|
|
|
535
535
|
`)
|
|
536
536
|
|
|
537
537
|
if (!AUTO_YES) {
|
|
538
|
-
|
|
538
|
+
request_user_input({
|
|
539
539
|
questions: [{
|
|
540
|
-
question: "Frontend pipeline complete.
|
|
541
|
-
header: "
|
|
542
|
-
|
|
540
|
+
question: "Frontend pipeline complete. Choose next action.",
|
|
541
|
+
header: "Done",
|
|
542
|
+
id: "completion",
|
|
543
543
|
options: [
|
|
544
|
-
{ label: "Archive
|
|
544
|
+
{ label: "Archive (Recommended)", description: "Archive session, output final summary" },
|
|
545
545
|
{ label: "Keep Active", description: "Keep session for follow-up work" },
|
|
546
546
|
{ label: "Export Results", description: "Export design tokens and component specs" }
|
|
547
547
|
]
|
|
@@ -693,7 +693,7 @@ Convergence: qa.score >= 8 && qa.critical_count === 0
|
|
|
693
693
|
| discoveries.ndjson corrupt | Ignore malformed lines, continue with valid entries |
|
|
694
694
|
| QA score < 6 over 2 GC rounds | Escalate to user for manual intervention |
|
|
695
695
|
| ui-ux-pro-max unavailable | Degrade to LLM general design knowledge |
|
|
696
|
-
| Task description too vague |
|
|
696
|
+
| Task description too vague | request_user_input for clarification in Phase 0 |
|
|
697
697
|
| Continue mode: no session found | List available sessions, prompt user to select |
|
|
698
698
|
|
|
699
699
|
---
|
|
@@ -710,41 +710,41 @@ Convergence: qa.score >= 8 && qa.critical_count === 0
|
|
|
710
710
|
8. **GC Loop Cap**: Max 2 generator-critic rounds between developer and qa
|
|
711
711
|
9. **Cleanup Temp Files**: Remove wave-{N}.csv after results are merged
|
|
712
712
|
10. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
---
|
|
716
|
-
|
|
717
|
-
## Coordinator Role Constraints (Main Agent)
|
|
718
|
-
|
|
719
|
-
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
720
|
-
|
|
721
|
-
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:
|
|
722
|
-
- Spawns agents with task assignments
|
|
723
|
-
- Waits for agent callbacks
|
|
724
|
-
- Merges results and coordinates workflow
|
|
725
|
-
- Manages workflow transitions between phases
|
|
726
|
-
|
|
727
|
-
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
728
|
-
- Wait patiently for `wait()` calls to complete
|
|
729
|
-
- NOT skip workflow steps due to perceived delays
|
|
730
|
-
- NOT assume agents have failed just because they're taking time
|
|
731
|
-
- Trust the timeout mechanisms defined in the skill
|
|
732
|
-
|
|
733
|
-
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
734
|
-
- Use `send_input()` to ask questions or provide clarification
|
|
735
|
-
- NOT skip the agent or move to next phase prematurely
|
|
736
|
-
- Give agents opportunity to respond before escalating
|
|
737
|
-
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
738
|
-
|
|
739
|
-
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
740
|
-
- Skip phases or stages defined in the workflow
|
|
741
|
-
- Bypass required approval or review steps
|
|
742
|
-
- Execute dependent tasks before prerequisites complete
|
|
743
|
-
- Assume task completion without explicit agent callback
|
|
744
|
-
- Make up or fabricate agent results
|
|
745
|
-
|
|
746
|
-
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
747
|
-
- Total execution time may range from 30-90 minutes or longer
|
|
748
|
-
- Each phase may take 10-30 minutes depending on complexity
|
|
749
|
-
- The coordinator must remain active and attentive throughout the entire process
|
|
750
|
-
- Do not terminate or skip steps due to time concerns
|
|
713
|
+
|
|
714
|
+
|
|
715
|
+
---
|
|
716
|
+
|
|
717
|
+
## Coordinator Role Constraints (Main Agent)
|
|
718
|
+
|
|
719
|
+
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
720
|
+
|
|
721
|
+
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:
|
|
722
|
+
- Spawns agents with task assignments
|
|
723
|
+
- Waits for agent callbacks
|
|
724
|
+
- Merges results and coordinates workflow
|
|
725
|
+
- Manages workflow transitions between phases
|
|
726
|
+
|
|
727
|
+
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
728
|
+
- Wait patiently for `wait()` calls to complete
|
|
729
|
+
- NOT skip workflow steps due to perceived delays
|
|
730
|
+
- NOT assume agents have failed just because they're taking time
|
|
731
|
+
- Trust the timeout mechanisms defined in the skill
|
|
732
|
+
|
|
733
|
+
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
734
|
+
- Use `send_input()` to ask questions or provide clarification
|
|
735
|
+
- NOT skip the agent or move to next phase prematurely
|
|
736
|
+
- Give agents opportunity to respond before escalating
|
|
737
|
+
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
738
|
+
|
|
739
|
+
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
740
|
+
- Skip phases or stages defined in the workflow
|
|
741
|
+
- Bypass required approval or review steps
|
|
742
|
+
- Execute dependent tasks before prerequisites complete
|
|
743
|
+
- Assume task completion without explicit agent callback
|
|
744
|
+
- Make up or fabricate agent results
|
|
745
|
+
|
|
746
|
+
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
747
|
+
- Total execution time may range from 30-90 minutes or longer
|
|
748
|
+
- Each phase may take 10-30 minutes depending on complexity
|
|
749
|
+
- The coordinator must remain active and attentive throughout the entire process
|
|
750
|
+
- Do not terminate or skip steps due to time concerns
|
|
@@ -34,7 +34,7 @@ Interactive agent for handling pipeline completion action. Presents deliverables
|
|
|
34
34
|
| Tool | Type | Purpose |
|
|
35
35
|
|------|------|---------|
|
|
36
36
|
| `Read` | built-in | Load task results and artifacts |
|
|
37
|
-
| `
|
|
37
|
+
| `request_user_input` | built-in | Get user completion choice |
|
|
38
38
|
| `Write` | built-in | Store completion result |
|
|
39
39
|
| `Bash` | built-in | Execute archive/export operations |
|
|
40
40
|
|
|
@@ -74,11 +74,11 @@ Interactive agent for handling pipeline completion action. Presents deliverables
|
|
|
74
74
|
2. Present completion choice:
|
|
75
75
|
|
|
76
76
|
```javascript
|
|
77
|
-
|
|
77
|
+
request_user_input({
|
|
78
78
|
questions: [{
|
|
79
79
|
question: "Frontend pipeline complete. What would you like to do?",
|
|
80
80
|
header: "Completion",
|
|
81
|
-
|
|
81
|
+
id: "completion_action",
|
|
82
82
|
options: [
|
|
83
83
|
{ label: "Archive & Clean (Recommended)", description: "Archive session, output final summary" },
|
|
84
84
|
{ label: "Keep Active", description: "Keep session for follow-up work" },
|
|
@@ -36,7 +36,7 @@ Interactive agent for reviewing QA audit verdicts and handling the Generator-Cri
|
|
|
36
36
|
| Tool | Type | Purpose |
|
|
37
37
|
|------|------|---------|
|
|
38
38
|
| `Read` | built-in | Load QA audit reports and context |
|
|
39
|
-
| `
|
|
39
|
+
| `request_user_input` | built-in | Get user decision on QA gate |
|
|
40
40
|
| `Write` | built-in | Store review result |
|
|
41
41
|
|
|
42
42
|
### Tool Usage Patterns
|
|
@@ -97,13 +97,13 @@ Write("<session>/interactive/<task-id>-result.json", <result>)
|
|
|
97
97
|
2. If escalation needed, present choice:
|
|
98
98
|
|
|
99
99
|
```javascript
|
|
100
|
-
|
|
100
|
+
request_user_input({
|
|
101
101
|
questions: [{
|
|
102
102
|
question: "QA has flagged issues after 2 fix rounds. How would you like to proceed?",
|
|
103
103
|
header: "QA Gate",
|
|
104
|
-
|
|
104
|
+
id: "qa_gate_decision",
|
|
105
105
|
options: [
|
|
106
|
-
{ label: "Accept current state", description: "Proceed despite remaining issues" },
|
|
106
|
+
{ label: "Accept current state (Recommended)", description: "Proceed despite remaining issues" },
|
|
107
107
|
{ label: "Manual fix", description: "You will fix the issues manually" },
|
|
108
108
|
{ label: "Abort pipeline", description: "Stop the pipeline" }
|
|
109
109
|
]
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: team-frontend-debug
|
|
3
3
|
description: Frontend debugging team using Chrome DevTools MCP. Dual-mode -- feature-list testing or bug-report debugging. Covers reproduction, root cause analysis, code fixes, and verification. CSV wave pipeline with conditional skip and iteration loops.
|
|
4
4
|
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] \"feature list or bug description\""
|
|
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
|
|
@@ -98,7 +98,7 @@ Dual-mode frontend debugging: feature-list testing or bug-report debugging, powe
|
|
|
98
98
|
| feature, test, list, check, verify functions, validate | `test-pipeline` |
|
|
99
99
|
| bug, error, crash, broken, white screen, not working | `debug-pipeline` |
|
|
100
100
|
| performance, slow, latency, memory leak | `debug-pipeline` (perf dimension) |
|
|
101
|
-
| Ambiguous / unclear |
|
|
101
|
+
| Ambiguous / unclear | request_user_input to clarify |
|
|
102
102
|
|
|
103
103
|
---
|
|
104
104
|
|
|
@@ -305,19 +305,19 @@ Write(`${sessionFolder}/wisdom/learnings.md`, '# Debug Learnings\n')
|
|
|
305
305
|
|---------------|------|
|
|
306
306
|
| Contains: feature, test, list, check, verify | `test-pipeline` |
|
|
307
307
|
| Contains: bug, error, crash, broken, not working | `debug-pipeline` |
|
|
308
|
-
| Ambiguous |
|
|
308
|
+
| Ambiguous | request_user_input to clarify |
|
|
309
309
|
|
|
310
310
|
4. **Extract parameters by mode**:
|
|
311
311
|
|
|
312
312
|
**Test Mode**:
|
|
313
|
-
- `base_url`: URL in text or
|
|
313
|
+
- `base_url`: URL in text or request_user_input
|
|
314
314
|
- `features`: Parse feature list (bullet points, numbered list, free text)
|
|
315
315
|
- Generate structured feature items with id, name, url
|
|
316
316
|
|
|
317
317
|
**Debug Mode**:
|
|
318
318
|
- `bug_description`: Bug description text
|
|
319
|
-
- `target_url`: URL in text or
|
|
320
|
-
- `reproduction_steps`: Steps in text or
|
|
319
|
+
- `target_url`: URL in text or request_user_input
|
|
320
|
+
- `reproduction_steps`: Steps in text or request_user_input
|
|
321
321
|
- `evidence_plan`: Detect dimensions from keywords (UI, network, console, performance)
|
|
322
322
|
|
|
323
323
|
5. **Dimension Detection** (debug mode):
|
|
@@ -616,13 +616,13 @@ ${completed.map(t => ` [DONE] ${t.id} (${t.role}): ${t.findings?.substring(0, 8
|
|
|
616
616
|
`)
|
|
617
617
|
|
|
618
618
|
if (!AUTO_YES) {
|
|
619
|
-
|
|
619
|
+
request_user_input({
|
|
620
620
|
questions: [{
|
|
621
|
-
question: "Debug pipeline complete.
|
|
622
|
-
header: "
|
|
623
|
-
|
|
621
|
+
question: "Debug pipeline complete. Choose next action.",
|
|
622
|
+
header: "Done",
|
|
623
|
+
id: "completion",
|
|
624
624
|
options: [
|
|
625
|
-
{ label: "Archive
|
|
625
|
+
{ label: "Archive (Recommended)", description: "Archive session, output final summary" },
|
|
626
626
|
{ label: "Keep Active", description: "Keep session for follow-up debugging" },
|
|
627
627
|
{ label: "Export Results", description: "Export debug report and patches" }
|
|
628
628
|
]
|
|
@@ -732,7 +732,7 @@ After TEST-001 completes, evaluate issues:
|
|
|
732
732
|
| Condition | Action |
|
|
733
733
|
|-----------|--------|
|
|
734
734
|
| `issues_count === 0` | Skip ANALYZE/FIX/VERIFY. Pipeline complete with all-pass. |
|
|
735
|
-
| Only low-severity warnings |
|
|
735
|
+
| Only low-severity warnings | request_user_input: fix warnings or complete |
|
|
736
736
|
| High/medium severity issues | Proceed with ANALYZE -> FIX -> VERIFY |
|
|
737
737
|
|
|
738
738
|
---
|
|
@@ -781,41 +781,41 @@ After TEST-001 completes, evaluate issues:
|
|
|
781
781
|
9. **Iteration Bounds**: Max 2 reproduction rounds, max 3 fix rounds
|
|
782
782
|
10. **Cleanup Temp Files**: Remove wave-{N}.csv after results are merged
|
|
783
783
|
11. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
---
|
|
787
|
-
|
|
788
|
-
## Coordinator Role Constraints (Main Agent)
|
|
789
|
-
|
|
790
|
-
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
791
|
-
|
|
792
|
-
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:
|
|
793
|
-
- Spawns agents with task assignments
|
|
794
|
-
- Waits for agent callbacks
|
|
795
|
-
- Merges results and coordinates workflow
|
|
796
|
-
- Manages workflow transitions between phases
|
|
797
|
-
|
|
798
|
-
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
799
|
-
- Wait patiently for `wait()` calls to complete
|
|
800
|
-
- NOT skip workflow steps due to perceived delays
|
|
801
|
-
- NOT assume agents have failed just because they're taking time
|
|
802
|
-
- Trust the timeout mechanisms defined in the skill
|
|
803
|
-
|
|
804
|
-
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
805
|
-
- Use `send_input()` to ask questions or provide clarification
|
|
806
|
-
- NOT skip the agent or move to next phase prematurely
|
|
807
|
-
- Give agents opportunity to respond before escalating
|
|
808
|
-
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
809
|
-
|
|
810
|
-
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
811
|
-
- Skip phases or stages defined in the workflow
|
|
812
|
-
- Bypass required approval or review steps
|
|
813
|
-
- Execute dependent tasks before prerequisites complete
|
|
814
|
-
- Assume task completion without explicit agent callback
|
|
815
|
-
- Make up or fabricate agent results
|
|
816
|
-
|
|
817
|
-
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
818
|
-
- Total execution time may range from 30-90 minutes or longer
|
|
819
|
-
- Each phase may take 10-30 minutes depending on complexity
|
|
820
|
-
- The coordinator must remain active and attentive throughout the entire process
|
|
821
|
-
- Do not terminate or skip steps due to time concerns
|
|
784
|
+
|
|
785
|
+
|
|
786
|
+
---
|
|
787
|
+
|
|
788
|
+
## Coordinator Role Constraints (Main Agent)
|
|
789
|
+
|
|
790
|
+
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
791
|
+
|
|
792
|
+
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:
|
|
793
|
+
- Spawns agents with task assignments
|
|
794
|
+
- Waits for agent callbacks
|
|
795
|
+
- Merges results and coordinates workflow
|
|
796
|
+
- Manages workflow transitions between phases
|
|
797
|
+
|
|
798
|
+
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
799
|
+
- Wait patiently for `wait()` calls to complete
|
|
800
|
+
- NOT skip workflow steps due to perceived delays
|
|
801
|
+
- NOT assume agents have failed just because they're taking time
|
|
802
|
+
- Trust the timeout mechanisms defined in the skill
|
|
803
|
+
|
|
804
|
+
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
805
|
+
- Use `send_input()` to ask questions or provide clarification
|
|
806
|
+
- NOT skip the agent or move to next phase prematurely
|
|
807
|
+
- Give agents opportunity to respond before escalating
|
|
808
|
+
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
809
|
+
|
|
810
|
+
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
811
|
+
- Skip phases or stages defined in the workflow
|
|
812
|
+
- Bypass required approval or review steps
|
|
813
|
+
- Execute dependent tasks before prerequisites complete
|
|
814
|
+
- Assume task completion without explicit agent callback
|
|
815
|
+
- Make up or fabricate agent results
|
|
816
|
+
|
|
817
|
+
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
818
|
+
- Total execution time may range from 30-90 minutes or longer
|
|
819
|
+
- Each phase may take 10-30 minutes depending on complexity
|
|
820
|
+
- The coordinator must remain active and attentive throughout the entire process
|
|
821
|
+
- Do not terminate or skip steps due to time concerns
|
|
@@ -34,7 +34,7 @@ Interactive agent for handling pipeline completion action. Presents debug summar
|
|
|
34
34
|
| Tool | Type | Purpose |
|
|
35
35
|
|------|------|---------|
|
|
36
36
|
| `Read` | built-in | Load task results and artifacts |
|
|
37
|
-
| `
|
|
37
|
+
| `request_user_input` | built-in | Get user completion choice |
|
|
38
38
|
| `Write` | built-in | Store completion result |
|
|
39
39
|
| `Bash` | built-in | Execute archive/export operations |
|
|
40
40
|
|
|
@@ -79,11 +79,11 @@ Interactive agent for handling pipeline completion action. Presents debug summar
|
|
|
79
79
|
2. Present completion choice:
|
|
80
80
|
|
|
81
81
|
```javascript
|
|
82
|
-
|
|
82
|
+
request_user_input({
|
|
83
83
|
questions: [{
|
|
84
84
|
question: "Debug pipeline complete. What would you like to do?",
|
|
85
85
|
header: "Completion",
|
|
86
|
-
|
|
86
|
+
id: "completion_action",
|
|
87
87
|
options: [
|
|
88
88
|
{ label: "Archive & Clean (Recommended)", description: "Archive session, output final summary" },
|
|
89
89
|
{ label: "Keep Active", description: "Keep session for follow-up debugging" },
|
|
@@ -35,7 +35,7 @@ Interactive agent for evaluating TEST-001 results and determining whether to ski
|
|
|
35
35
|
| Tool | Type | Purpose |
|
|
36
36
|
|------|------|---------|
|
|
37
37
|
| `Read` | built-in | Load test results and issues |
|
|
38
|
-
| `
|
|
38
|
+
| `request_user_input` | built-in | Get user decision on warnings |
|
|
39
39
|
| `Write` | built-in | Store gate decision result |
|
|
40
40
|
|
|
41
41
|
---
|
|
@@ -81,13 +81,13 @@ Interactive agent for evaluating TEST-001 results and determining whether to ski
|
|
|
81
81
|
2. If only warnings, present choice:
|
|
82
82
|
|
|
83
83
|
```javascript
|
|
84
|
-
|
|
84
|
+
request_user_input({
|
|
85
85
|
questions: [{
|
|
86
86
|
question: "Testing found only low-severity warnings. How would you like to proceed?",
|
|
87
87
|
header: "Test Results",
|
|
88
|
-
|
|
88
|
+
id: "warning_decision",
|
|
89
89
|
options: [
|
|
90
|
-
{ label: "Fix warnings", description: "Proceed with analysis and fixes for warnings" },
|
|
90
|
+
{ label: "Fix warnings (Recommended)", description: "Proceed with analysis and fixes for warnings" },
|
|
91
91
|
{ label: "Complete", description: "Accept current state, skip remaining tasks" }
|
|
92
92
|
]
|
|
93
93
|
}]
|