@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.
- package/merged-commands/application-performance-performance-optimization.md +13 -13
- package/merged-commands/ask/fast.md +14 -57
- package/merged-commands/ask/hard.md +22 -79
- package/merged-commands/auto.md +6 -33
- package/merged-commands/backend-development-feature-development.md +12 -12
- package/merged-commands/bootstrap/auto/fast.md +15 -15
- package/merged-commands/bootstrap/auto/parallel.md +12 -12
- package/merged-commands/bootstrap/auto.md +14 -14
- package/merged-commands/bootstrap.md +15 -15
- package/merged-commands/brainstorm/fast.md +19 -72
- package/merged-commands/brainstorm/hard.md +23 -84
- package/merged-commands/c4-architecture-c4-architecture.md +5 -5
- package/merged-commands/code/auto.md +16 -16
- package/merged-commands/code/fast.md +19 -72
- package/merged-commands/code/hard.md +38 -122
- package/merged-commands/code/no-test.md +12 -12
- package/merged-commands/code/parallel.md +9 -9
- package/merged-commands/code.md +14 -14
- package/merged-commands/comprehensive-review-full-review.md +8 -8
- package/merged-commands/context-degradation.md +2 -2
- package/merged-commands/context-engineering.md +4 -4
- package/merged-commands/context-optimization.md +3 -3
- package/merged-commands/cook/auto/fast.md +3 -3
- package/merged-commands/cook/auto/parallel.md +9 -9
- package/merged-commands/cook/auto.md +1 -1
- package/merged-commands/cook/fast.md +38 -47
- package/merged-commands/cook/hard.md +46 -41
- package/merged-commands/cook.md +13 -13
- package/merged-commands/daily-news-report.md +15 -15
- package/merged-commands/data-engineering-data-driven-feature.md +16 -16
- package/merged-commands/debug/fast.md +13 -29
- package/merged-commands/debug/hard.md +47 -49
- package/merged-commands/debug.md +1 -1
- package/merged-commands/debugging-toolkit-smart-debug.md +1 -1
- package/merged-commands/deploy/check.md +22 -71
- package/merged-commands/deploy/preview.md +18 -62
- package/merged-commands/deploy/production.md +22 -71
- package/merged-commands/deploy/rollback.md +22 -71
- package/merged-commands/deploy.md +0 -11
- package/merged-commands/design/3d.md +3 -3
- package/merged-commands/design/describe.md +1 -1
- package/merged-commands/design/fast.md +2 -2
- package/merged-commands/design/good.md +3 -3
- package/merged-commands/design/hard.md +15 -85
- package/merged-commands/design/screenshot.md +1 -1
- package/merged-commands/design/video.md +1 -1
- package/merged-commands/design.md +0 -11
- package/merged-commands/doc-coauthoring.md +5 -5
- package/merged-commands/docker-expert.md +1 -1
- package/merged-commands/docs/audit.md +26 -77
- package/merged-commands/docs/business.md +26 -77
- package/merged-commands/docs/core.md +24 -68
- package/merged-commands/docs/init.md +8 -8
- package/merged-commands/docs/update.md +13 -13
- package/merged-commands/docs.md +0 -12
- package/merged-commands/error-debugging-multi-agent-review.md +1 -1
- package/merged-commands/error-diagnostics-smart-debug.md +1 -1
- package/merged-commands/finishing-a-development-branch.md +1 -1
- package/merged-commands/fix/ci.md +2 -2
- package/merged-commands/fix/fast.md +2 -2
- package/merged-commands/fix/hard.md +6 -6
- package/merged-commands/fix/logs.md +5 -5
- package/merged-commands/fix/parallel.md +9 -9
- package/merged-commands/fix/test.md +6 -6
- package/merged-commands/fix/ui.md +8 -8
- package/merged-commands/fixing.md +3 -3
- package/merged-commands/framework-migration-legacy-modernize.md +13 -13
- package/merged-commands/full-stack-orchestration-full-stack-feature.md +12 -12
- package/merged-commands/git/cm.md +1 -1
- package/merged-commands/git/cp.md +1 -1
- package/merged-commands/git/merge.md +1 -1
- package/merged-commands/git/pr.md +1 -1
- package/merged-commands/git-pr-workflows-git-workflow.md +10 -10
- package/merged-commands/google-adk-python.md +1 -1
- package/merged-commands/hr-pro.md +1 -1
- package/merged-commands/incident-response-incident-response.md +13 -13
- package/merged-commands/integrate/polar.md +3 -3
- package/merged-commands/integrate/sepay.md +3 -3
- package/merged-commands/journal.md +1 -1
- package/merged-commands/learn.md +51 -4
- package/merged-commands/linear-claude-skill.md +2 -2
- package/merged-commands/loki-mode.md +14 -14
- package/merged-commands/machine-learning-ops-ml-pipeline.md +7 -7
- package/merged-commands/mcp-management.md +8 -8
- package/merged-commands/multi-agent-patterns.md +14 -14
- package/merged-commands/multi-platform-apps-multi-platform.md +10 -10
- package/merged-commands/nestjs-expert.md +1 -1
- package/merged-commands/performance-testing-review-multi-agent-review.md +1 -1
- package/merged-commands/plan/archive.md +1 -1
- package/merged-commands/plan/ci.md +1 -1
- package/merged-commands/plan/fast.md +2 -2
- package/merged-commands/plan/hard.md +4 -4
- package/merged-commands/plan/parallel.md +5 -5
- package/merged-commands/plan/two.md +6 -6
- package/merged-commands/requesting-code-review.md +6 -6
- package/merged-commands/review/codebase/parallel.md +5 -5
- package/merged-commands/review/codebase.md +5 -5
- package/merged-commands/review/fast.md +13 -29
- package/merged-commands/review/hard.md +48 -49
- package/merged-commands/review.md +0 -11
- package/merged-commands/security-scanning-security-hardening.md +13 -13
- package/merged-commands/skill/add.md +6 -6
- package/merged-commands/skill/create.md +6 -6
- package/merged-commands/skill/fix-logs.md +6 -6
- package/merged-commands/skill/optimize/auto.md +1 -1
- package/merged-commands/skill/optimize.md +1 -1
- package/merged-commands/skill/plan.md +1 -1
- package/merged-commands/skill/update.md +6 -6
- package/merged-commands/subagent-driven-development.md +53 -53
- package/merged-commands/tdd-workflows-tdd-cycle.md +12 -12
- package/merged-commands/tdd-workflows-tdd-red.md +1 -1
- package/merged-commands/tdd-workflows-tdd-refactor.md +1 -1
- package/merged-commands/test/fast.md +22 -33
- package/merged-commands/test/hard.md +59 -56
- package/merged-commands/test/ui.md +1 -1
- package/merged-commands/test.md +1 -1
- package/merged-commands/typescript-expert.md +1 -1
- package/merged-commands/use-mcp.md +5 -5
- package/merged-commands/writing-plans.md +3 -3
- package/merged-commands/writing-skills.md +8 -8
- package/package.json +1 -1
- package/rules-index.json +1 -1
- package/skills/application-performance-performance-optimization/SKILL.md +13 -13
- package/skills/azure-ai-agents-python/references/tools.md +1 -1
- package/skills/backend-development-feature-development/SKILL.md +12 -12
- package/skills/best-practices/references/anti-patterns.md +2 -2
- package/skills/best-practices/references/best-practices-guide.md +14 -14
- package/skills/c4-architecture-c4-architecture/SKILL.md +5 -5
- package/skills/comprehensive-review-full-review/SKILL.md +8 -8
- package/skills/context-degradation/SKILL.md +2 -2
- package/skills/context-engineering/SKILL.md +4 -4
- package/skills/context-engineering/references/context-degradation.md +1 -1
- package/skills/context-engineering/references/context-optimization.md +1 -1
- package/skills/context-engineering/references/multi-agent-patterns.md +1 -1
- package/skills/context-engineering/references/runtime-awareness.md +1 -1
- package/skills/context-optimization/SKILL.md +3 -3
- package/skills/daily-news-report/SKILL.md +15 -15
- package/skills/data-engineering-data-driven-feature/SKILL.md +16 -16
- package/skills/debugging-toolkit-smart-debug/SKILL.md +1 -1
- package/skills/doc-coauthoring/SKILL.md +5 -5
- package/skills/docker-expert/SKILL.md +1 -1
- package/skills/error-debugging-multi-agent-review/SKILL.md +1 -1
- package/skills/error-diagnostics-smart-debug/SKILL.md +1 -1
- package/skills/finishing-a-development-branch/SKILL.md +1 -1
- package/skills/fixing/SKILL.md +3 -3
- package/skills/fixing/references/parallel-exploration.md +4 -4
- package/skills/fixing/references/skill-activation-matrix.md +3 -3
- package/skills/fixing/references/workflow-deep.md +11 -11
- package/skills/fixing/references/workflow-quick.md +4 -4
- package/skills/fixing/references/workflow-standard.md +12 -12
- package/skills/framework-migration-legacy-modernize/SKILL.md +13 -13
- package/skills/full-stack-orchestration-full-stack-feature/SKILL.md +12 -12
- package/skills/git-pr-workflows-git-workflow/SKILL.md +10 -10
- package/skills/google-adk-python/SKILL.md +1 -1
- package/skills/hr-pro/SKILL.md +1 -1
- package/skills/incident-response-incident-response/SKILL.md +13 -13
- package/skills/incident-response-smart-fix/resources/implementation-playbook.md +17 -17
- package/skills/learn/SKILL.md +51 -4
- package/skills/linear-claude-skill/SKILL.md +2 -2
- package/skills/loki-mode/ACKNOWLEDGEMENTS.md +4 -4
- package/skills/loki-mode/CHANGELOG.md +9 -9
- package/skills/loki-mode/CONTEXT-EXPORT.md +1 -1
- package/skills/loki-mode/README.md +2 -2
- package/skills/loki-mode/SKILL.md +14 -14
- package/skills/loki-mode/autonomy/run.sh +1 -1
- package/skills/loki-mode/integrations/vibe-kanban.md +1 -1
- package/skills/loki-mode/references/core-workflow.md +4 -4
- package/skills/loki-mode/references/production-patterns.md +6 -6
- package/skills/loki-mode/references/quality-control.md +2 -2
- package/skills/loki-mode/references/sdlc-phases.md +3 -3
- package/skills/machine-learning-ops-ml-pipeline/SKILL.md +7 -7
- package/skills/mcp-builder/reference/evaluation.md +3 -3
- package/skills/mcp-management/README.md +6 -6
- package/skills/mcp-management/SKILL.md +8 -8
- package/skills/mcp-management/references/gemini-cli-integration.md +1 -1
- package/skills/multi-agent-patterns/SKILL.md +14 -14
- package/skills/multi-platform-apps-multi-platform/SKILL.md +10 -10
- package/skills/nestjs-expert/SKILL.md +1 -1
- package/skills/performance-testing-review-multi-agent-review/SKILL.md +1 -1
- package/skills/planning-with-files/reference.md +2 -2
- package/skills/requesting-code-review/SKILL.md +6 -6
- package/skills/security-scanning-security-hardening/SKILL.md +13 -13
- package/skills/subagent-driven-development/SKILL.md +53 -53
- package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +1 -1
- package/skills/subagent-driven-development/implementer-prompt.md +3 -3
- package/skills/subagent-driven-development/spec-reviewer-prompt.md +1 -1
- package/skills/tdd-workflows-tdd-cycle/SKILL.md +12 -12
- package/skills/tdd-workflows-tdd-green/resources/implementation-playbook.md +1 -1
- package/skills/tdd-workflows-tdd-red/SKILL.md +1 -1
- package/skills/tdd-workflows-tdd-refactor/SKILL.md +1 -1
- package/skills/typescript-expert/SKILL.md +1 -1
- package/skills/writing-plans/SKILL.md +3 -3
- package/skills/writing-skills/SKILL.md +8 -8
- package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +1 -1
- package/skills/writing-skills/references/cso/README.md +3 -3
- 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
|
-
#
|
|
8
|
+
# Task Agent-Driven Development
|
|
9
9
|
|
|
10
|
-
Execute plan by dispatching fresh
|
|
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
|
|
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
|
|
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
|
|
49
|
-
"Implementer
|
|
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
|
|
52
|
-
"Dispatch spec reviewer
|
|
53
|
-
"Spec reviewer
|
|
54
|
-
"Implementer
|
|
55
|
-
"Dispatch code quality reviewer
|
|
56
|
-
"Code quality reviewer
|
|
57
|
-
"Implementer
|
|
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
|
|
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
|
|
67
|
-
"Dispatch implementer
|
|
68
|
-
"Implementer
|
|
69
|
-
"Answer questions, provide context" -> "Dispatch implementer
|
|
70
|
-
"Implementer
|
|
71
|
-
"Implementer
|
|
72
|
-
"Dispatch spec reviewer
|
|
73
|
-
"Spec reviewer
|
|
74
|
-
"Implementer
|
|
75
|
-
"Spec reviewer
|
|
76
|
-
"Dispatch code quality reviewer
|
|
77
|
-
"Code quality reviewer
|
|
78
|
-
"Implementer
|
|
79
|
-
"Code quality reviewer
|
|
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
|
|
82
|
-
"More tasks remain?" -> "Dispatch final code reviewer
|
|
83
|
-
"Dispatch final code reviewer
|
|
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
|
|
90
|
-
- `./spec-reviewer-prompt.md` - Dispatch spec compliance reviewer
|
|
91
|
-
- `./code-quality-reviewer-prompt.md` - Dispatch code quality reviewer
|
|
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
|
|
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
|
|
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
|
|
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
|
-
-
|
|
172
|
+
- Task agents follow TDD naturally
|
|
173
173
|
- Fresh context per task (no confusion)
|
|
174
|
-
- Parallel-safe (
|
|
175
|
-
-
|
|
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
|
-
-
|
|
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
|
|
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
|
|
207
|
-
- Make
|
|
208
|
-
- Skip scene-setting context (
|
|
209
|
-
- Ignore
|
|
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
|
|
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
|
|
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
|
|
228
|
-
- Dispatch fix
|
|
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
|
|
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
|
-
**
|
|
239
|
-
- **superpowers:test-driven-development** -
|
|
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
|
|
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
|
|
1
|
+
# Implementer Task Agent Prompt Template
|
|
2
2
|
|
|
3
|
-
Use this template when dispatching an implementer
|
|
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
|
|
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
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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
|
|
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.
|
|
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
|
|
111
|
+
**If Task Agent-Driven chosen:**
|
|
112
112
|
- **REQUIRED SUB-SKILL:** Use superpowers:subagent-driven-development
|
|
113
113
|
- Stay in this session
|
|
114
|
-
- Fresh
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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?
|
|
@@ -75,7 +75,7 @@ When searching, dispatch agent with template...
|
|
|
75
75
|
|
|
76
76
|
# ✅ GOOD: Reference other skill
|
|
77
77
|
|
|
78
|
-
Use
|
|
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
|
|
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
|
|
94
|
+
[Dispatch Task agent → synthesis]
|
|
95
95
|
```
|
|
96
96
|
|
|
97
97
|
## Keyword Strategy
|