@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
@@ -31,7 +31,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
31
31
  ## Phase 1: Architecture and API Design (Sequential)
32
32
 
33
33
  ### 1. Define Feature Requirements and API Contracts
34
- - Use Task tool with subagent_type="backend-architect"
34
+ - Use Task tool with subagent_type="general-purpose"
35
35
  - Prompt: "Design the API contract for feature: $ARGUMENTS. Create OpenAPI 3.1 specification with:
36
36
  - RESTful endpoints with proper HTTP methods and status codes
37
37
  - GraphQL schema if applicable for complex data queries
@@ -44,7 +44,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
44
44
  - Expected output: Complete API specification, data models, and integration guidelines
45
45
 
46
46
  ### 2. Design System and UI/UX Consistency
47
- - Use Task tool with subagent_type="ui-ux-designer"
47
+ - Use Task tool with subagent_type="general-purpose"
48
48
  - Prompt: "Create cross-platform design system for feature using API spec: [previous output]. Include:
49
49
  - Component specifications for each platform (Material Design, iOS HIG, Fluent)
50
50
  - Responsive layouts for web (mobile-first approach)
@@ -57,7 +57,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
57
57
  - Expected output: Design system documentation, component library specs, platform guidelines
58
58
 
59
59
  ### 3. Shared Business Logic Architecture
60
- - Use Task tool with subagent_type="comprehensive-review::architect-review"
60
+ - Use Task tool with subagent_type="general-purpose"
61
61
  - Prompt: "Design shared business logic architecture for cross-platform feature. Define:
62
62
  - Core domain models and entities (platform-agnostic)
63
63
  - Business rules and validation logic
@@ -72,7 +72,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
72
72
  ## Phase 2: Parallel Platform Implementation
73
73
 
74
74
  ### 4a. Web Implementation (React/Next.js)
75
- - Use Task tool with subagent_type="frontend-developer"
75
+ - Use Task tool with subagent_type="general-purpose"
76
76
  - Prompt: "Implement web version of feature using:
77
77
  - React 18+ with Next.js 14+ App Router
78
78
  - TypeScript for type safety
@@ -87,7 +87,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
87
87
  - Expected output: Complete web implementation with tests
88
88
 
89
89
  ### 4b. iOS Implementation (SwiftUI)
90
- - Use Task tool with subagent_type="ios-developer"
90
+ - Use Task tool with subagent_type="general-purpose"
91
91
  - Prompt: "Implement iOS version using:
92
92
  - SwiftUI with iOS 17+ features
93
93
  - Swift 5.9+ with async/await
@@ -102,7 +102,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
102
102
  - Expected output: Native iOS implementation with unit/UI tests
103
103
 
104
104
  ### 4c. Android Implementation (Kotlin/Compose)
105
- - Use Task tool with subagent_type="mobile-developer"
105
+ - Use Task tool with subagent_type="general-purpose"
106
106
  - Prompt: "Implement Android version using:
107
107
  - Jetpack Compose with Material 3
108
108
  - Kotlin coroutines and Flow
@@ -117,7 +117,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
117
117
  - Expected output: Native Android implementation with tests
118
118
 
119
119
  ### 4d. Desktop Implementation (Optional - Electron/Tauri)
120
- - Use Task tool with subagent_type="frontend-mobile-development::frontend-developer"
120
+ - Use Task tool with subagent_type="general-purpose"
121
121
  - Prompt: "Implement desktop version using Tauri 2.0 or Electron with:
122
122
  - Shared web codebase where possible
123
123
  - Native OS integration (system tray, notifications)
@@ -133,7 +133,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
133
133
  ## Phase 3: Integration and Validation
134
134
 
135
135
  ### 5. API Documentation and Testing
136
- - Use Task tool with subagent_type="documentation-generation::api-documenter"
136
+ - Use Task tool with subagent_type="general-purpose"
137
137
  - Prompt: "Create comprehensive API documentation including:
138
138
  - Interactive OpenAPI/Swagger documentation
139
139
  - Platform-specific integration guides
@@ -149,7 +149,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
149
149
  - Expected output: Complete API documentation portal, test results
150
150
 
151
151
  ### 6. Cross-Platform Testing and Feature Parity
152
- - Use Task tool with subagent_type="unit-testing::test-automator"
152
+ - Use Task tool with subagent_type="general-purpose"
153
153
  - Prompt: "Validate feature parity across all platforms:
154
154
  - Functional testing matrix (features work identically)
155
155
  - UI consistency verification (follows design system)
@@ -164,7 +164,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
164
164
  - Expected output: Test report, parity matrix, performance metrics
165
165
 
166
166
  ### 7. Platform-Specific Optimizations
167
- - Use Task tool with subagent_type="application-performance::performance-engineer"
167
+ - Use Task tool with subagent_type="general-purpose"
168
168
  - Prompt: "Optimize each platform implementation:
169
169
  - Web: Bundle size, lazy loading, CDN setup, SEO
170
170
  - iOS: App size, launch time, memory usage, battery
@@ -20,7 +20,7 @@ You are an expert in Nest.js with deep knowledge of enterprise-grade Node.js app
20
20
  - Node.js runtime issues → nodejs-expert
21
21
  - Frontend React issues → react-expert
22
22
 
23
- Example: "This is a TypeScript type system issue. Use the typescript-type-expert subagent. Stopping here."
23
+ Example: "This is a TypeScript type system issue. Use the typescript-type-expert Task agent. Stopping here."
24
24
 
25
25
  1. Detect Nest.js project setup using internal tools first (Read, Grep, Glob)
26
26
  2. Identify architecture patterns and existing modules
@@ -59,7 +59,7 @@ The Multi-Agent Review Tool leverages a distributed, specialized agent network t
59
59
  - **Dynamic Agent Matching**:
60
60
  - Analyze input characteristics
61
61
  - Select most appropriate agent types
62
- - Configure specialized sub-agents dynamically
62
+ - Configure specialized Task agents dynamically
63
63
  - **Expertise Routing**:
64
64
  ```python
65
65
  def route_agents(code_context):
@@ -23,7 +23,7 @@ Use `AskUserQuestion` tool to ask if user wants to document journal entries or n
23
23
  Skip this step if user selects "No".
24
24
  If user selects "Yes":
25
25
  - Analyze the information in previous steps.
26
- - Use Task tool with `subagent_type="journal-writer"` in parallel to document all plans.
26
+ - Use Task tool with `subagent_type="general-purpose"` in parallel to document all plans: Task(subagent_type="general-purpose", prompt="You are a journal-writer. Document these plans...", description="Write journal entries")
27
27
  - Journal entries should be concise and focused on the most important events, key changes, impacts, and decisions.
28
28
  - Keep journal entries in the `./docs/journals/` directory.
29
29
 
@@ -8,7 +8,7 @@ Activate `planning` skill.
8
8
  ## Github Actions URL
9
9
  $ARGUMENTS
10
10
 
11
- Use the `planner` subagent to read the github actions logs, analyze and find the root causes of the issues, then provide a detailed plan for implementing the fixes.
11
+ Use a Task agent for planning to read the github actions logs, analyze and find the root causes of the issues, then provide a detailed plan for implementing the fixes: Task(subagent_type="general-purpose", prompt="You are a planner. Read github actions logs, analyze root causes, create fix plan...", description="Analyze CI logs and plan fixes")
12
12
 
13
13
  **Plan File Specification:**
14
14
  - Every `plan.md` MUST start with YAML frontmatter:
@@ -19,10 +19,10 @@ Check the `## Plan Context` section in the injected context:
19
19
  - If "Plan: none" → Create new plan using naming from `## Naming` section.
20
20
 
21
21
  ## Workflow
22
- Use `planner` subagent to:
22
+ Use Task agent for planning: Task(subagent_type="general-purpose", prompt="You are a planner. Create implementation plan...", description="Create plan") to:
23
23
  1. If creating new: Create directory using `Plan dir:` from `## Naming` section, then run `node .claude/scripts/set-active-plan.cjs {plan-dir}`
24
24
  If reusing: Use the active plan path from Plan Context.
25
- Make sure you pass the directory path to every subagent during the process.
25
+ Make sure you pass the directory path to every Task agent during the process.
26
26
  2. Follow strictly to the "Plan Creation & Organization" rules of `planning` skill.
27
27
  3. Analyze the codebase by reading `codebase-summary.md`, `code-standards.md`, `system-architecture.md` and `project-overview-pdr.md` file.
28
28
  4. Gathers all information and create an implementation plan of this task.
@@ -21,14 +21,14 @@ Check the `## Plan Context` section in the injected context:
21
21
  ## Workflow
22
22
  1. If creating new: Create directory using `Plan dir:` from `## Naming` section, then run `node .claude/scripts/set-active-plan.cjs {plan-dir}`
23
23
  If reusing: Use the active plan path from Plan Context.
24
- Make sure you pass the directory path to every subagent during the process.
24
+ Make sure you pass the directory path to every Task agent during the process.
25
25
  2. Follow strictly to the "Plan Creation & Organization" rules of `planning` skill.
26
- 3. Use multiple `researcher` agents (max 2 agents) in parallel to research for this task:
26
+ 3. Use multiple Task agents for research (max 2 agents) in parallel to research for this task: Task(subagent_type="general-purpose", prompt="You are a researcher. Research [aspect]...", description="Research [topic]")
27
27
  Each agent research for a different aspect of the task and are allowed to perform max 5 tool calls.
28
28
  4. Analyze the codebase by reading `codebase-summary.md`, `code-standards.md`, `system-architecture.md` and `project-overview-pdr.md` file.
29
29
  **ONLY PERFORM THIS FOLLOWING STEP IF `codebase-summary.md` is not available or older than 3 days**: Use `/scout <instructions>` slash command to search the codebase for files needed to complete the task.
30
- 5. Main agent gathers all research and scout report filepaths, and pass them to `planner` subagent with the prompt to create an implementation plan of this task.
31
- 6. Main agent receives the implementation plan from `planner` subagent, and ask user to review the plan
30
+ 5. Main agent gathers all research and scout report filepaths, and pass them to Task agent for planning with the prompt to create an implementation plan of this task: Task(subagent_type="general-purpose", prompt="You are a planner. Create implementation plan based on research and scout reports...", description="Create implementation plan")
31
+ 6. Main agent receives the implementation plan from Task agent, and ask user to review the plan
32
32
 
33
33
  ## Post-Plan Validation (Optional)
34
34
 
@@ -13,14 +13,14 @@ $ARGUMENTS
13
13
 
14
14
  ## Workflow
15
15
  1. Create a directory using naming pattern from `## Naming` section in injected context.
16
- Make sure you pass the directory path to every subagent during the process.
16
+ Make sure you pass the directory path to every Task agent during the process.
17
17
  2. Follow strictly to the "Plan Creation & Organization" rules of `planning` skill.
18
- 3. Use multiple `researcher` agents (max 2 agents) in parallel to research for this task:
18
+ 3. Use multiple Task agents for research (max 2 agents) in parallel to research for this task: Task(subagent_type="general-purpose", prompt="You are a researcher. Research [aspect]...", description="Research [topic]")
19
19
  Each agent research for a different aspect of the task and are allowed to perform max 5 tool calls.
20
20
  4. Analyze the codebase by reading `codebase-summary.md`, `code-standards.md`, `system-architecture.md` and `project-overview-pdr.md` file.
21
21
  **ONLY PERFORM THIS FOLLOWING STEP IF `codebase-summary.md` is not available or older than 3 days**: Use `/scout <instructions>` slash command to search the codebase for files needed to complete the task.
22
- 5. Main agent gathers all research and scout report filepaths, and pass them to `planner` subagent with the prompt to create a parallel-optimized implementation plan.
23
- 6. Main agent receives the implementation plan from `planner` subagent, and ask user to review the plan
22
+ 5. Main agent gathers all research and scout report filepaths, and pass them to Task agent for planning with the prompt to create a parallel-optimized implementation plan: Task(subagent_type="general-purpose", prompt="You are a planner. Create parallel-optimized implementation plan...", description="Create parallel plan")
23
+ 6. Main agent receives the implementation plan from Task agent, and ask user to review the plan
24
24
 
25
25
  ## Post-Plan Validation (Optional)
26
26
 
@@ -39,7 +39,7 @@ After plan creation, offer validation interview to confirm decisions before impl
39
39
 
40
40
  ## Special Requirements for Parallel Execution
41
41
 
42
- **CRITICAL:** The planner subagent must create phases that:
42
+ **CRITICAL:** The Task agent for planning must create phases that:
43
43
  1. **Can be executed independently** - Each phase should be self-contained with no runtime dependencies on other phases
44
44
  2. **Have clear boundaries** - No file overlap between phases (each file should only be modified in ONE phase)
45
45
  3. **Separate concerns logically** - Group by architectural layer, feature domain, or technology stack
@@ -7,20 +7,20 @@ Think harder.
7
7
  Activate `planning` skill.
8
8
 
9
9
  ## Your mission
10
- Use the `planner` subagent to create 2 detailed implementation plans for this following task:
10
+ Use the Task agent for planning to create 2 detailed implementation plans for this following task: Task(subagent_type="general-purpose", prompt="You are a planner. Create 2 implementation plans...", description="Create dual plans")
11
11
  <task>
12
12
  $ARGUMENTS
13
13
  </task>
14
14
 
15
15
  ## Workflow
16
16
  1. First: Create a directory using naming pattern from `## Naming` section in injected context.
17
- Make sure you pass the directory path to every subagent during the process.
17
+ Make sure you pass the directory path to every Task agent during the process.
18
18
  2. Follow strictly to the "Plan Creation & Organization" rules of `planning` skill.
19
- 3. Use multiple `researcher` agents in parallel to research for this task, each agent research for a different aspect of the task and perform max 5 researches (max 5 tool calls).
20
- 4. Use `scout` agent to search the codebase for files needed to complete the task.
21
- 5. Main agent gathers all research and scout report filepaths, and pass them to `planner` subagent with the detailed instructions prompt to create an implementation plan of this task.
19
+ 3. Use multiple Task agents for research in parallel to research for this task, each agent research for a different aspect of the task and perform max 5 researches (max 5 tool calls): Task(subagent_type="general-purpose", prompt="You are a researcher. Research [aspect]...", description="Research [topic]")
20
+ 4. Use Task agent for scouting to search the codebase for files needed to complete the task: Task(subagent_type="general-purpose", prompt="You are a scout. Search codebase...", description="Scout codebase")
21
+ 5. Main agent gathers all research and scout report filepaths, and pass them to Task agent for planning with the detailed instructions prompt to create an implementation plan of this task: Task(subagent_type="general-purpose", prompt="You are a planner. Create implementation plan...", description="Create plan")
22
22
  **Output:** Provide at least 2 implementation approaches with clear trade-offs, and explain the pros and cons of each approach, and provide a recommended approach.
23
- 1. Main agent receives the implementation plan from `planner` subagent, and ask user to review the plan
23
+ 1. Main agent receives the implementation plan from Task agent, and ask user to review the plan
24
24
 
25
25
  ## Plan File Specification
26
26
  - Every `plan.md` MUST start with YAML frontmatter:
@@ -7,14 +7,14 @@ source: community
7
7
 
8
8
  # Requesting Code Review
9
9
 
10
- Dispatch superpowers:code-reviewer subagent to catch issues before they cascade.
10
+ Dispatch superpowers:code-reviewer Task agent to catch issues before they cascade.
11
11
 
12
12
  **Core principle:** Review early, review often.
13
13
 
14
14
  ## When to Request Review
15
15
 
16
16
  **Mandatory:**
17
- - After each task in subagent-driven development
17
+ - After each task in Task agent-driven development
18
18
  - After completing major feature
19
19
  - Before merge to main
20
20
 
@@ -31,7 +31,7 @@ BASE_SHA=$(git rev-parse HEAD~1) # or origin/main
31
31
  HEAD_SHA=$(git rev-parse HEAD)
32
32
  ```
33
33
 
34
- **2. Dispatch code-reviewer subagent:**
34
+ **2. Dispatch code-reviewer Task agent:**
35
35
 
36
36
  Use Task tool with superpowers:code-reviewer type, fill template at `code-reviewer.md`
37
37
 
@@ -58,14 +58,14 @@ You: Let me request code review before proceeding.
58
58
  BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | awk '{print $1}')
59
59
  HEAD_SHA=$(git rev-parse HEAD)
60
60
 
61
- [Dispatch superpowers:code-reviewer subagent]
61
+ [Dispatch superpowers:code-reviewer Task agent]
62
62
  WHAT_WAS_IMPLEMENTED: Verification and repair functions for conversation index
63
63
  PLAN_OR_REQUIREMENTS: Task 2 from docs/plans/deployment-plan.md
64
64
  BASE_SHA: a7981ec
65
65
  HEAD_SHA: 3df7661
66
66
  DESCRIPTION: Added verifyIndex() and repairIndex() with 4 issue types
67
67
 
68
- [Subagent returns]:
68
+ [Task agent returns]:
69
69
  Strengths: Clean architecture, real tests
70
70
  Issues:
71
71
  Important: Missing progress indicators
@@ -78,7 +78,7 @@ You: [Fix progress indicators]
78
78
 
79
79
  ## Integration with Workflows
80
80
 
81
- **Subagent-Driven Development:**
81
+ **Task Agent-Driven Development:**
82
82
  - Review after EACH task
83
83
  - Catch issues before they compound
84
84
  - Fix before moving to next task
@@ -3,7 +3,7 @@ description: ⚡⚡⚡ Ultrathink edge cases, then parallel verify with code-rev
3
3
  argument-hint: [scope-or-prompt]
4
4
  ---
5
5
 
6
- **Ultrathink** to exhaustively list ALL potential edge cases, then dispatch parallel `code-reviewer` agents to verify: <scope>$ARGUMENTS</scope>
6
+ **Ultrathink** to exhaustively list ALL potential edge cases, then dispatch parallel Task agents for code review to verify: <scope>$ARGUMENTS</scope>
7
7
 
8
8
  **IMPORTANT:** Activate needed skills. Ensure token efficiency. Sacrifice grammar for concision.
9
9
 
@@ -39,13 +39,13 @@ Main agent deeply analyzes the scope to LIST all potential edge cases FIRST:
39
39
  ### 2. Categorize & Assign
40
40
 
41
41
  Group edge cases by similar scope for parallel verification:
42
- - Each category → one `code-reviewer` agent
42
+ - Each category → one Task agent for code review
43
43
  - Max 6 categories (merge small ones)
44
44
  - Each reviewer gets specific edge cases to VERIFY, not discover
45
45
 
46
46
  ### 3. Parallel Verification
47
47
 
48
- Launch N `code-reviewer` subagents simultaneously:
48
+ Launch N Task agents for code review simultaneously: Task(subagent_type="general-purpose", prompt="You are a code-reviewer. Verify these edge cases...", description="Verify edge cases for [category]")
49
49
  - Pass: category name, list of edge cases, relevant files
50
50
  - Task: **VERIFY** if each edge case is properly handled in code
51
51
  - Report: which edge cases are handled vs unhandled
@@ -93,7 +93,7 @@ Collect all verification reports:
93
93
  ### 6. Final Report
94
94
 
95
95
  - Summary of verification
96
- - Ask: "Commit? [Y/n]" → use `git-manager`
96
+ - Ask: "Commit? [Y/n]" → use Task agent for git management
97
97
 
98
98
  ## Example
99
99
 
@@ -112,7 +112,7 @@ User: /review:codebase:parallel auth module
112
112
  - Token handling (5 cases)
113
113
  - Session management (3 cases)
114
114
 
115
- 3. Parallel → 3 code-reviewers verify simultaneously
115
+ 3. Parallel → 3 Task agents for code review verify simultaneously
116
116
 
117
117
  4. Aggregate → 8 handled, 3 unhandled, 1 partial
118
118
 
@@ -3,7 +3,7 @@ description: ⚡⚡⚡ Scan & analyze the codebase.
3
3
  argument-hint: [tasks-or-prompt]
4
4
  ---
5
5
 
6
- Think harder to scan the codebase and analyze it follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
+ Think harder to scan the codebase and analyze it follow the Orchestration Protocol, Core Responsibilities, and Development Rules:
7
7
  <tasks>$ARGUMENTS</tasks>
8
8
 
9
9
  ---
@@ -22,26 +22,26 @@ Think harder to scan the codebase and analyze it follow the Orchestration Protoc
22
22
 
23
23
  ### Research
24
24
 
25
- * Use 2 `researcher` subagents in parallel to search up to max 5 sources for the user's request, idea validation, best practices, challenges, and find the best possible solutions.
25
+ * Use 2 Task agents in parallel to search up to max 5 sources for the user's request, idea validation, best practices, challenges, and find the best possible solutions: Task(subagent_type="general-purpose", prompt="You are a researcher. Search for...", description="Research [topic]")
26
26
  * Keep every research markdown report concise (≤150 lines) while covering all requested topics and citations.
27
27
  * Use `/scout:ext` (preferred) or `/scout` (fallback) slash command to search the codebase for files needed to complete the task
28
28
 
29
29
  ### Code Review
30
30
 
31
- * After finishing, use multiple `code-reviewer` subagents in parallel to review code.
31
+ * After finishing, use multiple Task agents in parallel to review code: Task(subagent_type="general-purpose", prompt="You are a code-reviewer. Review...", description="Code review")
32
32
  * If there are any issues, duplicate code, or security vulnerabilities, ask main agent to improve the code and repeat the "Testing" process until all tests pass.
33
33
  * When all tests pass, code is reviewed, the tasks are completed, report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
34
34
  * **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
35
35
 
36
36
  ### Plan
37
- * Use `planner` subagent to analyze reports from `researcher` and `scout` subagents to create an improvement plan following the progressive disclosure structure:
37
+ * Use Task agent to analyze reports from researcher and scout Task agents to create an improvement plan following the progressive disclosure structure: Task(subagent_type="general-purpose", prompt="You are a planner. Analyze reports and create improvement plan...", description="Create improvement plan")
38
38
  - Create a directory using naming pattern from `## Naming` section.
39
39
  - Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
40
40
  - For each phase, add `phase-XX-phase-name.md` files containing sections (Context links, Overview with date/priority/statuses, Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps).
41
41
 
42
42
  ### Final Report
43
43
  * Report back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
44
- * Ask the user if they want to commit and push to git repository, if yes, use `git-manager` subagent to commit and push to git repository.
44
+ * Ask the user if they want to commit and push to git repository, if yes, use Task agent to commit and push to git repository: Task(subagent_type="general-purpose", prompt="You are a git-manager. Commit and push...", description="Git commit and push")
45
45
 
46
46
  **REMEMBER**:
47
47
  - You can always generate images with `ai-multimodal` skill on the fly for visual assets.
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Quick Review — Fast PR/file review
2
+ description: Quick Review — Fast PR/file review
3
3
  version: "1.0"
4
4
  category: validation
5
5
  execution-mode: execute
@@ -13,38 +13,22 @@ execution-mode: execute
13
13
 
14
14
  ---
15
15
 
16
- ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
17
-
18
- **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
- 1. ORCHESTRATION-LAWS.md
20
- 2. ADAPTIVE-EXECUTION.md
21
- 3. EXECUTION-PROTOCOL.md
22
-
23
- **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
24
-
25
- ---
26
-
27
- ## 🔀 TIERED EXECUTION
28
-
29
- | Tier | When | Action |
30
- |------|------|--------|
31
- | **TIER 1** | runSubagent EXISTS | Invoke sub-agent (MANDATORY) |
32
- | **TIER 2** | Tool MISSING | EMBODY agent file (FALLBACK) |
16
+ ## Execution
17
+ One phase at a time, sequential. Each phase must complete before next begins.
33
18
 
34
19
  ---
35
20
 
36
- ## INCREMENTAL EXECUTION (MANDATORY)
21
+ ## Phase 1: CODE REVIEW
37
22
 
38
- One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in one reply. No batching (load only what each phase needs). **Within each phase:** when doing a part, output it in format so user sees what’s happening (announce before doing).
39
-
40
- ---
23
+ | Attribute | Value |
24
+ |-----------|-------|
25
+ | **Role** | `reviewer` |
26
+ | **Goal** | Review code quality |
27
+ | **Exit** | Issues documented, recommendations provided |
41
28
 
42
- ## 🎭 Phase 1: CODE REVIEW
29
+ ### Delegation
43
30
 
44
- | Agent | `reviewer` |
45
- |-------|------------|
46
- | Goal | Review code quality |
47
- | Exit | Issues documented, recommendations provided |
31
+ > Task(subagent_type="general-purpose", prompt="You are a reviewer. Review code quality. Exit when issues are documented and recommendations are provided.", description="reviewer: Review code quality")
48
32
 
49
33
  ---
50
34
 
@@ -61,5 +45,5 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
61
45
 
62
46
  Present review with:
63
47
 
64
- 1. **Approved** — Code ready
65
- 2. 🔧 **Fix needed** → `/fix:fast`
48
+ 1. **Approved** — Code ready
49
+ 2. **Fix needed** → `/fix:fast`
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: ⚡⚡⚡ Full Review — Deep code analysis with architecture review
2
+ description: Full Review — Deep code analysis with architecture review
3
3
  version: "1.0"
4
4
  category: validation
5
5
  execution-mode: execute
@@ -13,27 +13,7 @@ execution-mode: execute
13
13
 
14
14
  ---
15
15
 
16
- ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
17
-
18
- **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
- 1. ORCHESTRATION-LAWS.md
20
- 2. ADAPTIVE-EXECUTION.md
21
- 3. EXECUTION-PROTOCOL.md
22
-
23
- **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
24
-
25
- ---
26
-
27
- ## 🔀 TIERED EXECUTION
28
-
29
- | Tier | When | Action |
30
- |------|------|--------|
31
- | **TIER 1** | runSubagent EXISTS | Invoke sub-agent (MANDATORY) |
32
- | **TIER 2** | Tool MISSING | EMBODY agent file (FALLBACK) |
33
-
34
- ---
35
-
36
- ## 📁 PLAN COMPLIANCE CHECK
16
+ ## PLAN COMPLIANCE CHECK
37
17
 
38
18
  ```
39
19
  IF ./reports/plans/PLAN-{scope}.md exists:
@@ -44,46 +24,65 @@ IF ./reports/plans/PLAN-{scope}.md exists:
44
24
 
45
25
  ---
46
26
 
47
- ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
48
-
49
- One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in one reply. No batching (load only what each phase needs). **Within each phase:** when doing a part, output it in format so user sees what’s happening (announce before doing).
27
+ ## Execution
28
+ One phase at a time, sequential. Each phase must complete before next begins.
50
29
 
51
30
  ---
52
31
 
53
- ## 🎭 Phase 1: ARCHITECTURE REVIEW
32
+ ## Phase 1: ARCHITECTURE REVIEW
33
+
34
+ | Attribute | Value |
35
+ |-----------|-------|
36
+ | **Role** | `tech-lead` |
37
+ | **Goal** | Review architecture decisions |
38
+ | **Exit** | Architecture assessed, patterns validated |
39
+
40
+ ### Delegation
54
41
 
55
- | Agent | `tech-lead` |
56
- |-------|-------------|
57
- | Goal | Review architecture decisions |
58
- | Exit | Architecture assessed, patterns validated |
42
+ > Task(subagent_type="general-purpose", prompt="You are a tech-lead. Review architecture decisions. Exit when architecture is assessed and patterns are validated.", description="tech-lead: Review architecture decisions")
59
43
 
60
44
  ---
61
45
 
62
- ## 🎭 Phase 2: CODE REVIEW
46
+ ## Phase 2: CODE REVIEW
47
+
48
+ | Attribute | Value |
49
+ |-----------|-------|
50
+ | **Role** | `reviewer` |
51
+ | **Prerequisite** | READ PLAN file if exists |
52
+ | **Goal** | Deep code analysis |
53
+ | **Exit** | Code quality assessed, issues documented |
54
+
55
+ ### Delegation
63
56
 
64
- | Agent | `reviewer` |
65
- |-------|------------|
66
- | Prerequisite | READ PLAN file if exists |
67
- | Goal | Deep code analysis |
68
- | Exit | Code quality assessed, issues documented |
57
+ > Task(subagent_type="general-purpose", prompt="You are a reviewer. Perform deep code analysis. Read the PLAN file if it exists. Exit when code quality is assessed and issues are documented.", description="reviewer: Deep code analysis")
69
58
 
70
59
  ---
71
60
 
72
- ## 🎭 Phase 3: SECURITY REVIEW
61
+ ## Phase 3: SECURITY REVIEW
73
62
 
74
- | Agent | `security-engineer` |
75
- |-------|----------------------|
76
- | Goal | Security assessment |
77
- | Exit | Security reviewed, vulnerabilities documented |
63
+ | Attribute | Value |
64
+ |-----------|-------|
65
+ | **Role** | `security-engineer` |
66
+ | **Goal** | Security assessment |
67
+ | **Exit** | Security reviewed, vulnerabilities documented |
68
+
69
+ ### Delegation
70
+
71
+ > Task(subagent_type="general-purpose", prompt="You are a security-engineer. Perform a security assessment. Exit when security is reviewed and vulnerabilities are documented.", description="security-engineer: Security assessment")
78
72
 
79
73
  ---
80
74
 
81
- ## 🎭 Phase 4: PERFORMANCE REVIEW
75
+ ## Phase 4: PERFORMANCE REVIEW
76
+
77
+ | Attribute | Value |
78
+ |-----------|-------|
79
+ | **Role** | `performance-engineer` |
80
+ | **Goal** | Performance assessment |
81
+ | **Exit** | Performance issues identified |
82
+
83
+ ### Delegation
82
84
 
83
- | Agent | `performance-engineer` |
84
- |-------|------------------------|
85
- | Goal | Performance assessment |
86
- | Exit | Performance issues identified |
85
+ > Task(subagent_type="general-purpose", prompt="You are a performance-engineer. Perform a performance assessment. Exit when performance issues are identified.", description="performance-engineer: Performance assessment")
87
86
 
88
87
  ---
89
88
 
@@ -91,6 +90,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
91
90
 
92
91
  Present review with:
93
92
 
94
- 1. **Approved** — Code ready
95
- 2. 🔧 **Fix** → `/fix`
96
- 3. 🧪 **Test** → `/test`
93
+ 1. **Approved** — Code ready
94
+ 2. **Fix** → `/fix`
95
+ 3. **Test** → `/test`
@@ -13,17 +13,6 @@ execution-mode: router
13
13
 
14
14
  ---
15
15
 
16
- ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS EXECUTION)
17
-
18
- **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
- 1. ORCHESTRATION-LAWS.md
20
- 2. ADAPTIVE-EXECUTION.md
21
- 3. EXECUTION-PROTOCOL.md
22
-
23
- **⛔ Do not run any workflow phase until all are loaded.** Follow **all** rules in those files. Then run this file's ROUTING LOGIC, LOAD the chosen variant workflow, and execute it.
24
-
25
- ---
26
-
27
16
  ## ROUTING LOGIC
28
17
 
29
18
  ```