@ngxtm/devkit 3.18.0 → 3.20.0

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 (196) hide show
  1. package/merged-commands/application-performance-performance-optimization.md +13 -13
  2. package/merged-commands/ask/fast.md +14 -57
  3. package/merged-commands/ask/hard.md +22 -79
  4. package/merged-commands/auto.md +6 -33
  5. package/merged-commands/backend-development-feature-development.md +12 -12
  6. package/merged-commands/bootstrap/auto/fast.md +15 -15
  7. package/merged-commands/bootstrap/auto/parallel.md +12 -12
  8. package/merged-commands/bootstrap/auto.md +14 -14
  9. package/merged-commands/bootstrap.md +15 -15
  10. package/merged-commands/brainstorm/fast.md +19 -72
  11. package/merged-commands/brainstorm/hard.md +23 -84
  12. package/merged-commands/c4-architecture-c4-architecture.md +5 -5
  13. package/merged-commands/code/auto.md +16 -16
  14. package/merged-commands/code/fast.md +19 -72
  15. package/merged-commands/code/hard.md +38 -122
  16. package/merged-commands/code/no-test.md +12 -12
  17. package/merged-commands/code/parallel.md +9 -9
  18. package/merged-commands/code.md +14 -14
  19. package/merged-commands/comprehensive-review-full-review.md +8 -8
  20. package/merged-commands/context-degradation.md +2 -2
  21. package/merged-commands/context-engineering.md +4 -4
  22. package/merged-commands/context-optimization.md +3 -3
  23. package/merged-commands/cook/auto/fast.md +3 -3
  24. package/merged-commands/cook/auto/parallel.md +9 -9
  25. package/merged-commands/cook/auto.md +1 -1
  26. package/merged-commands/cook/fast.md +38 -47
  27. package/merged-commands/cook/hard.md +46 -41
  28. package/merged-commands/cook.md +13 -13
  29. package/merged-commands/daily-news-report.md +15 -15
  30. package/merged-commands/data-engineering-data-driven-feature.md +16 -16
  31. package/merged-commands/debug/fast.md +13 -29
  32. package/merged-commands/debug/hard.md +47 -49
  33. package/merged-commands/debug.md +1 -1
  34. package/merged-commands/debugging-toolkit-smart-debug.md +1 -1
  35. package/merged-commands/deploy/check.md +22 -71
  36. package/merged-commands/deploy/preview.md +18 -62
  37. package/merged-commands/deploy/production.md +22 -71
  38. package/merged-commands/deploy/rollback.md +22 -71
  39. package/merged-commands/deploy.md +0 -11
  40. package/merged-commands/design/3d.md +3 -3
  41. package/merged-commands/design/describe.md +1 -1
  42. package/merged-commands/design/fast.md +2 -2
  43. package/merged-commands/design/good.md +3 -3
  44. package/merged-commands/design/hard.md +15 -85
  45. package/merged-commands/design/screenshot.md +1 -1
  46. package/merged-commands/design/video.md +1 -1
  47. package/merged-commands/design.md +0 -11
  48. package/merged-commands/doc-coauthoring.md +5 -5
  49. package/merged-commands/docker-expert.md +1 -1
  50. package/merged-commands/docs/audit.md +26 -77
  51. package/merged-commands/docs/business.md +26 -77
  52. package/merged-commands/docs/core.md +24 -68
  53. package/merged-commands/docs/init.md +8 -8
  54. package/merged-commands/docs/update.md +13 -13
  55. package/merged-commands/docs.md +0 -12
  56. package/merged-commands/error-debugging-multi-agent-review.md +1 -1
  57. package/merged-commands/error-diagnostics-smart-debug.md +1 -1
  58. package/merged-commands/finishing-a-development-branch.md +1 -1
  59. package/merged-commands/fix/ci.md +2 -2
  60. package/merged-commands/fix/fast.md +2 -2
  61. package/merged-commands/fix/hard.md +6 -6
  62. package/merged-commands/fix/logs.md +5 -5
  63. package/merged-commands/fix/parallel.md +9 -9
  64. package/merged-commands/fix/test.md +6 -6
  65. package/merged-commands/fix/ui.md +8 -8
  66. package/merged-commands/fixing.md +3 -3
  67. package/merged-commands/framework-migration-legacy-modernize.md +13 -13
  68. package/merged-commands/full-stack-orchestration-full-stack-feature.md +12 -12
  69. package/merged-commands/git/cm.md +1 -1
  70. package/merged-commands/git/cp.md +1 -1
  71. package/merged-commands/git/merge.md +1 -1
  72. package/merged-commands/git/pr.md +1 -1
  73. package/merged-commands/git-pr-workflows-git-workflow.md +10 -10
  74. package/merged-commands/google-adk-python.md +1 -1
  75. package/merged-commands/hr-pro.md +1 -1
  76. package/merged-commands/incident-response-incident-response.md +13 -13
  77. package/merged-commands/integrate/polar.md +3 -3
  78. package/merged-commands/integrate/sepay.md +3 -3
  79. package/merged-commands/journal.md +1 -1
  80. package/merged-commands/learn.md +51 -4
  81. package/merged-commands/linear-claude-skill.md +2 -2
  82. package/merged-commands/loki-mode.md +14 -14
  83. package/merged-commands/machine-learning-ops-ml-pipeline.md +7 -7
  84. package/merged-commands/mcp-management.md +8 -8
  85. package/merged-commands/multi-agent-patterns.md +14 -14
  86. package/merged-commands/multi-platform-apps-multi-platform.md +10 -10
  87. package/merged-commands/nestjs-expert.md +1 -1
  88. package/merged-commands/performance-testing-review-multi-agent-review.md +1 -1
  89. package/merged-commands/plan/archive.md +1 -1
  90. package/merged-commands/plan/ci.md +1 -1
  91. package/merged-commands/plan/fast.md +2 -2
  92. package/merged-commands/plan/hard.md +4 -4
  93. package/merged-commands/plan/parallel.md +5 -5
  94. package/merged-commands/plan/two.md +6 -6
  95. package/merged-commands/requesting-code-review.md +6 -6
  96. package/merged-commands/review/codebase/parallel.md +5 -5
  97. package/merged-commands/review/codebase.md +5 -5
  98. package/merged-commands/review/fast.md +13 -29
  99. package/merged-commands/review/hard.md +48 -49
  100. package/merged-commands/review.md +0 -11
  101. package/merged-commands/security-scanning-security-hardening.md +13 -13
  102. package/merged-commands/skill/add.md +6 -6
  103. package/merged-commands/skill/create.md +6 -6
  104. package/merged-commands/skill/fix-logs.md +6 -6
  105. package/merged-commands/skill/optimize/auto.md +1 -1
  106. package/merged-commands/skill/optimize.md +1 -1
  107. package/merged-commands/skill/plan.md +1 -1
  108. package/merged-commands/skill/update.md +6 -6
  109. package/merged-commands/subagent-driven-development.md +53 -53
  110. package/merged-commands/tdd-workflows-tdd-cycle.md +12 -12
  111. package/merged-commands/tdd-workflows-tdd-red.md +1 -1
  112. package/merged-commands/tdd-workflows-tdd-refactor.md +1 -1
  113. package/merged-commands/test/fast.md +22 -33
  114. package/merged-commands/test/hard.md +59 -56
  115. package/merged-commands/test/ui.md +1 -1
  116. package/merged-commands/test.md +1 -1
  117. package/merged-commands/typescript-expert.md +1 -1
  118. package/merged-commands/use-mcp.md +5 -5
  119. package/merged-commands/writing-plans.md +3 -3
  120. package/merged-commands/writing-skills.md +8 -8
  121. package/package.json +1 -1
  122. package/rules-index.json +1 -1
  123. package/skills/application-performance-performance-optimization/SKILL.md +13 -13
  124. package/skills/azure-ai-agents-python/references/tools.md +1 -1
  125. package/skills/backend-development-feature-development/SKILL.md +12 -12
  126. package/skills/best-practices/references/anti-patterns.md +2 -2
  127. package/skills/best-practices/references/best-practices-guide.md +14 -14
  128. package/skills/c4-architecture-c4-architecture/SKILL.md +5 -5
  129. package/skills/comprehensive-review-full-review/SKILL.md +8 -8
  130. package/skills/context-degradation/SKILL.md +2 -2
  131. package/skills/context-engineering/SKILL.md +4 -4
  132. package/skills/context-engineering/references/context-degradation.md +1 -1
  133. package/skills/context-engineering/references/context-optimization.md +1 -1
  134. package/skills/context-engineering/references/multi-agent-patterns.md +1 -1
  135. package/skills/context-engineering/references/runtime-awareness.md +1 -1
  136. package/skills/context-optimization/SKILL.md +3 -3
  137. package/skills/daily-news-report/SKILL.md +15 -15
  138. package/skills/data-engineering-data-driven-feature/SKILL.md +16 -16
  139. package/skills/debugging-toolkit-smart-debug/SKILL.md +1 -1
  140. package/skills/doc-coauthoring/SKILL.md +5 -5
  141. package/skills/docker-expert/SKILL.md +1 -1
  142. package/skills/error-debugging-multi-agent-review/SKILL.md +1 -1
  143. package/skills/error-diagnostics-smart-debug/SKILL.md +1 -1
  144. package/skills/finishing-a-development-branch/SKILL.md +1 -1
  145. package/skills/fixing/SKILL.md +3 -3
  146. package/skills/fixing/references/parallel-exploration.md +4 -4
  147. package/skills/fixing/references/skill-activation-matrix.md +3 -3
  148. package/skills/fixing/references/workflow-deep.md +11 -11
  149. package/skills/fixing/references/workflow-quick.md +4 -4
  150. package/skills/fixing/references/workflow-standard.md +12 -12
  151. package/skills/framework-migration-legacy-modernize/SKILL.md +13 -13
  152. package/skills/full-stack-orchestration-full-stack-feature/SKILL.md +12 -12
  153. package/skills/git-pr-workflows-git-workflow/SKILL.md +10 -10
  154. package/skills/google-adk-python/SKILL.md +1 -1
  155. package/skills/hr-pro/SKILL.md +1 -1
  156. package/skills/incident-response-incident-response/SKILL.md +13 -13
  157. package/skills/incident-response-smart-fix/resources/implementation-playbook.md +17 -17
  158. package/skills/learn/SKILL.md +51 -4
  159. package/skills/linear-claude-skill/SKILL.md +2 -2
  160. package/skills/loki-mode/ACKNOWLEDGEMENTS.md +4 -4
  161. package/skills/loki-mode/CHANGELOG.md +9 -9
  162. package/skills/loki-mode/CONTEXT-EXPORT.md +1 -1
  163. package/skills/loki-mode/README.md +2 -2
  164. package/skills/loki-mode/SKILL.md +14 -14
  165. package/skills/loki-mode/autonomy/run.sh +1 -1
  166. package/skills/loki-mode/integrations/vibe-kanban.md +1 -1
  167. package/skills/loki-mode/references/core-workflow.md +4 -4
  168. package/skills/loki-mode/references/production-patterns.md +6 -6
  169. package/skills/loki-mode/references/quality-control.md +2 -2
  170. package/skills/loki-mode/references/sdlc-phases.md +3 -3
  171. package/skills/machine-learning-ops-ml-pipeline/SKILL.md +7 -7
  172. package/skills/mcp-builder/reference/evaluation.md +3 -3
  173. package/skills/mcp-management/README.md +6 -6
  174. package/skills/mcp-management/SKILL.md +8 -8
  175. package/skills/mcp-management/references/gemini-cli-integration.md +1 -1
  176. package/skills/multi-agent-patterns/SKILL.md +14 -14
  177. package/skills/multi-platform-apps-multi-platform/SKILL.md +10 -10
  178. package/skills/nestjs-expert/SKILL.md +1 -1
  179. package/skills/performance-testing-review-multi-agent-review/SKILL.md +1 -1
  180. package/skills/planning-with-files/reference.md +2 -2
  181. package/skills/requesting-code-review/SKILL.md +6 -6
  182. package/skills/security-scanning-security-hardening/SKILL.md +13 -13
  183. package/skills/subagent-driven-development/SKILL.md +53 -53
  184. package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +1 -1
  185. package/skills/subagent-driven-development/implementer-prompt.md +3 -3
  186. package/skills/subagent-driven-development/spec-reviewer-prompt.md +1 -1
  187. package/skills/tdd-workflows-tdd-cycle/SKILL.md +12 -12
  188. package/skills/tdd-workflows-tdd-green/resources/implementation-playbook.md +1 -1
  189. package/skills/tdd-workflows-tdd-red/SKILL.md +1 -1
  190. package/skills/tdd-workflows-tdd-refactor/SKILL.md +1 -1
  191. package/skills/typescript-expert/SKILL.md +1 -1
  192. package/skills/writing-plans/SKILL.md +3 -3
  193. package/skills/writing-skills/SKILL.md +8 -8
  194. package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +1 -1
  195. package/skills/writing-skills/references/cso/README.md +3 -3
  196. package/skills/writing-skills/testing-skills-with-subagents.md +1 -1
@@ -5,11 +5,11 @@ risk: unknown
5
5
  source: community
6
6
  ---
7
7
 
8
- # Subagent-Driven Development
8
+ # Task Agent-Driven Development
9
9
 
10
- Execute plan by dispatching fresh subagent per task, with two-stage review after each: spec compliance review first, then code quality review.
10
+ Execute plan by dispatching fresh Task agent per task, with two-stage review after each: spec compliance review first, then code quality review.
11
11
 
12
- **Core principle:** Fresh subagent per task + two-stage review (spec then quality) = high quality, fast iteration
12
+ **Core principle:** Fresh Task agent per task + two-stage review (spec then quality) = high quality, fast iteration
13
13
 
14
14
  ## When to Use
15
15
 
@@ -33,7 +33,7 @@ digraph when_to_use {
33
33
 
34
34
  **vs. Executing Plans (parallel session):**
35
35
  - Same session (no context switch)
36
- - Fresh subagent per task (no context pollution)
36
+ - Fresh Task agent per task (no context pollution)
37
37
  - Two-stage review after each task: spec compliance first, then code quality
38
38
  - Faster iteration (no human-in-loop between tasks)
39
39
 
@@ -45,55 +45,55 @@ digraph process {
45
45
 
46
46
  subgraph cluster_per_task {
47
47
  label="Per Task";
48
- "Dispatch implementer subagent (./implementer-prompt.md)" [shape=box];
49
- "Implementer subagent asks questions?" [shape=diamond];
48
+ "Dispatch implementer Task agent (./implementer-prompt.md)" [shape=box];
49
+ "Implementer Task agent asks questions?" [shape=diamond];
50
50
  "Answer questions, provide context" [shape=box];
51
- "Implementer subagent implements, tests, commits, self-reviews" [shape=box];
52
- "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [shape=box];
53
- "Spec reviewer subagent confirms code matches spec?" [shape=diamond];
54
- "Implementer subagent fixes spec gaps" [shape=box];
55
- "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [shape=box];
56
- "Code quality reviewer subagent approves?" [shape=diamond];
57
- "Implementer subagent fixes quality issues" [shape=box];
51
+ "Implementer Task agent implements, tests, commits, self-reviews" [shape=box];
52
+ "Dispatch spec reviewer Task agent (./spec-reviewer-prompt.md)" [shape=box];
53
+ "Spec reviewer Task agent confirms code matches spec?" [shape=diamond];
54
+ "Implementer Task agent fixes spec gaps" [shape=box];
55
+ "Dispatch code quality reviewer Task agent (./code-quality-reviewer-prompt.md)" [shape=box];
56
+ "Code quality reviewer Task agent approves?" [shape=diamond];
57
+ "Implementer Task agent fixes quality issues" [shape=box];
58
58
  "Mark task complete in TodoWrite" [shape=box];
59
59
  }
60
60
 
61
61
  "Read plan, extract all tasks with full text, note context, create TodoWrite" [shape=box];
62
62
  "More tasks remain?" [shape=diamond];
63
- "Dispatch final code reviewer subagent for entire implementation" [shape=box];
63
+ "Dispatch final code reviewer Task agent for entire implementation" [shape=box];
64
64
  "Use superpowers:finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen];
65
65
 
66
- "Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer subagent (./implementer-prompt.md)";
67
- "Dispatch implementer subagent (./implementer-prompt.md)" -> "Implementer subagent asks questions?";
68
- "Implementer subagent asks questions?" -> "Answer questions, provide context" [label="yes"];
69
- "Answer questions, provide context" -> "Dispatch implementer subagent (./implementer-prompt.md)";
70
- "Implementer subagent asks questions?" -> "Implementer subagent implements, tests, commits, self-reviews" [label="no"];
71
- "Implementer subagent implements, tests, commits, self-reviews" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)";
72
- "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" -> "Spec reviewer subagent confirms code matches spec?";
73
- "Spec reviewer subagent confirms code matches spec?" -> "Implementer subagent fixes spec gaps" [label="no"];
74
- "Implementer subagent fixes spec gaps" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [label="re-review"];
75
- "Spec reviewer subagent confirms code matches spec?" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="yes"];
76
- "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" -> "Code quality reviewer subagent approves?";
77
- "Code quality reviewer subagent approves?" -> "Implementer subagent fixes quality issues" [label="no"];
78
- "Implementer subagent fixes quality issues" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="re-review"];
79
- "Code quality reviewer subagent approves?" -> "Mark task complete in TodoWrite" [label="yes"];
66
+ "Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer Task agent (./implementer-prompt.md)";
67
+ "Dispatch implementer Task agent (./implementer-prompt.md)" -> "Implementer Task agent asks questions?";
68
+ "Implementer Task agent asks questions?" -> "Answer questions, provide context" [label="yes"];
69
+ "Answer questions, provide context" -> "Dispatch implementer Task agent (./implementer-prompt.md)";
70
+ "Implementer Task agent asks questions?" -> "Implementer Task agent implements, tests, commits, self-reviews" [label="no"];
71
+ "Implementer Task agent implements, tests, commits, self-reviews" -> "Dispatch spec reviewer Task agent (./spec-reviewer-prompt.md)";
72
+ "Dispatch spec reviewer Task agent (./spec-reviewer-prompt.md)" -> "Spec reviewer Task agent confirms code matches spec?";
73
+ "Spec reviewer Task agent confirms code matches spec?" -> "Implementer Task agent fixes spec gaps" [label="no"];
74
+ "Implementer Task agent fixes spec gaps" -> "Dispatch spec reviewer Task agent (./spec-reviewer-prompt.md)" [label="re-review"];
75
+ "Spec reviewer Task agent confirms code matches spec?" -> "Dispatch code quality reviewer Task agent (./code-quality-reviewer-prompt.md)" [label="yes"];
76
+ "Dispatch code quality reviewer Task agent (./code-quality-reviewer-prompt.md)" -> "Code quality reviewer Task agent approves?";
77
+ "Code quality reviewer Task agent approves?" -> "Implementer Task agent fixes quality issues" [label="no"];
78
+ "Implementer Task agent fixes quality issues" -> "Dispatch code quality reviewer Task agent (./code-quality-reviewer-prompt.md)" [label="re-review"];
79
+ "Code quality reviewer Task agent approves?" -> "Mark task complete in TodoWrite" [label="yes"];
80
80
  "Mark task complete in TodoWrite" -> "More tasks remain?";
81
- "More tasks remain?" -> "Dispatch implementer subagent (./implementer-prompt.md)" [label="yes"];
82
- "More tasks remain?" -> "Dispatch final code reviewer subagent for entire implementation" [label="no"];
83
- "Dispatch final code reviewer subagent for entire implementation" -> "Use superpowers:finishing-a-development-branch";
81
+ "More tasks remain?" -> "Dispatch implementer Task agent (./implementer-prompt.md)" [label="yes"];
82
+ "More tasks remain?" -> "Dispatch final code reviewer Task agent for entire implementation" [label="no"];
83
+ "Dispatch final code reviewer Task agent for entire implementation" -> "Use superpowers:finishing-a-development-branch";
84
84
  }
85
85
  ```
86
86
 
87
87
  ## Prompt Templates
88
88
 
89
- - `./implementer-prompt.md` - Dispatch implementer subagent
90
- - `./spec-reviewer-prompt.md` - Dispatch spec compliance reviewer subagent
91
- - `./code-quality-reviewer-prompt.md` - Dispatch code quality reviewer subagent
89
+ - `./implementer-prompt.md` - Dispatch implementer Task agent
90
+ - `./spec-reviewer-prompt.md` - Dispatch spec compliance reviewer Task agent
91
+ - `./code-quality-reviewer-prompt.md` - Dispatch code quality reviewer Task agent
92
92
 
93
93
  ## Example Workflow
94
94
 
95
95
  ```
96
- You: I'm using Subagent-Driven Development to execute this plan.
96
+ You: I'm using Task Agent-Driven Development to execute this plan.
97
97
 
98
98
  [Read plan file once: docs/plans/feature-plan.md]
99
99
  [Extract all 5 tasks with full text and context]
@@ -102,7 +102,7 @@ You: I'm using Subagent-Driven Development to execute this plan.
102
102
  Task 1: Hook installation script
103
103
 
104
104
  [Get Task 1 text and context (already extracted)]
105
- [Dispatch implementation subagent with full task text + context]
105
+ [Dispatch implementation Task agent with full task text + context]
106
106
 
107
107
  Implementer: "Before I begin - should the hook be installed at user or system level?"
108
108
 
@@ -126,7 +126,7 @@ Code reviewer: Strengths: Good test coverage, clean. Issues: None. Approved.
126
126
  Task 2: Recovery modes
127
127
 
128
128
  [Get Task 2 text and context (already extracted)]
129
- [Dispatch implementation subagent with full task text + context]
129
+ [Dispatch implementation Task agent with full task text + context]
130
130
 
131
131
  Implementer: [No questions, proceeds]
132
132
  Implementer:
@@ -169,10 +169,10 @@ Done!
169
169
  ## Advantages
170
170
 
171
171
  **vs. Manual execution:**
172
- - Subagents follow TDD naturally
172
+ - Task agents follow TDD naturally
173
173
  - Fresh context per task (no confusion)
174
- - Parallel-safe (subagents don't interfere)
175
- - Subagent can ask questions (before AND during work)
174
+ - Parallel-safe (Task agents don't interfere)
175
+ - Task agent can ask questions (before AND during work)
176
176
 
177
177
  **vs. Executing Plans:**
178
178
  - Same session (no handoff)
@@ -182,7 +182,7 @@ Done!
182
182
  **Efficiency gains:**
183
183
  - No file reading overhead (controller provides full text)
184
184
  - Controller curates exactly what context is needed
185
- - Subagent gets complete information upfront
185
+ - Task agent gets complete information upfront
186
186
  - Questions surfaced before work begins (not after)
187
187
 
188
188
  **Quality gates:**
@@ -193,7 +193,7 @@ Done!
193
193
  - Code quality ensures implementation is well-built
194
194
 
195
195
  **Cost:**
196
- - More subagent invocations (implementer + 2 reviewers per task)
196
+ - More Task agent invocations (implementer + 2 reviewers per task)
197
197
  - Controller does more prep work (extracting all tasks upfront)
198
198
  - Review loops add iterations
199
199
  - But catches issues early (cheaper than debugging later)
@@ -203,40 +203,40 @@ Done!
203
203
  **Never:**
204
204
  - Skip reviews (spec compliance OR code quality)
205
205
  - Proceed with unfixed issues
206
- - Dispatch multiple implementation subagents in parallel (conflicts)
207
- - Make subagent read plan file (provide full text instead)
208
- - Skip scene-setting context (subagent needs to understand where task fits)
209
- - Ignore subagent questions (answer before letting them proceed)
206
+ - Dispatch multiple implementation Task agents in parallel (conflicts)
207
+ - Make Task agent read plan file (provide full text instead)
208
+ - Skip scene-setting context (Task agent needs to understand where task fits)
209
+ - Ignore Task agent questions (answer before letting them proceed)
210
210
  - Accept "close enough" on spec compliance (spec reviewer found issues = not done)
211
211
  - Skip review loops (reviewer found issues = implementer fixes = review again)
212
212
  - Let implementer self-review replace actual review (both are needed)
213
213
  - **Start code quality review before spec compliance is ✅** (wrong order)
214
214
  - Move to next task while either review has open issues
215
215
 
216
- **If subagent asks questions:**
216
+ **If Task agent asks questions:**
217
217
  - Answer clearly and completely
218
218
  - Provide additional context if needed
219
219
  - Don't rush them into implementation
220
220
 
221
221
  **If reviewer finds issues:**
222
- - Implementer (same subagent) fixes them
222
+ - Implementer (same Task agent) fixes them
223
223
  - Reviewer reviews again
224
224
  - Repeat until approved
225
225
  - Don't skip the re-review
226
226
 
227
- **If subagent fails task:**
228
- - Dispatch fix subagent with specific instructions
227
+ **If Task agent fails task:**
228
+ - Dispatch fix Task agent with specific instructions
229
229
  - Don't try to fix manually (context pollution)
230
230
 
231
231
  ## Integration
232
232
 
233
233
  **Required workflow skills:**
234
234
  - **superpowers:writing-plans** - Creates the plan this skill executes
235
- - **superpowers:requesting-code-review** - Code review template for reviewer subagents
235
+ - **superpowers:requesting-code-review** - Code review template for reviewer Task agents
236
236
  - **superpowers:finishing-a-development-branch** - Complete development after all tasks
237
237
 
238
- **Subagents should use:**
239
- - **superpowers:test-driven-development** - Subagents follow TDD for each task
238
+ **Task agents should use:**
239
+ - **superpowers:test-driven-development** - Task agents follow TDD for each task
240
240
 
241
241
  **Alternative workflow:**
242
242
  - **superpowers:executing-plans** - Use for parallel session instead of same-session execution
@@ -1,6 +1,6 @@
1
1
  # Code Quality Reviewer Prompt Template
2
2
 
3
- Use this template when dispatching a code quality reviewer subagent.
3
+ Use this template when dispatching a code quality reviewer Task agent.
4
4
 
5
5
  **Purpose:** Verify implementation is well-built (clean, tested, maintainable)
6
6
 
@@ -1,6 +1,6 @@
1
- # Implementer Subagent Prompt Template
1
+ # Implementer Task Agent Prompt Template
2
2
 
3
- Use this template when dispatching an implementer subagent.
3
+ Use this template when dispatching an implementer Task agent.
4
4
 
5
5
  ```
6
6
  Task tool (general-purpose):
@@ -10,7 +10,7 @@ Task tool (general-purpose):
10
10
 
11
11
  ## Task Description
12
12
 
13
- [FULL TEXT of task from plan - paste it here, don't make subagent read file]
13
+ [FULL TEXT of task from plan - paste it here, don't make Task agent read file]
14
14
 
15
15
  ## Context
16
16
 
@@ -1,6 +1,6 @@
1
1
  # Spec Compliance Reviewer Prompt Template
2
2
 
3
- Use this template when dispatching a spec compliance reviewer subagent.
3
+ Use this template when dispatching a spec compliance reviewer Task agent.
4
4
 
5
5
  **Purpose:** Verify implementer built what was requested (nothing more, nothing less)
6
6
 
@@ -42,13 +42,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
42
42
  ## Phase 1: Test Specification and Design
43
43
 
44
44
  ### 1. Requirements Analysis
45
- - Use Task tool with subagent_type="comprehensive-review::architect-review"
45
+ - Use Task tool with subagent_type="general-purpose"
46
46
  - Prompt: "Analyze requirements for: $ARGUMENTS. Define acceptance criteria, identify edge cases, and create test scenarios. Output a comprehensive test specification."
47
47
  - Output: Test specification, acceptance criteria, edge case matrix
48
48
  - Validation: Ensure all requirements have corresponding test scenarios
49
49
 
50
50
  ### 2. Test Architecture Design
51
- - Use Task tool with subagent_type="unit-testing::test-automator"
51
+ - Use Task tool with subagent_type="general-purpose"
52
52
  - Prompt: "Design test architecture for: $ARGUMENTS based on test specification. Define test structure, fixtures, mocks, and test data strategy. Ensure testability and maintainability."
53
53
  - Output: Test architecture, fixture design, mock strategy
54
54
  - Validation: Architecture supports isolated, fast, reliable tests
@@ -56,13 +56,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
56
56
  ## Phase 2: RED - Write Failing Tests
57
57
 
58
58
  ### 3. Write Unit Tests (Failing)
59
- - Use Task tool with subagent_type="unit-testing::test-automator"
59
+ - Use Task tool with subagent_type="general-purpose"
60
60
  - Prompt: "Write FAILING unit tests for: $ARGUMENTS. Tests must fail initially. Include edge cases, error scenarios, and happy paths. DO NOT implement production code."
61
61
  - Output: Failing unit tests, test documentation
62
62
  - **CRITICAL**: Verify all tests fail with expected error messages
63
63
 
64
64
  ### 4. Verify Test Failure
65
- - Use Task tool with subagent_type="tdd-workflows::code-reviewer"
65
+ - Use Task tool with subagent_type="general-purpose"
66
66
  - Prompt: "Verify that all tests for: $ARGUMENTS are failing correctly. Ensure failures are for the right reasons (missing implementation, not test errors). Confirm no false positives."
67
67
  - Output: Test failure verification report
68
68
  - **GATE**: Do not proceed until all tests fail appropriately
@@ -70,13 +70,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
70
70
  ## Phase 3: GREEN - Make Tests Pass
71
71
 
72
72
  ### 5. Minimal Implementation
73
- - Use Task tool with subagent_type="backend-development::backend-architect"
73
+ - Use Task tool with subagent_type="general-purpose"
74
74
  - Prompt: "Implement MINIMAL code to make tests pass for: $ARGUMENTS. Focus only on making tests green. Do not add extra features or optimizations. Keep it simple."
75
75
  - Output: Minimal working implementation
76
76
  - Constraint: No code beyond what's needed to pass tests
77
77
 
78
78
  ### 6. Verify Test Success
79
- - Use Task tool with subagent_type="unit-testing::test-automator"
79
+ - Use Task tool with subagent_type="general-purpose"
80
80
  - Prompt: "Run all tests for: $ARGUMENTS and verify they pass. Check test coverage metrics. Ensure no tests were accidentally broken."
81
81
  - Output: Test execution report, coverage metrics
82
82
  - **GATE**: All tests must pass before proceeding
@@ -84,13 +84,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
84
84
  ## Phase 4: REFACTOR - Improve Code Quality
85
85
 
86
86
  ### 7. Code Refactoring
87
- - Use Task tool with subagent_type="tdd-workflows::code-reviewer"
87
+ - Use Task tool with subagent_type="general-purpose"
88
88
  - Prompt: "Refactor implementation for: $ARGUMENTS while keeping tests green. Apply SOLID principles, remove duplication, improve naming, and optimize performance. Run tests after each refactoring."
89
89
  - Output: Refactored code, refactoring report
90
90
  - Constraint: Tests must remain green throughout
91
91
 
92
92
  ### 8. Test Refactoring
93
- - Use Task tool with subagent_type="unit-testing::test-automator"
93
+ - Use Task tool with subagent_type="general-purpose"
94
94
  - Prompt: "Refactor tests for: $ARGUMENTS. Remove test duplication, improve test names, extract common fixtures, and enhance test readability. Ensure tests still provide same coverage."
95
95
  - Output: Refactored tests, improved test structure
96
96
  - Validation: Coverage metrics unchanged or improved
@@ -98,13 +98,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
98
98
  ## Phase 5: Integration and System Tests
99
99
 
100
100
  ### 9. Write Integration Tests (Failing First)
101
- - Use Task tool with subagent_type="unit-testing::test-automator"
101
+ - Use Task tool with subagent_type="general-purpose"
102
102
  - Prompt: "Write FAILING integration tests for: $ARGUMENTS. Test component interactions, API contracts, and data flow. Tests must fail initially."
103
103
  - Output: Failing integration tests
104
104
  - Validation: Tests fail due to missing integration logic
105
105
 
106
106
  ### 10. Implement Integration
107
- - Use Task tool with subagent_type="backend-development::backend-architect"
107
+ - Use Task tool with subagent_type="general-purpose"
108
108
  - Prompt: "Implement integration code for: $ARGUMENTS to make integration tests pass. Focus on component interaction and data flow."
109
109
  - Output: Integration implementation
110
110
  - Validation: All integration tests pass
@@ -112,13 +112,13 @@ Execute a comprehensive Test-Driven Development (TDD) workflow with strict red-g
112
112
  ## Phase 6: Continuous Improvement Cycle
113
113
 
114
114
  ### 11. Performance and Edge Case Tests
115
- - Use Task tool with subagent_type="unit-testing::test-automator"
115
+ - Use Task tool with subagent_type="general-purpose"
116
116
  - Prompt: "Add performance tests and additional edge case tests for: $ARGUMENTS. Include stress tests, boundary tests, and error recovery tests."
117
117
  - Output: Extended test suite
118
118
  - Metric: Increased test coverage and scenario coverage
119
119
 
120
120
  ### 12. Final Code Review
121
- - Use Task tool with subagent_type="comprehensive-review::architect-review"
121
+ - Use Task tool with subagent_type="general-purpose"
122
122
  - Prompt: "Perform comprehensive review of: $ARGUMENTS. Verify TDD process was followed, check code quality, test quality, and coverage. Suggest improvements."
123
123
  - Output: Review report, improvement suggestions
124
124
  - Action: Implement critical suggestions while maintaining green tests
@@ -32,7 +32,7 @@ Implement minimal code to make failing tests pass in TDD green phase:
32
32
 
33
33
  ## Implementation Process
34
34
 
35
- Use Task tool with subagent_type="unit-testing::test-automator" to implement minimal passing code.
35
+ Use Task tool with subagent_type="general-purpose" to implement minimal passing code.
36
36
 
37
37
  Prompt: "Implement MINIMAL code to make these failing tests pass: $ARGUMENTS. Follow TDD green phase principles:
38
38
 
@@ -35,7 +35,7 @@ Write comprehensive failing tests following TDD red phase principles.
35
35
 
36
36
  ## Role
37
37
 
38
- Generate failing tests using Task tool with subagent_type="unit-testing::test-automator".
38
+ Generate failing tests using Task tool with subagent_type="general-purpose".
39
39
 
40
40
  ## Prompt Template
41
41
 
@@ -28,7 +28,7 @@ Refactor code with confidence using comprehensive test safety net:
28
28
 
29
29
  ## Usage
30
30
 
31
- Use Task tool with subagent_type="tdd-orchestrator" to perform safe refactoring.
31
+ Use Task tool with subagent_type="general-purpose" to perform safe refactoring.
32
32
 
33
33
  Prompt: "Refactor this code while keeping all tests green: $ARGUMENTS. Apply TDD refactor phase:
34
34
 
@@ -27,7 +27,7 @@ You are an advanced TypeScript expert with deep, practical knowledge of type-lev
27
27
  - Type performance profiling or compiler internals → typescript-type-expert
28
28
 
29
29
  Example to output:
30
- "This requires deep bundler expertise. Please invoke: 'Use the typescript-build-expert subagent.' Stopping here."
30
+ "This requires deep bundler expertise. Please invoke: 'Use the typescript-build-expert Task agent.' Stopping here."
31
31
 
32
32
  1. Analyze project setup comprehensively:
33
33
 
@@ -102,16 +102,16 @@ After saving the plan, offer execution choice:
102
102
 
103
103
  **"Plan complete and saved to `docs/plans/<filename>.md`. Two execution options:**
104
104
 
105
- **1. Subagent-Driven (this session)** - I dispatch fresh subagent per task, review between tasks, fast iteration
105
+ **1. Task Agent-Driven (this session)** - I dispatch fresh Task agent per task, review between tasks, fast iteration
106
106
 
107
107
  **2. Parallel Session (separate)** - Open new session with executing-plans, batch execution with checkpoints
108
108
 
109
109
  **Which approach?"**
110
110
 
111
- **If Subagent-Driven chosen:**
111
+ **If Task Agent-Driven chosen:**
112
112
  - **REQUIRED SUB-SKILL:** Use superpowers:subagent-driven-development
113
113
  - Stay in this session
114
- - Fresh subagent per task + code review
114
+ - Fresh Task agent per task + code review
115
115
 
116
116
  **If Parallel Session chosen:**
117
117
  - Guide them to open new session in worktree
@@ -11,7 +11,7 @@ description: Use when creating new skills, editing existing skills, or verifying
11
11
 
12
12
  **Personal skills live in agent-specific directories (`~/.claude/skills` for Claude Code, `~/.codex/skills` for Codex)**
13
13
 
14
- You write test cases (pressure scenarios with subagents), watch them fail (baseline behavior), write the skill (documentation), watch tests pass (agents comply), and refactor (close loopholes).
14
+ You write test cases (pressure scenarios with Task agents), watch them fail (baseline behavior), write the skill (documentation), watch tests pass (agents comply), and refactor (close loopholes).
15
15
 
16
16
  **Core principle:** If you didn't watch an agent fail without the skill, you don't know if the skill teaches the right thing.
17
17
 
@@ -31,7 +31,7 @@ A **skill** is a reference guide for proven techniques, patterns, or tools. Skil
31
31
 
32
32
  | TDD Concept | Skill Creation |
33
33
  |-------------|----------------|
34
- | **Test case** | Pressure scenario with subagent |
34
+ | **Test case** | Pressure scenario with Task agent |
35
35
  | **Production code** | Skill document (SKILL.md) |
36
36
  | **Test fails (RED)** | Agent violates rule without skill (baseline) |
37
37
  | **Test passes (GREEN)** | Agent complies with skill present |
@@ -159,7 +159,7 @@ When the description was changed to just "Use when executing implementation plan
159
159
 
160
160
  ```yaml
161
161
  # ❌ BAD: Summarizes workflow - Claude may follow this instead of reading skill
162
- description: Use when executing plans - dispatches subagent per task with code review between tasks
162
+ description: Use when executing plans - dispatches Task agent per task with code review between tasks
163
163
 
164
164
  # ❌ BAD: Too much process detail
165
165
  description: Use for TDD - write test first, watch it fail, write minimal code, refactor
@@ -233,11 +233,11 @@ search-conversations supports multiple modes and filters. Run --help for details
233
233
  **Use cross-references:**
234
234
  ```markdown
235
235
  # ❌ BAD: Repeat workflow details
236
- When searching, dispatch subagent with template...
236
+ When searching, dispatch Task agent with template...
237
237
  [20 lines of repeated instructions]
238
238
 
239
239
  # ✅ GOOD: Reference other skill
240
- Always use subagents (50-100x context savings). REQUIRED: Use [other-skill-name] for workflow.
240
+ Always use Task agents (50-100x context savings). REQUIRED: Use [other-skill-name] for workflow.
241
241
  ```
242
242
 
243
243
  **Compress examples:**
@@ -245,12 +245,12 @@ Always use subagents (50-100x context savings). REQUIRED: Use [other-skill-name]
245
245
  # ❌ BAD: Verbose example (42 words)
246
246
  your human partner: "How did we handle authentication errors in React Router before?"
247
247
  You: I'll search past conversations for React Router authentication patterns.
248
- [Dispatch subagent with search query: "React Router authentication error handling 401"]
248
+ [Dispatch Task agent with search query: "React Router authentication error handling 401"]
249
249
 
250
250
  # ✅ GOOD: Minimal example (20 words)
251
251
  Partner: "How did we handle auth errors in React Router?"
252
252
  You: Searching...
253
- [Dispatch subagent → synthesis]
253
+ [Dispatch Task agent → synthesis]
254
254
  ```
255
255
 
256
256
  **Eliminate redundancy:**
@@ -536,7 +536,7 @@ Follow the TDD cycle:
536
536
 
537
537
  ### RED: Write Failing Test (Baseline)
538
538
 
539
- Run pressure scenario with subagent WITHOUT the skill. Document exact behavior:
539
+ Run pressure scenario with Task agent WITHOUT the skill. Document exact behavior:
540
540
  - What choices did they make?
541
541
  - What rationalizations did they use (verbatim)?
542
542
  - Which pressures triggered violations?
@@ -181,7 +181,7 @@ For each variant:
181
181
 
182
182
  ## Next Steps
183
183
 
184
- 1. Create subagent test harness
184
+ 1. Create Task agent test harness
185
185
  2. Run NULL baseline on all 4 scenarios
186
186
  3. Test each variant on same scenarios
187
187
  4. Compare compliance rates
@@ -75,7 +75,7 @@ When searching, dispatch agent with template...
75
75
 
76
76
  # ✅ GOOD: Reference other skill
77
77
 
78
- Use subagents for searches. See [delegating-to-subagents] for workflow.
78
+ Use Task agents for searches. See [delegating-to-subagents] for workflow.
79
79
  ```
80
80
 
81
81
  **3. Compress examples**:
@@ -85,13 +85,13 @@ Use subagents for searches. See [delegating-to-subagents] for workflow.
85
85
 
86
86
  Partner: "How did we handle auth errors in React Router?"
87
87
  You: I'll search past conversations for patterns.
88
- [Dispatch subagent with query: "React Router authentication error handling 401"]
88
+ [Dispatch Task agent with query: "React Router authentication error handling 401"]
89
89
 
90
90
  # ✅ GOOD: Minimal (20 words)
91
91
 
92
92
  Partner: "Auth errors in React Router?"
93
93
  You: Searching...
94
- [Dispatch subagent → synthesis]
94
+ [Dispatch Task agent → synthesis]
95
95
  ```
96
96
 
97
97
  ## Keyword Strategy
@@ -1,4 +1,4 @@
1
- # Testing Skills With Subagents
1
+ # Testing Skills With Task Agents
2
2
 
3
3
  **Load this reference when:** creating or editing skills, before deployment, to verify they work under pressure and resist rationalization.
4
4