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
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: team-quality-assurance
|
|
3
3
|
description: Full closed-loop QA combining issue discovery and software testing. Scout -> Strategist -> Generator -> Executor -> Analyst with multi-perspective scanning, progressive test layers, GC loops, and quality scoring. Supports discovery, testing, and full QA modes.
|
|
4
4
|
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] [--mode=discovery|testing|full] \"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
|
|
@@ -286,16 +286,15 @@ Write(`${sessionFolder}/gc-state.json`, JSON.stringify({
|
|
|
286
286
|
|
|
287
287
|
4. **Clarify if ambiguous** (skip if AUTO_YES):
|
|
288
288
|
```javascript
|
|
289
|
-
|
|
289
|
+
request_user_input({
|
|
290
290
|
questions: [{
|
|
291
|
-
question:
|
|
292
|
-
header: "QA Mode
|
|
293
|
-
|
|
291
|
+
question: `Detected QA mode: '${qaMode}'. Approve or override?`,
|
|
292
|
+
header: "QA Mode",
|
|
293
|
+
id: "qa_mode",
|
|
294
294
|
options: [
|
|
295
|
-
{ label: "
|
|
296
|
-
{ label: "
|
|
297
|
-
{ label: "
|
|
298
|
-
{ label: "Use full", description: "Complete QA closed loop with regression" }
|
|
295
|
+
{ label: "Approve (Recommended)", description: `Use ${qaMode} mode as detected` },
|
|
296
|
+
{ label: "Discovery", description: "Scout-first: scan for issues, then test" },
|
|
297
|
+
{ label: "Testing/Full", description: "Direct testing or complete QA closed loop" }
|
|
299
298
|
]
|
|
300
299
|
}]
|
|
301
300
|
})
|
|
@@ -536,13 +535,13 @@ Session: ${sessionFolder}
|
|
|
536
535
|
`)
|
|
537
536
|
|
|
538
537
|
if (!AUTO_YES) {
|
|
539
|
-
|
|
538
|
+
request_user_input({
|
|
540
539
|
questions: [{
|
|
541
|
-
question: "Quality Assurance pipeline complete.
|
|
542
|
-
header: "
|
|
543
|
-
|
|
540
|
+
question: "Quality Assurance pipeline complete. Choose next action.",
|
|
541
|
+
header: "Done",
|
|
542
|
+
id: "completion",
|
|
544
543
|
options: [
|
|
545
|
-
{ label: "Archive
|
|
544
|
+
{ label: "Archive (Recommended)", description: "Archive session, output final summary" },
|
|
546
545
|
{ label: "Keep Active", description: "Keep session for follow-up work" },
|
|
547
546
|
{ label: "Export Results", description: "Export deliverables to target directory" }
|
|
548
547
|
]
|
|
@@ -774,41 +773,41 @@ QAGEN -> QARUN -> (if coverage < target) -> GC Loop Handler
|
|
|
774
773
|
9. **Scout Feeds Strategy**: Scout findings flow into strategist via prev_context and discoveries.ndjson
|
|
775
774
|
10. **Cleanup Temp Files**: Remove wave-{N}.csv after results are merged
|
|
776
775
|
11. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
---
|
|
780
|
-
|
|
781
|
-
## Coordinator Role Constraints (Main Agent)
|
|
782
|
-
|
|
783
|
-
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
784
|
-
|
|
785
|
-
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:
|
|
786
|
-
- Spawns agents with task assignments
|
|
787
|
-
- Waits for agent callbacks
|
|
788
|
-
- Merges results and coordinates workflow
|
|
789
|
-
- Manages workflow transitions between phases
|
|
790
|
-
|
|
791
|
-
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
792
|
-
- Wait patiently for `wait()` calls to complete
|
|
793
|
-
- NOT skip workflow steps due to perceived delays
|
|
794
|
-
- NOT assume agents have failed just because they're taking time
|
|
795
|
-
- Trust the timeout mechanisms defined in the skill
|
|
796
|
-
|
|
797
|
-
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
798
|
-
- Use `send_input()` to ask questions or provide clarification
|
|
799
|
-
- NOT skip the agent or move to next phase prematurely
|
|
800
|
-
- Give agents opportunity to respond before escalating
|
|
801
|
-
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
802
|
-
|
|
803
|
-
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
804
|
-
- Skip phases or stages defined in the workflow
|
|
805
|
-
- Bypass required approval or review steps
|
|
806
|
-
- Execute dependent tasks before prerequisites complete
|
|
807
|
-
- Assume task completion without explicit agent callback
|
|
808
|
-
- Make up or fabricate agent results
|
|
809
|
-
|
|
810
|
-
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
811
|
-
- Total execution time may range from 30-90 minutes or longer
|
|
812
|
-
- Each phase may take 10-30 minutes depending on complexity
|
|
813
|
-
- The coordinator must remain active and attentive throughout the entire process
|
|
814
|
-
- Do not terminate or skip steps due to time concerns
|
|
776
|
+
|
|
777
|
+
|
|
778
|
+
---
|
|
779
|
+
|
|
780
|
+
## Coordinator Role Constraints (Main Agent)
|
|
781
|
+
|
|
782
|
+
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
783
|
+
|
|
784
|
+
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:
|
|
785
|
+
- Spawns agents with task assignments
|
|
786
|
+
- Waits for agent callbacks
|
|
787
|
+
- Merges results and coordinates workflow
|
|
788
|
+
- Manages workflow transitions between phases
|
|
789
|
+
|
|
790
|
+
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
791
|
+
- Wait patiently for `wait()` calls to complete
|
|
792
|
+
- NOT skip workflow steps due to perceived delays
|
|
793
|
+
- NOT assume agents have failed just because they're taking time
|
|
794
|
+
- Trust the timeout mechanisms defined in the skill
|
|
795
|
+
|
|
796
|
+
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
797
|
+
- Use `send_input()` to ask questions or provide clarification
|
|
798
|
+
- NOT skip the agent or move to next phase prematurely
|
|
799
|
+
- Give agents opportunity to respond before escalating
|
|
800
|
+
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
801
|
+
|
|
802
|
+
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
803
|
+
- Skip phases or stages defined in the workflow
|
|
804
|
+
- Bypass required approval or review steps
|
|
805
|
+
- Execute dependent tasks before prerequisites complete
|
|
806
|
+
- Assume task completion without explicit agent callback
|
|
807
|
+
- Make up or fabricate agent results
|
|
808
|
+
|
|
809
|
+
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
810
|
+
- Total execution time may range from 30-90 minutes or longer
|
|
811
|
+
- Each phase may take 10-30 minutes depending on complexity
|
|
812
|
+
- The coordinator must remain active and attentive throughout the entire process
|
|
813
|
+
- Do not terminate or skip steps due to time concerns
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: team-review
|
|
3
3
|
description: Multi-agent code review pipeline with scanner, reviewer, and fixer roles. Executes toolchain + LLM scan, deep analysis with root cause enrichment, and automated fixes with rollback-on-failure.
|
|
4
4
|
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] [--full|--fix|-q] [--dimensions=sec,cor,prf,mnt] \"target path or pattern\""
|
|
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
|
|
@@ -476,7 +476,7 @@ send_input({
|
|
|
476
476
|
| discoveries.ndjson corrupt | Ignore malformed lines, continue with valid entries |
|
|
477
477
|
| Lifecycle leak | Cleanup all active agents via registry.json at end |
|
|
478
478
|
| Continue mode: no session found | List available sessions, prompt user to select |
|
|
479
|
-
| Target path invalid |
|
|
479
|
+
| Target path invalid | request_user_input for corrected path |
|
|
480
480
|
| Scanner finds 0 findings | Report clean, skip review + fix stages |
|
|
481
481
|
|
|
482
482
|
---
|
|
@@ -493,41 +493,41 @@ send_input({
|
|
|
493
493
|
8. **Lifecycle Balance**: Every spawn_agent MUST have a matching close_agent (tracked in registry.json)
|
|
494
494
|
9. **Cleanup Temp Files**: Remove wave-{N}.csv after results are merged
|
|
495
495
|
10. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
---
|
|
499
|
-
|
|
500
|
-
## Coordinator Role Constraints (Main Agent)
|
|
501
|
-
|
|
502
|
-
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
503
|
-
|
|
504
|
-
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:
|
|
505
|
-
- Spawns agents with task assignments
|
|
506
|
-
- Waits for agent callbacks
|
|
507
|
-
- Merges results and coordinates workflow
|
|
508
|
-
- Manages workflow transitions between phases
|
|
509
|
-
|
|
510
|
-
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
511
|
-
- Wait patiently for `wait()` calls to complete
|
|
512
|
-
- NOT skip workflow steps due to perceived delays
|
|
513
|
-
- NOT assume agents have failed just because they're taking time
|
|
514
|
-
- Trust the timeout mechanisms defined in the skill
|
|
515
|
-
|
|
516
|
-
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
517
|
-
- Use `send_input()` to ask questions or provide clarification
|
|
518
|
-
- NOT skip the agent or move to next phase prematurely
|
|
519
|
-
- Give agents opportunity to respond before escalating
|
|
520
|
-
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
521
|
-
|
|
522
|
-
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
523
|
-
- Skip phases or stages defined in the workflow
|
|
524
|
-
- Bypass required approval or review steps
|
|
525
|
-
- Execute dependent tasks before prerequisites complete
|
|
526
|
-
- Assume task completion without explicit agent callback
|
|
527
|
-
- Make up or fabricate agent results
|
|
528
|
-
|
|
529
|
-
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
530
|
-
- Total execution time may range from 30-90 minutes or longer
|
|
531
|
-
- Each phase may take 10-30 minutes depending on complexity
|
|
532
|
-
- The coordinator must remain active and attentive throughout the entire process
|
|
533
|
-
- Do not terminate or skip steps due to time concerns
|
|
496
|
+
|
|
497
|
+
|
|
498
|
+
---
|
|
499
|
+
|
|
500
|
+
## Coordinator Role Constraints (Main Agent)
|
|
501
|
+
|
|
502
|
+
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
503
|
+
|
|
504
|
+
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:
|
|
505
|
+
- Spawns agents with task assignments
|
|
506
|
+
- Waits for agent callbacks
|
|
507
|
+
- Merges results and coordinates workflow
|
|
508
|
+
- Manages workflow transitions between phases
|
|
509
|
+
|
|
510
|
+
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
511
|
+
- Wait patiently for `wait()` calls to complete
|
|
512
|
+
- NOT skip workflow steps due to perceived delays
|
|
513
|
+
- NOT assume agents have failed just because they're taking time
|
|
514
|
+
- Trust the timeout mechanisms defined in the skill
|
|
515
|
+
|
|
516
|
+
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
517
|
+
- Use `send_input()` to ask questions or provide clarification
|
|
518
|
+
- NOT skip the agent or move to next phase prematurely
|
|
519
|
+
- Give agents opportunity to respond before escalating
|
|
520
|
+
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
521
|
+
|
|
522
|
+
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
523
|
+
- Skip phases or stages defined in the workflow
|
|
524
|
+
- Bypass required approval or review steps
|
|
525
|
+
- Execute dependent tasks before prerequisites complete
|
|
526
|
+
- Assume task completion without explicit agent callback
|
|
527
|
+
- Make up or fabricate agent results
|
|
528
|
+
|
|
529
|
+
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
530
|
+
- Total execution time may range from 30-90 minutes or longer
|
|
531
|
+
- Each phase may take 10-30 minutes depending on complexity
|
|
532
|
+
- The coordinator must remain active and attentive throughout the entire process
|
|
533
|
+
- Do not terminate or skip steps due to time concerns
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: team-roadmap-dev
|
|
3
3
|
description: Roadmap-driven development with phased execution pipeline. Coordinator discusses roadmap with user, then executes plan->execute->verify cycles per phase using CSV wave execution.
|
|
4
4
|
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] \"<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
|
|
@@ -244,7 +244,7 @@ const discusser = spawn_agent({
|
|
|
244
244
|
|
|
245
245
|
**Instructions**:
|
|
246
246
|
1. Analyze task description to understand scope
|
|
247
|
-
2. Propose phase breakdown to user via
|
|
247
|
+
2. Propose phase breakdown to user via request_user_input
|
|
248
248
|
3. For each phase, clarify requirements and success criteria
|
|
249
249
|
4. Generate roadmap.md with structured phase definitions
|
|
250
250
|
5. Output result as JSON with roadmap_path and phase_count`
|
|
@@ -343,19 +343,19 @@ writeMasterCSV(`${sessionDir}/tasks.csv`, tasksWithWaves)
|
|
|
343
343
|
|
|
344
344
|
// User validation (skip if autoYes)
|
|
345
345
|
if (!autoYes) {
|
|
346
|
-
const approval =
|
|
346
|
+
const approval = request_user_input({
|
|
347
347
|
questions: [{
|
|
348
348
|
question: `Generated ${tasksWithWaves.length} tasks across ${phases.length} phases. Proceed?`,
|
|
349
|
-
header: "
|
|
350
|
-
|
|
349
|
+
header: "Validate",
|
|
350
|
+
id: "task_approval",
|
|
351
351
|
options: [
|
|
352
|
-
{ label: "Proceed", description: "Start execution" },
|
|
352
|
+
{ label: "Proceed (Recommended)", description: "Start execution" },
|
|
353
353
|
{ label: "Cancel", description: "Abort workflow" }
|
|
354
354
|
]
|
|
355
355
|
}]
|
|
356
356
|
})
|
|
357
357
|
|
|
358
|
-
if (approval.answers[0] !== "Proceed") {
|
|
358
|
+
if (approval.answers.task_approval.answers[0] !== "Proceed (Recommended)") {
|
|
359
359
|
throw new Error("User cancelled workflow")
|
|
360
360
|
}
|
|
361
361
|
}
|
|
@@ -554,20 +554,20 @@ console.log(`\nResults: ${sessionDir}/results.csv`)
|
|
|
554
554
|
console.log(`Report: ${sessionDir}/context.md`)
|
|
555
555
|
|
|
556
556
|
// Offer next steps
|
|
557
|
-
const nextStep =
|
|
557
|
+
const nextStep = request_user_input({
|
|
558
558
|
questions: [{
|
|
559
|
-
question: "Roadmap Dev pipeline complete.
|
|
560
|
-
header: "
|
|
561
|
-
|
|
559
|
+
question: "Roadmap Dev pipeline complete. Choose next action.",
|
|
560
|
+
header: "Done",
|
|
561
|
+
id: "completion",
|
|
562
562
|
options: [
|
|
563
|
-
{ label: "Archive
|
|
563
|
+
{ label: "Archive (Recommended)", description: "Archive session, clean up tasks and team resources" },
|
|
564
564
|
{ label: "Keep Active", description: "Keep session active for follow-up work or inspection" },
|
|
565
565
|
{ label: "Export Results", description: "Export deliverables to a specified location, then clean" }
|
|
566
566
|
]
|
|
567
567
|
}]
|
|
568
568
|
})
|
|
569
569
|
|
|
570
|
-
if (nextStep.answers[0] === "Archive
|
|
570
|
+
if (nextStep.answers.completion.answers[0] === "Archive (Recommended)") {
|
|
571
571
|
Bash(`tar -czf "${sessionDir}.tar.gz" "${sessionDir}" && rm -rf "${sessionDir}"`)
|
|
572
572
|
console.log(`Session archived to ${sessionDir}.tar.gz`)
|
|
573
573
|
}
|
|
@@ -643,41 +643,41 @@ const discoveries = Read(`${sessionDir}/discoveries.ndjson`)
|
|
|
643
643
|
8. **Lifecycle Balance**: Every spawn_agent MUST have a matching close_agent (tracked in registry.json)
|
|
644
644
|
9. **Cleanup Temp Files**: Remove wave-{N}.csv after results are merged
|
|
645
645
|
10. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
---
|
|
649
|
-
|
|
650
|
-
## Coordinator Role Constraints (Main Agent)
|
|
651
|
-
|
|
652
|
-
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
653
|
-
|
|
654
|
-
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:
|
|
655
|
-
- Spawns agents with task assignments
|
|
656
|
-
- Waits for agent callbacks
|
|
657
|
-
- Merges results and coordinates workflow
|
|
658
|
-
- Manages workflow transitions between phases
|
|
659
|
-
|
|
660
|
-
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
661
|
-
- Wait patiently for `wait()` calls to complete
|
|
662
|
-
- NOT skip workflow steps due to perceived delays
|
|
663
|
-
- NOT assume agents have failed just because they're taking time
|
|
664
|
-
- Trust the timeout mechanisms defined in the skill
|
|
665
|
-
|
|
666
|
-
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
667
|
-
- Use `send_input()` to ask questions or provide clarification
|
|
668
|
-
- NOT skip the agent or move to next phase prematurely
|
|
669
|
-
- Give agents opportunity to respond before escalating
|
|
670
|
-
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
671
|
-
|
|
672
|
-
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
673
|
-
- Skip phases or stages defined in the workflow
|
|
674
|
-
- Bypass required approval or review steps
|
|
675
|
-
- Execute dependent tasks before prerequisites complete
|
|
676
|
-
- Assume task completion without explicit agent callback
|
|
677
|
-
- Make up or fabricate agent results
|
|
678
|
-
|
|
679
|
-
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
680
|
-
- Total execution time may range from 30-90 minutes or longer
|
|
681
|
-
- Each phase may take 10-30 minutes depending on complexity
|
|
682
|
-
- The coordinator must remain active and attentive throughout the entire process
|
|
683
|
-
- Do not terminate or skip steps due to time concerns
|
|
646
|
+
|
|
647
|
+
|
|
648
|
+
---
|
|
649
|
+
|
|
650
|
+
## Coordinator Role Constraints (Main Agent)
|
|
651
|
+
|
|
652
|
+
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
653
|
+
|
|
654
|
+
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:
|
|
655
|
+
- Spawns agents with task assignments
|
|
656
|
+
- Waits for agent callbacks
|
|
657
|
+
- Merges results and coordinates workflow
|
|
658
|
+
- Manages workflow transitions between phases
|
|
659
|
+
|
|
660
|
+
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
661
|
+
- Wait patiently for `wait()` calls to complete
|
|
662
|
+
- NOT skip workflow steps due to perceived delays
|
|
663
|
+
- NOT assume agents have failed just because they're taking time
|
|
664
|
+
- Trust the timeout mechanisms defined in the skill
|
|
665
|
+
|
|
666
|
+
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
667
|
+
- Use `send_input()` to ask questions or provide clarification
|
|
668
|
+
- NOT skip the agent or move to next phase prematurely
|
|
669
|
+
- Give agents opportunity to respond before escalating
|
|
670
|
+
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
671
|
+
|
|
672
|
+
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
673
|
+
- Skip phases or stages defined in the workflow
|
|
674
|
+
- Bypass required approval or review steps
|
|
675
|
+
- Execute dependent tasks before prerequisites complete
|
|
676
|
+
- Assume task completion without explicit agent callback
|
|
677
|
+
- Make up or fabricate agent results
|
|
678
|
+
|
|
679
|
+
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
680
|
+
- Total execution time may range from 30-90 minutes or longer
|
|
681
|
+
- Each phase may take 10-30 minutes depending on complexity
|
|
682
|
+
- The coordinator must remain active and attentive throughout the entire process
|
|
683
|
+
- Do not terminate or skip steps due to time concerns
|
|
@@ -14,7 +14,7 @@ Interactive agent for discussing roadmap with user and generating phase plan wit
|
|
|
14
14
|
|
|
15
15
|
- Load role definition via MANDATORY FIRST STEPS pattern
|
|
16
16
|
- Produce structured output following template
|
|
17
|
-
- Interact with user via
|
|
17
|
+
- Interact with user via request_user_input
|
|
18
18
|
- Generate roadmap.md with phase definitions
|
|
19
19
|
- Include requirements (REQ-IDs) and success criteria per phase
|
|
20
20
|
|
|
@@ -33,7 +33,7 @@ Interactive agent for discussing roadmap with user and generating phase plan wit
|
|
|
33
33
|
|
|
34
34
|
| Tool | Type | Purpose |
|
|
35
35
|
|------|------|---------|
|
|
36
|
-
| `
|
|
36
|
+
| `request_user_input` | Human interaction | Clarify requirements, propose phase breakdown |
|
|
37
37
|
| `Read` | File I/O | Load project context |
|
|
38
38
|
| `Write` | File I/O | Generate roadmap.md |
|
|
39
39
|
|
|
@@ -81,15 +81,15 @@ Interactive agent for discussing roadmap with user and generating phase plan wit
|
|
|
81
81
|
- Phase goal (one sentence)
|
|
82
82
|
- Key requirements (REQ-IDs)
|
|
83
83
|
- Success criteria (measurable)
|
|
84
|
-
4. Present to user via
|
|
84
|
+
4. Present to user via request_user_input:
|
|
85
85
|
```javascript
|
|
86
|
-
|
|
86
|
+
request_user_input({
|
|
87
87
|
questions: [{
|
|
88
88
|
question: "Proposed phase breakdown:\n\nPhase 1: [goal]\n- REQ-001: [requirement]\n- Success: [criteria]\n\nPhase 2: [goal]\n...\n\nApprove or request changes?",
|
|
89
|
-
header: "Roadmap
|
|
90
|
-
|
|
89
|
+
header: "Roadmap",
|
|
90
|
+
id: "roadmap_approval",
|
|
91
91
|
options: [
|
|
92
|
-
{ label: "Approve", description: "Proceed with this breakdown" },
|
|
92
|
+
{ label: "Approve (Recommended)", description: "Proceed with this breakdown" },
|
|
93
93
|
{ label: "Modify", description: "Request changes to phases" },
|
|
94
94
|
{ label: "Cancel", description: "Abort workflow" }
|
|
95
95
|
]
|
|
@@ -173,4 +173,4 @@ Interactive agent for discussing roadmap with user and generating phase plan wit
|
|
|
173
173
|
| User cancels | Output partial roadmap, mark as cancelled |
|
|
174
174
|
| Project context not found | Continue without project context, note in findings |
|
|
175
175
|
| User requests too many phases (>10) | Warn about complexity, suggest consolidation |
|
|
176
|
-
| Ambiguous requirements | Ask clarifying questions via
|
|
176
|
+
| Ambiguous requirements | Ask clarifying questions via request_user_input |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: team-tech-debt
|
|
3
3
|
description: Systematic tech debt governance with CSV wave pipeline. Scans codebase for tech debt across 5 dimensions, assesses severity with priority matrix, plans phased remediation, executes fixes in worktree, validates with 4-layer checks. Supports scan/remediate/targeted pipeline modes with fix-verify GC loop.
|
|
4
4
|
argument-hint: "[-y|--yes] [-c|--concurrency N] [--continue] [--mode=scan|remediate|targeted] \"scope or 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
|
|
@@ -259,13 +259,13 @@ Write(`${sessionFolder}/wisdom/decisions.md`, '# Decisions\n')
|
|
|
259
259
|
|
|
260
260
|
2. **Clarify scope** (skip if AUTO_YES):
|
|
261
261
|
```javascript
|
|
262
|
-
|
|
262
|
+
request_user_input({
|
|
263
263
|
questions: [{
|
|
264
|
-
question: "
|
|
265
|
-
header: "Scope
|
|
266
|
-
|
|
264
|
+
question: "Select tech debt governance scope.",
|
|
265
|
+
header: "Scope",
|
|
266
|
+
id: "debt_scope",
|
|
267
267
|
options: [
|
|
268
|
-
{ label: "Full
|
|
268
|
+
{ label: "Full scan (Recommended)", description: "Scan entire codebase" },
|
|
269
269
|
{ label: "Specific module", description: "Target specific directory" },
|
|
270
270
|
{ label: "Custom scope", description: "Specify file patterns" }
|
|
271
271
|
]
|
|
@@ -517,15 +517,15 @@ Session: ${sessionFolder}
|
|
|
517
517
|
|
|
518
518
|
// Completion action
|
|
519
519
|
if (!AUTO_YES) {
|
|
520
|
-
|
|
520
|
+
request_user_input({
|
|
521
521
|
questions: [{
|
|
522
|
-
question: "
|
|
523
|
-
header: "
|
|
524
|
-
|
|
522
|
+
question: "Tech debt governance complete. Choose next action.",
|
|
523
|
+
header: "Done",
|
|
524
|
+
id: "completion",
|
|
525
525
|
options: [
|
|
526
|
+
{ label: "Close (Recommended)", description: "Archive session" },
|
|
526
527
|
{ label: "New target", description: "Run another scan/fix cycle" },
|
|
527
|
-
{ label: "Deep fix", description: "Continue fixing remaining items" }
|
|
528
|
-
{ label: "Close", description: "Archive session" }
|
|
528
|
+
{ label: "Deep fix", description: "Continue fixing remaining items" }
|
|
529
529
|
]
|
|
530
530
|
}]
|
|
531
531
|
})
|
|
@@ -668,41 +668,41 @@ Wave 3: TDVAL-001 (validator) -> 4-layer validation
|
|
|
668
668
|
8. **GC Loop Bounded**: Maximum 3 fix-verify rounds before accepting current state
|
|
669
669
|
9. **Worktree Isolation**: All fix execution happens in git worktree, not main branch
|
|
670
670
|
10. **DO NOT STOP**: Continuous execution until all waves complete or all remaining tasks are skipped
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
---
|
|
674
|
-
|
|
675
|
-
## Coordinator Role Constraints (Main Agent)
|
|
676
|
-
|
|
677
|
-
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
678
|
-
|
|
679
|
-
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:
|
|
680
|
-
- Spawns agents with task assignments
|
|
681
|
-
- Waits for agent callbacks
|
|
682
|
-
- Merges results and coordinates workflow
|
|
683
|
-
- Manages workflow transitions between phases
|
|
684
|
-
|
|
685
|
-
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
686
|
-
- Wait patiently for `wait()` calls to complete
|
|
687
|
-
- NOT skip workflow steps due to perceived delays
|
|
688
|
-
- NOT assume agents have failed just because they're taking time
|
|
689
|
-
- Trust the timeout mechanisms defined in the skill
|
|
690
|
-
|
|
691
|
-
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
692
|
-
- Use `send_input()` to ask questions or provide clarification
|
|
693
|
-
- NOT skip the agent or move to next phase prematurely
|
|
694
|
-
- Give agents opportunity to respond before escalating
|
|
695
|
-
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
696
|
-
|
|
697
|
-
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
698
|
-
- Skip phases or stages defined in the workflow
|
|
699
|
-
- Bypass required approval or review steps
|
|
700
|
-
- Execute dependent tasks before prerequisites complete
|
|
701
|
-
- Assume task completion without explicit agent callback
|
|
702
|
-
- Make up or fabricate agent results
|
|
703
|
-
|
|
704
|
-
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
705
|
-
- Total execution time may range from 30-90 minutes or longer
|
|
706
|
-
- Each phase may take 10-30 minutes depending on complexity
|
|
707
|
-
- The coordinator must remain active and attentive throughout the entire process
|
|
708
|
-
- Do not terminate or skip steps due to time concerns
|
|
671
|
+
|
|
672
|
+
|
|
673
|
+
---
|
|
674
|
+
|
|
675
|
+
## Coordinator Role Constraints (Main Agent)
|
|
676
|
+
|
|
677
|
+
**CRITICAL**: The coordinator (main agent executing this skill) is responsible for **orchestration only**, NOT implementation.
|
|
678
|
+
|
|
679
|
+
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:
|
|
680
|
+
- Spawns agents with task assignments
|
|
681
|
+
- Waits for agent callbacks
|
|
682
|
+
- Merges results and coordinates workflow
|
|
683
|
+
- Manages workflow transitions between phases
|
|
684
|
+
|
|
685
|
+
16. **Patient Waiting is Mandatory**: Agent execution takes significant time (typically 10-30 minutes per phase, sometimes longer). The coordinator MUST:
|
|
686
|
+
- Wait patiently for `wait()` calls to complete
|
|
687
|
+
- NOT skip workflow steps due to perceived delays
|
|
688
|
+
- NOT assume agents have failed just because they're taking time
|
|
689
|
+
- Trust the timeout mechanisms defined in the skill
|
|
690
|
+
|
|
691
|
+
17. **Use send_input for Clarification**: When agents need guidance or appear stuck, the coordinator MUST:
|
|
692
|
+
- Use `send_input()` to ask questions or provide clarification
|
|
693
|
+
- NOT skip the agent or move to next phase prematurely
|
|
694
|
+
- Give agents opportunity to respond before escalating
|
|
695
|
+
- Example: `send_input({ id: agent_id, message: "Please provide status update or clarify blockers" })`
|
|
696
|
+
|
|
697
|
+
18. **No Workflow Shortcuts**: The coordinator MUST NOT:
|
|
698
|
+
- Skip phases or stages defined in the workflow
|
|
699
|
+
- Bypass required approval or review steps
|
|
700
|
+
- Execute dependent tasks before prerequisites complete
|
|
701
|
+
- Assume task completion without explicit agent callback
|
|
702
|
+
- Make up or fabricate agent results
|
|
703
|
+
|
|
704
|
+
19. **Respect Long-Running Processes**: This is a complex multi-agent workflow that requires patience:
|
|
705
|
+
- Total execution time may range from 30-90 minutes or longer
|
|
706
|
+
- Each phase may take 10-30 minutes depending on complexity
|
|
707
|
+
- The coordinator must remain active and attentive throughout the entire process
|
|
708
|
+
- Do not terminate or skip steps due to time concerns
|
|
@@ -36,7 +36,7 @@ Interactive agent for reviewing the tech debt remediation plan at the plan appro
|
|
|
36
36
|
| Tool | Type | Purpose |
|
|
37
37
|
|------|------|---------|
|
|
38
38
|
| `Read` | built-in | Load plan artifacts and context |
|
|
39
|
-
| `
|
|
39
|
+
| `request_user_input` | built-in | Get user approval decision |
|
|
40
40
|
| `Write` | built-in | Store approval result |
|
|
41
41
|
|
|
42
42
|
### Tool Usage Patterns
|
|
@@ -91,13 +91,13 @@ Read("<session>/assessment/priority-matrix.json")
|
|
|
91
91
|
2. Present decision:
|
|
92
92
|
|
|
93
93
|
```javascript
|
|
94
|
-
|
|
94
|
+
request_user_input({
|
|
95
95
|
questions: [{
|
|
96
96
|
question: "Remediation plan generated. Review and decide:",
|
|
97
|
-
header: "Plan Approval
|
|
98
|
-
|
|
97
|
+
header: "Plan Approval",
|
|
98
|
+
id: "plan_approval",
|
|
99
99
|
options: [
|
|
100
|
-
{ label: "Approve", description: "Proceed with fix execution in worktree" },
|
|
100
|
+
{ label: "Approve (Recommended)", description: "Proceed with fix execution in worktree" },
|
|
101
101
|
{ label: "Revise", description: "Re-run planner with specific feedback" },
|
|
102
102
|
{ label: "Abort", description: "Stop pipeline, keep scan/assessment results" }
|
|
103
103
|
]
|