claude-code-workflow 7.2.14 → 7.2.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/.claude/commands/workflow/analyze-with-file.md +7 -0
  2. package/.codex/skills/analyze-with-file/SKILL.md +1181 -1182
  3. package/.codex/skills/brainstorm/SKILL.md +723 -725
  4. package/.codex/skills/brainstorm-with-file/SKILL.md +10 -5
  5. package/.codex/skills/clean/SKILL.md +33 -26
  6. package/.codex/skills/collaborative-plan-with-file/SKILL.md +830 -831
  7. package/.codex/skills/csv-wave-pipeline/SKILL.md +906 -906
  8. package/.codex/skills/issue-discover/SKILL.md +57 -50
  9. package/.codex/skills/issue-discover/phases/01-issue-new.md +18 -11
  10. package/.codex/skills/issue-discover/phases/02-discover.md +31 -26
  11. package/.codex/skills/issue-discover/phases/03-discover-by-prompt.md +13 -11
  12. package/.codex/skills/issue-discover/phases/04-quick-execute.md +32 -27
  13. package/.codex/skills/parallel-dev-cycle/SKILL.md +402 -402
  14. package/.codex/skills/project-documentation-workflow/SKILL.md +13 -3
  15. package/.codex/skills/roadmap-with-file/SKILL.md +901 -897
  16. package/.codex/skills/session-sync/SKILL.md +222 -212
  17. package/.codex/skills/spec-add/SKILL.md +620 -613
  18. package/.codex/skills/spec-generator/SKILL.md +2 -2
  19. package/.codex/skills/spec-generator/phases/01-5-requirement-clarification.md +10 -10
  20. package/.codex/skills/spec-generator/phases/01-discovery.md +11 -18
  21. package/.codex/skills/spec-generator/phases/02-product-brief.md +5 -5
  22. package/.codex/skills/spec-generator/phases/03-requirements.md +7 -7
  23. package/.codex/skills/spec-generator/phases/04-architecture.md +4 -4
  24. package/.codex/skills/spec-generator/phases/05-epics-stories.md +5 -6
  25. package/.codex/skills/spec-generator/phases/06-readiness-check.md +10 -17
  26. package/.codex/skills/spec-generator/phases/07-issue-export.md +326 -329
  27. package/.codex/skills/spec-setup/SKILL.md +669 -657
  28. package/.codex/skills/team-arch-opt/SKILL.md +50 -50
  29. package/.codex/skills/team-arch-opt/agents/completion-handler.md +3 -3
  30. package/.codex/skills/team-brainstorm/SKILL.md +724 -725
  31. package/.codex/skills/team-coordinate/SKILL.md +51 -51
  32. package/.codex/skills/team-coordinate/agents/completion-handler.md +3 -3
  33. package/.codex/skills/team-coordinate/agents/plan-reviewer.md +4 -4
  34. package/.codex/skills/team-designer/SKILL.md +691 -691
  35. package/.codex/skills/team-designer/agents/requirement-clarifier.md +11 -12
  36. package/.codex/skills/team-executor/SKILL.md +45 -45
  37. package/.codex/skills/team-frontend/SKILL.md +45 -45
  38. package/.codex/skills/team-frontend/agents/completion-handler.md +3 -3
  39. package/.codex/skills/team-frontend/agents/qa-gate-reviewer.md +4 -4
  40. package/.codex/skills/team-frontend-debug/SKILL.md +50 -50
  41. package/.codex/skills/team-frontend-debug/agents/completion-handler.md +3 -3
  42. package/.codex/skills/team-frontend-debug/agents/conditional-skip-gate.md +4 -4
  43. package/.codex/skills/team-issue/SKILL.md +751 -740
  44. package/.codex/skills/team-iterdev/SKILL.md +825 -826
  45. package/.codex/skills/team-lifecycle-v4/SKILL.md +775 -775
  46. package/.codex/skills/team-lifecycle-v4/agents/quality-gate.md +165 -165
  47. package/.codex/skills/team-lifecycle-v4/agents/requirement-clarifier.md +163 -163
  48. package/.codex/skills/team-perf-opt/SKILL.md +50 -50
  49. package/.codex/skills/team-perf-opt/agents/completion-handler.md +3 -3
  50. package/.codex/skills/team-planex-v2/SKILL.md +652 -637
  51. package/.codex/skills/team-quality-assurance/SKILL.md +51 -52
  52. package/.codex/skills/team-review/SKILL.md +40 -40
  53. package/.codex/skills/team-roadmap-dev/SKILL.md +51 -51
  54. package/.codex/skills/team-roadmap-dev/agents/roadmap-discusser.md +8 -8
  55. package/.codex/skills/team-tech-debt/SKILL.md +50 -50
  56. package/.codex/skills/team-tech-debt/agents/plan-approver.md +5 -5
  57. package/.codex/skills/team-testing/SKILL.md +51 -52
  58. package/.codex/skills/team-uidesign/SKILL.md +40 -40
  59. package/.codex/skills/team-uidesign/agents/completion-handler.md +177 -177
  60. package/.codex/skills/team-ultra-analyze/SKILL.md +786 -787
  61. package/.codex/skills/team-ultra-analyze/agents/discussion-feedback.md +8 -8
  62. package/.codex/skills/team-ux-improve/SKILL.md +51 -52
  63. package/.codex/skills/team-ux-improve/agents/ux-designer.md +2 -2
  64. package/.codex/skills/team-ux-improve/agents/ux-explorer.md +1 -1
  65. package/.codex/skills/unified-execute-with-file/SKILL.md +797 -796
  66. package/.codex/skills/workflow-execute/SKILL.md +1117 -1118
  67. package/.codex/skills/workflow-lite-planex/SKILL.md +1144 -1141
  68. package/.codex/skills/workflow-plan/SKILL.md +631 -636
  69. package/.codex/skills/workflow-tdd-plan/SKILL.md +753 -759
  70. package/.codex/skills/workflow-test-fix-cycle/SKILL.md +402 -392
  71. package/README.md +25 -0
  72. package/ccw/dist/commands/install.d.ts.map +1 -1
  73. package/ccw/dist/commands/install.js +12 -0
  74. package/ccw/dist/commands/install.js.map +1 -1
  75. package/package.json +1 -1
@@ -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, AskUserQuestion
5
+ allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, Read, Write, Edit, Bash, Glob, Grep, request_user_input
6
6
  ---
7
7
 
8
8
  ## Auto Mode
@@ -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
- AskUserQuestion({
289
+ request_user_input({
290
290
  questions: [{
291
- question: "Detected QA mode: '" + qaMode + "'. Confirm?",
292
- header: "QA Mode Selection",
293
- multiSelect: false,
291
+ question: `Detected QA mode: '${qaMode}'. Approve or override?`,
292
+ header: "QA Mode",
293
+ id: "qa_mode",
294
294
  options: [
295
- { label: "Proceed with " + qaMode, description: "Detected mode is appropriate" },
296
- { label: "Use discovery", description: "Scout-first: scan for issues, then test" },
297
- { label: "Use testing", description: "Direct testing pipeline (skip scout)" },
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
- AskUserQuestion({
538
+ request_user_input({
540
539
  questions: [{
541
- question: "Quality Assurance pipeline complete. What would you like to do?",
542
- header: "Completion",
543
- multiSelect: false,
540
+ question: "Quality Assurance pipeline complete. Choose next action.",
541
+ header: "Done",
542
+ id: "completion",
544
543
  options: [
545
- { label: "Archive & Clean (Recommended)", description: "Archive session, output final summary" },
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, AskUserQuestion
5
+ allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, Read, Write, Edit, Bash, Glob, Grep, request_user_input
6
6
  ---
7
7
 
8
8
  ## Auto Mode
@@ -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 | AskUserQuestion for corrected path |
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, AskUserQuestion
5
+ allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, Read, Write, Edit, Bash, Glob, Grep, request_user_input
6
6
  ---
7
7
 
8
8
  ## Auto Mode
@@ -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 AskUserQuestion
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 = AskUserQuestion({
346
+ const approval = request_user_input({
347
347
  questions: [{
348
348
  question: `Generated ${tasksWithWaves.length} tasks across ${phases.length} phases. Proceed?`,
349
- header: "Task Breakdown Validation",
350
- multiSelect: false,
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 = AskUserQuestion({
557
+ const nextStep = request_user_input({
558
558
  questions: [{
559
- question: "Roadmap Dev pipeline complete. What would you like to do?",
560
- header: "Completion",
561
- multiSelect: false,
559
+ question: "Roadmap Dev pipeline complete. Choose next action.",
560
+ header: "Done",
561
+ id: "completion",
562
562
  options: [
563
- { label: "Archive & Clean (Recommended)", description: "Archive session, clean up tasks and team resources" },
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 & Clean (Recommended)") {
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 AskUserQuestion
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
- | `AskUserQuestion` | Human interaction | Clarify requirements, propose phase breakdown |
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 AskUserQuestion:
84
+ 4. Present to user via request_user_input:
85
85
  ```javascript
86
- AskUserQuestion({
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 Discussion",
90
- multiSelect: false,
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 AskUserQuestion |
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, AskUserQuestion
5
+ allowed-tools: spawn_agents_on_csv, spawn_agent, wait, send_input, close_agent, Read, Write, Edit, Bash, Glob, Grep, request_user_input
6
6
  ---
7
7
 
8
8
  ## Auto Mode
@@ -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
- AskUserQuestion({
262
+ request_user_input({
263
263
  questions: [{
264
- question: "Tech debt governance scope:",
265
- header: "Scope Selection",
266
- multiSelect: false,
264
+ question: "Select tech debt governance scope.",
265
+ header: "Scope",
266
+ id: "debt_scope",
267
267
  options: [
268
- { label: "Full project scan", description: "Scan entire codebase" },
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
- AskUserQuestion({
520
+ request_user_input({
521
521
  questions: [{
522
- question: "What next?",
523
- header: "Completion",
524
- multiSelect: false,
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
- | `AskUserQuestion` | built-in | Get user approval decision |
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
- AskUserQuestion({
94
+ request_user_input({
95
95
  questions: [{
96
96
  question: "Remediation plan generated. Review and decide:",
97
- header: "Plan Approval Gate",
98
- multiSelect: false,
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
  ]