@ngxtm/devkit 3.19.0 → 3.21.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 (204) 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/linear-claude-skill.md +2 -2
  81. package/merged-commands/loki-mode.md +14 -14
  82. package/merged-commands/machine-learning-ops-ml-pipeline.md +7 -7
  83. package/merged-commands/mcp-management.md +8 -8
  84. package/merged-commands/multi-agent-patterns.md +14 -14
  85. package/merged-commands/multi-platform-apps-multi-platform.md +10 -10
  86. package/merged-commands/nestjs-expert.md +1 -1
  87. package/merged-commands/performance-testing-review-multi-agent-review.md +1 -1
  88. package/merged-commands/plan/archive.md +1 -1
  89. package/merged-commands/plan/ci.md +1 -1
  90. package/merged-commands/plan/fast.md +2 -2
  91. package/merged-commands/plan/hard.md +4 -4
  92. package/merged-commands/plan/parallel.md +5 -5
  93. package/merged-commands/plan/two.md +6 -6
  94. package/merged-commands/recover.md +22 -0
  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/sync.md +29 -5
  109. package/merged-commands/skill/update.md +6 -6
  110. package/merged-commands/subagent-driven-development.md +53 -53
  111. package/merged-commands/tdd-workflows-tdd-cycle.md +12 -12
  112. package/merged-commands/tdd-workflows-tdd-red.md +1 -1
  113. package/merged-commands/tdd-workflows-tdd-refactor.md +1 -1
  114. package/merged-commands/test/fast.md +22 -33
  115. package/merged-commands/test/hard.md +59 -56
  116. package/merged-commands/test/ui.md +1 -1
  117. package/merged-commands/test.md +1 -1
  118. package/merged-commands/typescript-expert.md +1 -1
  119. package/merged-commands/use-mcp.md +5 -5
  120. package/merged-commands/writing-plans.md +3 -3
  121. package/merged-commands/writing-skills.md +8 -8
  122. package/package.json +1 -1
  123. package/rules/base/auto-skill.md +60 -0
  124. package/rules/base/command-routing.md +58 -0
  125. package/rules/base/context-checkpoint.md +38 -0
  126. package/rules-index.json +1 -1
  127. package/scripts/organize-rules.js +9 -0
  128. package/skills/application-performance-performance-optimization/SKILL.md +13 -13
  129. package/skills/azure-ai-agents-python/references/tools.md +1 -1
  130. package/skills/backend-development-feature-development/SKILL.md +12 -12
  131. package/skills/best-practices/references/anti-patterns.md +2 -2
  132. package/skills/best-practices/references/best-practices-guide.md +14 -14
  133. package/skills/c4-architecture-c4-architecture/SKILL.md +5 -5
  134. package/skills/comprehensive-review-full-review/SKILL.md +8 -8
  135. package/skills/context-degradation/SKILL.md +2 -2
  136. package/skills/context-engineering/SKILL.md +4 -4
  137. package/skills/context-engineering/references/context-degradation.md +1 -1
  138. package/skills/context-engineering/references/context-optimization.md +1 -1
  139. package/skills/context-engineering/references/multi-agent-patterns.md +1 -1
  140. package/skills/context-engineering/references/runtime-awareness.md +1 -1
  141. package/skills/context-optimization/SKILL.md +3 -3
  142. package/skills/daily-news-report/SKILL.md +15 -15
  143. package/skills/data-engineering-data-driven-feature/SKILL.md +16 -16
  144. package/skills/debugging-toolkit-smart-debug/SKILL.md +1 -1
  145. package/skills/doc-coauthoring/SKILL.md +5 -5
  146. package/skills/docker-expert/SKILL.md +1 -1
  147. package/skills/error-debugging-multi-agent-review/SKILL.md +1 -1
  148. package/skills/error-diagnostics-smart-debug/SKILL.md +1 -1
  149. package/skills/finishing-a-development-branch/SKILL.md +1 -1
  150. package/skills/fixing/SKILL.md +3 -3
  151. package/skills/fixing/references/parallel-exploration.md +4 -4
  152. package/skills/fixing/references/skill-activation-matrix.md +3 -3
  153. package/skills/fixing/references/workflow-deep.md +11 -11
  154. package/skills/fixing/references/workflow-quick.md +4 -4
  155. package/skills/fixing/references/workflow-standard.md +12 -12
  156. package/skills/framework-migration-legacy-modernize/SKILL.md +13 -13
  157. package/skills/full-stack-orchestration-full-stack-feature/SKILL.md +12 -12
  158. package/skills/git-pr-workflows-git-workflow/SKILL.md +10 -10
  159. package/skills/google-adk-python/SKILL.md +1 -1
  160. package/skills/hr-pro/SKILL.md +1 -1
  161. package/skills/incident-response-incident-response/SKILL.md +13 -13
  162. package/skills/incident-response-smart-fix/resources/implementation-playbook.md +17 -17
  163. package/skills/linear-claude-skill/SKILL.md +2 -2
  164. package/skills/loki-mode/ACKNOWLEDGEMENTS.md +4 -4
  165. package/skills/loki-mode/CHANGELOG.md +9 -9
  166. package/skills/loki-mode/CONTEXT-EXPORT.md +1 -1
  167. package/skills/loki-mode/README.md +2 -2
  168. package/skills/loki-mode/SKILL.md +14 -14
  169. package/skills/loki-mode/autonomy/run.sh +1 -1
  170. package/skills/loki-mode/integrations/vibe-kanban.md +1 -1
  171. package/skills/loki-mode/references/core-workflow.md +4 -4
  172. package/skills/loki-mode/references/production-patterns.md +6 -6
  173. package/skills/loki-mode/references/quality-control.md +2 -2
  174. package/skills/loki-mode/references/sdlc-phases.md +3 -3
  175. package/skills/machine-learning-ops-ml-pipeline/SKILL.md +7 -7
  176. package/skills/mcp-builder/reference/evaluation.md +3 -3
  177. package/skills/mcp-management/README.md +6 -6
  178. package/skills/mcp-management/SKILL.md +8 -8
  179. package/skills/mcp-management/references/gemini-cli-integration.md +1 -1
  180. package/skills/multi-agent-patterns/SKILL.md +14 -14
  181. package/skills/multi-platform-apps-multi-platform/SKILL.md +10 -10
  182. package/skills/nestjs-expert/SKILL.md +1 -1
  183. package/skills/performance-testing-review-multi-agent-review/SKILL.md +1 -1
  184. package/skills/planning-with-files/reference.md +2 -2
  185. package/skills/requesting-code-review/SKILL.md +6 -6
  186. package/skills/security-scanning-security-hardening/SKILL.md +13 -13
  187. package/skills/subagent-driven-development/SKILL.md +53 -53
  188. package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +1 -1
  189. package/skills/subagent-driven-development/implementer-prompt.md +3 -3
  190. package/skills/subagent-driven-development/spec-reviewer-prompt.md +1 -1
  191. package/skills/tdd-workflows-tdd-cycle/SKILL.md +12 -12
  192. package/skills/tdd-workflows-tdd-green/resources/implementation-playbook.md +1 -1
  193. package/skills/tdd-workflows-tdd-red/SKILL.md +1 -1
  194. package/skills/tdd-workflows-tdd-refactor/SKILL.md +1 -1
  195. package/skills/typescript-expert/SKILL.md +1 -1
  196. package/skills/writing-plans/SKILL.md +3 -3
  197. package/skills/writing-skills/SKILL.md +8 -8
  198. package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +1 -1
  199. package/skills/writing-skills/references/cso/README.md +3 -3
  200. package/skills/writing-skills/testing-skills-with-subagents.md +1 -1
  201. package/skills-graph.json +1 -1
  202. package/templates/base/rules/auto-skill.md +16 -96
  203. package/templates/base/rules/command-routing.md +0 -13
  204. package/templates/base/rules/context-checkpoint.md +38 -0
@@ -61,19 +61,19 @@ Orchestrate end-to-end feature development from requirements to production deplo
61
61
  ## Phase 1: Discovery & Requirements Planning
62
62
 
63
63
  1. **Business Analysis & Requirements**
64
- - Use Task tool with subagent_type="business-analytics::business-analyst"
64
+ - Use Task tool with subagent_type="general-purpose"
65
65
  - Prompt: "Analyze feature requirements for: $ARGUMENTS. Define user stories, acceptance criteria, success metrics, and business value. Identify stakeholders, dependencies, and risks. Create feature specification document with clear scope boundaries."
66
66
  - Expected output: Requirements document with user stories, success metrics, risk assessment
67
67
  - Context: Initial feature request and business context
68
68
 
69
69
  2. **Technical Architecture Design**
70
- - Use Task tool with subagent_type="comprehensive-review::architect-review"
70
+ - Use Task tool with subagent_type="general-purpose"
71
71
  - Prompt: "Design technical architecture for feature: $ARGUMENTS. Using requirements: [include business analysis from step 1]. Define service boundaries, API contracts, data models, integration points, and technology stack. Consider scalability, performance, and security requirements."
72
72
  - Expected output: Technical design document with architecture diagrams, API specifications, data models
73
73
  - Context: Business requirements, existing system architecture
74
74
 
75
75
  3. **Feasibility & Risk Assessment**
76
- - Use Task tool with subagent_type="security-scanning::security-auditor"
76
+ - Use Task tool with subagent_type="general-purpose"
77
77
  - Prompt: "Assess security implications and risks for feature: $ARGUMENTS. Review architecture: [include technical design from step 2]. Identify security requirements, compliance needs, data privacy concerns, and potential vulnerabilities."
78
78
  - Expected output: Security assessment with risk matrix, compliance checklist, mitigation strategies
79
79
  - Context: Technical design, regulatory requirements
@@ -81,19 +81,19 @@ Orchestrate end-to-end feature development from requirements to production deplo
81
81
  ## Phase 2: Implementation & Development
82
82
 
83
83
  4. **Backend Services Implementation**
84
- - Use Task tool with subagent_type="backend-architect"
84
+ - Use Task tool with subagent_type="general-purpose"
85
85
  - Prompt: "Implement backend services for: $ARGUMENTS. Follow technical design: [include architecture from step 2]. Build RESTful/GraphQL APIs, implement business logic, integrate with data layer, add resilience patterns (circuit breakers, retries), implement caching strategies. Include feature flags for gradual rollout."
86
86
  - Expected output: Backend services with APIs, business logic, database integration, feature flags
87
87
  - Context: Technical design, API contracts, data models
88
88
 
89
89
  5. **Frontend Implementation**
90
- - Use Task tool with subagent_type="frontend-mobile-development::frontend-developer"
90
+ - Use Task tool with subagent_type="general-purpose"
91
91
  - Prompt: "Build frontend components for: $ARGUMENTS. Integrate with backend APIs: [include API endpoints from step 4]. Implement responsive UI, state management, error handling, loading states, and analytics tracking. Add feature flag integration for A/B testing capabilities."
92
92
  - Expected output: Frontend components with API integration, state management, analytics
93
93
  - Context: Backend APIs, UI/UX designs, user stories
94
94
 
95
95
  6. **Data Pipeline & Integration**
96
- - Use Task tool with subagent_type="data-engineering::data-engineer"
96
+ - Use Task tool with subagent_type="general-purpose"
97
97
  - Prompt: "Build data pipelines for: $ARGUMENTS. Design ETL/ELT processes, implement data validation, create analytics events, set up data quality monitoring. Integrate with product analytics platforms for feature usage tracking."
98
98
  - Expected output: Data pipelines, analytics events, data quality checks
99
99
  - Context: Data requirements, analytics needs, existing data infrastructure
@@ -101,19 +101,19 @@ Orchestrate end-to-end feature development from requirements to production deplo
101
101
  ## Phase 3: Testing & Quality Assurance
102
102
 
103
103
  7. **Automated Test Suite**
104
- - Use Task tool with subagent_type="unit-testing::test-automator"
104
+ - Use Task tool with subagent_type="general-purpose"
105
105
  - Prompt: "Create comprehensive test suite for: $ARGUMENTS. Write unit tests for backend: [from step 4] and frontend: [from step 5]. Add integration tests for API endpoints, E2E tests for critical user journeys, performance tests for scalability validation. Ensure minimum 80% code coverage."
106
106
  - Expected output: Test suites with unit, integration, E2E, and performance tests
107
107
  - Context: Implementation code, acceptance criteria, test requirements
108
108
 
109
109
  8. **Security Validation**
110
- - Use Task tool with subagent_type="security-scanning::security-auditor"
110
+ - Use Task tool with subagent_type="general-purpose"
111
111
  - Prompt: "Perform security testing for: $ARGUMENTS. Review implementation: [include backend and frontend from steps 4-5]. Run OWASP checks, penetration testing, dependency scanning, and compliance validation. Verify data encryption, authentication, and authorization."
112
112
  - Expected output: Security test results, vulnerability report, remediation actions
113
113
  - Context: Implementation code, security requirements
114
114
 
115
115
  9. **Performance Optimization**
116
- - Use Task tool with subagent_type="application-performance::performance-engineer"
116
+ - Use Task tool with subagent_type="general-purpose"
117
117
  - Prompt: "Optimize performance for: $ARGUMENTS. Analyze backend services: [from step 4] and frontend: [from step 5]. Profile code, optimize queries, implement caching, reduce bundle sizes, improve load times. Set up performance budgets and monitoring."
118
118
  - Expected output: Performance improvements, optimization report, performance metrics
119
119
  - Context: Implementation code, performance requirements
@@ -121,19 +121,19 @@ Orchestrate end-to-end feature development from requirements to production deplo
121
121
  ## Phase 4: Deployment & Monitoring
122
122
 
123
123
  10. **Deployment Strategy & Pipeline**
124
- - Use Task tool with subagent_type="deployment-strategies::deployment-engineer"
124
+ - Use Task tool with subagent_type="general-purpose"
125
125
  - Prompt: "Prepare deployment for: $ARGUMENTS. Create CI/CD pipeline with automated tests: [from step 7]. Configure feature flags for gradual rollout, implement blue-green deployment, set up rollback procedures. Create deployment runbook and rollback plan."
126
126
  - Expected output: CI/CD pipeline, deployment configuration, rollback procedures
127
127
  - Context: Test suites, infrastructure requirements, deployment strategy
128
128
 
129
129
  11. **Observability & Monitoring**
130
- - Use Task tool with subagent_type="observability-monitoring::observability-engineer"
130
+ - Use Task tool with subagent_type="general-purpose"
131
131
  - Prompt: "Set up observability for: $ARGUMENTS. Implement distributed tracing, custom metrics, error tracking, and alerting. Create dashboards for feature usage, performance metrics, error rates, and business KPIs. Set up SLOs/SLIs with automated alerts."
132
132
  - Expected output: Monitoring dashboards, alerts, SLO definitions, observability infrastructure
133
133
  - Context: Feature implementation, success metrics, operational requirements
134
134
 
135
135
  12. **Documentation & Knowledge Transfer**
136
- - Use Task tool with subagent_type="documentation-generation::docs-architect"
136
+ - Use Task tool with subagent_type="general-purpose"
137
137
  - Prompt: "Generate comprehensive documentation for: $ARGUMENTS. Create API documentation, user guides, deployment guides, troubleshooting runbooks. Include architecture diagrams, data flow diagrams, and integration guides. Generate automated changelog from commits."
138
138
  - Expected output: API docs, user guides, runbooks, architecture documentation
139
139
  - Context: All previous phases' outputs
@@ -528,9 +528,9 @@ read all the files in src/ and then tell me about the architecture
528
528
  ```
529
529
  read the main entry point and top-level directories to understand the architecture. don't read every file - just enough to explain the main patterns.
530
530
  ```
531
- Or use subagents:
531
+ Or use Task agents:
532
532
  ```
533
- use a subagent to investigate the codebase architecture and report a summary.
533
+ use a Task agent to investigate the codebase architecture and report a summary.
534
534
  ```
535
535
 
536
536
  ---
@@ -250,11 +250,11 @@ Analyze and fix the GitHub issue: $ARGUMENTS.
250
250
 
251
251
  Run `/fix-issue 1234` to invoke it. Use `disable-model-invocation: true` for workflows with side effects that you want to trigger manually.
252
252
 
253
- ### Create custom subagents
253
+ ### Create custom Task agents
254
254
 
255
255
  > **Tip:** Define specialized assistants in `.claude/agents/` that Claude can delegate to for isolated tasks.
256
256
 
257
- Subagents run in their own context with their own set of allowed tools. They're useful for tasks that read many files or need specialized focus without cluttering your main conversation.
257
+ Task agents run in their own context with their own set of allowed tools. They're useful for tasks that read many files or need specialized focus without cluttering your main conversation.
258
258
 
259
259
  ```markdown
260
260
  ---
@@ -272,15 +272,15 @@ You are a senior security engineer. Review code for:
272
272
  Provide specific line references and suggested fixes.
273
273
  ```
274
274
 
275
- Tell Claude to use subagents explicitly: *"Use a subagent to review this code for security issues."*
275
+ Tell Claude to use Task agents explicitly: *"Use a Task agent to review this code for security issues."*
276
276
 
277
277
  ### Install plugins
278
278
 
279
279
  > **Tip:** Run `/plugin` to browse the marketplace. Plugins add skills, tools, and integrations without configuration.
280
280
 
281
- Plugins bundle skills, hooks, subagents, and MCP servers into a single installable unit from the community and Anthropic.
281
+ Plugins bundle skills, hooks, Task agents, and MCP servers into a single installable unit from the community and Anthropic.
282
282
 
283
- For guidance on choosing between skills, subagents, hooks, and MCP, see Extend Claude Code.
283
+ For guidance on choosing between skills, Task agents, hooks, and MCP, see Extend Claude Code.
284
284
 
285
285
  ***
286
286
 
@@ -350,23 +350,23 @@ During long sessions, Claude's context window can fill with irrelevant conversat
350
350
  * For more control, run `/compact <instructions>`, like `/compact Focus on the API changes`
351
351
  * Customize compaction behavior in CLAUDE.md with instructions like `"When compacting, always preserve the full list of modified files and any test commands"` to ensure critical context survives summarization
352
352
 
353
- ### Use subagents for investigation
353
+ ### Use Task agents for investigation
354
354
 
355
- > **Tip:** Delegate research with `"use subagents to investigate X"`. They explore in a separate context, keeping your main conversation clean for implementation.
355
+ > **Tip:** Delegate research with `"use Task agents to investigate X"`. They explore in a separate context, keeping your main conversation clean for implementation.
356
356
 
357
- Since context is your fundamental constraint, subagents are one of the most powerful tools available. When Claude researches a codebase it reads lots of files, all of which consume your context. Subagents run in separate context windows and report back summaries:
357
+ Since context is your fundamental constraint, Task agents are one of the most powerful tools available. When Claude researches a codebase it reads lots of files, all of which consume your context. Task agents run in separate context windows and report back summaries:
358
358
 
359
359
  ```
360
- Use subagents to investigate how our authentication system handles token
360
+ Use Task agents to investigate how our authentication system handles token
361
361
  refresh, and whether we have any existing OAuth utilities I should reuse.
362
362
  ```
363
363
 
364
- The subagent explores the codebase, reads relevant files, and reports back with findings, all without cluttering your main conversation.
364
+ The Task agent explores the codebase, reads relevant files, and reports back with findings, all without cluttering your main conversation.
365
365
 
366
- You can also use subagents for verification after Claude implements something:
366
+ You can also use Task agents for verification after Claude implements something:
367
367
 
368
368
  ```
369
- use a subagent to review this code for edge cases
369
+ use a Task agent to review this code for edge cases
370
370
  ```
371
371
 
372
372
  ### Rewind with checkpoints
@@ -487,7 +487,7 @@ These are common mistakes. Recognizing them early saves time:
487
487
  * **The trust-then-verify gap.** Claude produces a plausible-looking implementation that doesn't handle edge cases.
488
488
  > **Fix**: Always provide verification (tests, scripts, screenshots). If you can't verify it, don't ship it.
489
489
  * **The infinite exploration.** You ask Claude to "investigate" something without scoping it. Claude reads hundreds of files, filling the context.
490
- > **Fix**: Scope investigations narrowly or use subagents so the exploration doesn't consume your main context.
490
+ > **Fix**: Scope investigations narrowly or use Task agents so the exploration doesn't consume your main context.
491
491
 
492
492
  ***
493
493
 
@@ -504,7 +504,7 @@ Over time, you'll develop intuition that no guide can capture. You'll know when
504
504
  ## Related resources
505
505
 
506
506
  * **How Claude Code works** - Understand the agentic loop, tools, and context management
507
- * **Extend Claude Code** - Choose between skills, hooks, MCP, subagents, and plugins
507
+ * **Extend Claude Code** - Choose between skills, hooks, MCP, Task agents, and plugins
508
508
  * **Common workflows** - Step-by-step recipes for debugging, testing, PRs, and more
509
509
  * **CLAUDE.md** - Store project conventions and persistent context
510
510
 
@@ -54,7 +54,7 @@ All documentation is written to a new `C4-Documentation/` directory in the repos
54
54
 
55
55
  For each directory, starting from the deepest:
56
56
 
57
- - Use Task tool with subagent_type="c4-architecture::c4-code"
57
+ - Use Task tool with subagent_type="general-purpose"
58
58
  - Prompt: |
59
59
  Analyze the code in directory: [directory_path]
60
60
 
@@ -110,7 +110,7 @@ For each directory, starting from the deepest:
110
110
 
111
111
  For each identified component:
112
112
 
113
- - Use Task tool with subagent_type="c4-architecture::c4-component"
113
+ - Use Task tool with subagent_type="general-purpose"
114
114
  - Prompt: |
115
115
  Synthesize the following C4 Code-level documentation files into a logical component:
116
116
 
@@ -153,7 +153,7 @@ For each identified component:
153
153
 
154
154
  ### 2.3 Create Master Component Index
155
155
 
156
- - Use Task tool with subagent_type="c4-architecture::c4-component"
156
+ - Use Task tool with subagent_type="general-purpose"
157
157
  - Prompt: |
158
158
  Create a master component index that lists all components in the system.
159
159
 
@@ -188,7 +188,7 @@ For each identified component:
188
188
 
189
189
  ### 3.2 Map Components to Containers
190
190
 
191
- - Use Task tool with subagent_type="c4-architecture::c4-container"
191
+ - Use Task tool with subagent_type="general-purpose"
192
192
  - Prompt: |
193
193
  Synthesize components into containers based on deployment definitions.
194
194
 
@@ -261,7 +261,7 @@ For each identified component:
261
261
 
262
262
  ### 4.2 Create Context Documentation
263
263
 
264
- - Use Task tool with subagent_type="c4-architecture::c4-context"
264
+ - Use Task tool with subagent_type="general-purpose"
265
265
  - Prompt: |
266
266
  Create comprehensive C4 Context-level documentation for the system.
267
267
 
@@ -41,13 +41,13 @@ Orchestrate comprehensive multi-dimensional code review using specialized review
41
41
  Use Task tool to orchestrate quality and architecture agents in parallel:
42
42
 
43
43
  ### 1A. Code Quality Analysis
44
- - Use Task tool with subagent_type="code-reviewer"
44
+ - Use Task tool with subagent_type="general-purpose"
45
45
  - Prompt: "Perform comprehensive code quality review for: $ARGUMENTS. Analyze code complexity, maintainability index, technical debt, code duplication, naming conventions, and adherence to Clean Code principles. Integrate with SonarQube, CodeQL, and Semgrep for static analysis. Check for code smells, anti-patterns, and violations of SOLID principles. Generate cyclomatic complexity metrics and identify refactoring opportunities."
46
46
  - Expected output: Quality metrics, code smell inventory, refactoring recommendations
47
47
  - Context: Initial codebase analysis, no dependencies on other phases
48
48
 
49
49
  ### 1B. Architecture & Design Review
50
- - Use Task tool with subagent_type="architect-review"
50
+ - Use Task tool with subagent_type="general-purpose"
51
51
  - Prompt: "Review architectural design patterns and structural integrity in: $ARGUMENTS. Evaluate microservices boundaries, API design, database schema, dependency management, and adherence to Domain-Driven Design principles. Check for circular dependencies, inappropriate coupling, missing abstractions, and architectural drift. Verify compliance with enterprise architecture standards and cloud-native patterns."
52
52
  - Expected output: Architecture assessment, design pattern analysis, structural recommendations
53
53
  - Context: Runs parallel with code quality analysis
@@ -57,13 +57,13 @@ Use Task tool to orchestrate quality and architecture agents in parallel:
57
57
  Use Task tool with security and performance agents, incorporating Phase 1 findings:
58
58
 
59
59
  ### 2A. Security Vulnerability Assessment
60
- - Use Task tool with subagent_type="security-auditor"
60
+ - Use Task tool with subagent_type="general-purpose"
61
61
  - Prompt: "Execute comprehensive security audit on: $ARGUMENTS. Perform OWASP Top 10 analysis, dependency vulnerability scanning with Snyk/Trivy, secrets detection with GitLeaks, input validation review, authentication/authorization assessment, and cryptographic implementation review. Include findings from Phase 1 architecture review: {phase1_architecture_context}. Check for SQL injection, XSS, CSRF, insecure deserialization, and configuration security issues."
62
62
  - Expected output: Vulnerability report, CVE list, security risk matrix, remediation steps
63
63
  - Context: Incorporates architectural vulnerabilities identified in Phase 1B
64
64
 
65
65
  ### 2B. Performance & Scalability Analysis
66
- - Use Task tool with subagent_type="application-performance::performance-engineer"
66
+ - Use Task tool with subagent_type="general-purpose"
67
67
  - Prompt: "Conduct performance analysis and scalability assessment for: $ARGUMENTS. Profile code for CPU/memory hotspots, analyze database query performance, review caching strategies, identify N+1 problems, assess connection pooling, and evaluate asynchronous processing patterns. Consider architectural findings from Phase 1: {phase1_architecture_context}. Check for memory leaks, resource contention, and bottlenecks under load."
68
68
  - Expected output: Performance metrics, bottleneck analysis, optimization recommendations
69
69
  - Context: Uses architecture insights to identify systemic performance issues
@@ -73,13 +73,13 @@ Use Task tool with security and performance agents, incorporating Phase 1 findin
73
73
  Use Task tool for test and documentation quality assessment:
74
74
 
75
75
  ### 3A. Test Coverage & Quality Analysis
76
- - Use Task tool with subagent_type="unit-testing::test-automator"
76
+ - Use Task tool with subagent_type="general-purpose"
77
77
  - Prompt: "Evaluate testing strategy and implementation for: $ARGUMENTS. Analyze unit test coverage, integration test completeness, end-to-end test scenarios, test pyramid adherence, and test maintainability. Review test quality metrics including assertion density, test isolation, mock usage, and flakiness. Consider security and performance test requirements from Phase 2: {phase2_security_context}, {phase2_performance_context}. Verify TDD practices if --tdd-review flag is set."
78
78
  - Expected output: Coverage report, test quality metrics, testing gap analysis
79
79
  - Context: Incorporates security and performance testing requirements from Phase 2
80
80
 
81
81
  ### 3B. Documentation & API Specification Review
82
- - Use Task tool with subagent_type="code-documentation::docs-architect"
82
+ - Use Task tool with subagent_type="general-purpose"
83
83
  - Prompt: "Review documentation completeness and quality for: $ARGUMENTS. Assess inline code documentation, API documentation (OpenAPI/Swagger), architecture decision records (ADRs), README completeness, deployment guides, and runbooks. Verify documentation reflects actual implementation based on all previous phase findings: {phase1_context}, {phase2_context}. Check for outdated documentation, missing examples, and unclear explanations."
84
84
  - Expected output: Documentation coverage report, inconsistency list, improvement recommendations
85
85
  - Context: Cross-references all previous findings to ensure documentation accuracy
@@ -89,13 +89,13 @@ Use Task tool for test and documentation quality assessment:
89
89
  Use Task tool to verify framework-specific and industry best practices:
90
90
 
91
91
  ### 4A. Framework & Language Best Practices
92
- - Use Task tool with subagent_type="framework-migration::legacy-modernizer"
92
+ - Use Task tool with subagent_type="general-purpose"
93
93
  - Prompt: "Verify adherence to framework and language best practices for: $ARGUMENTS. Check modern JavaScript/TypeScript patterns, React hooks best practices, Python PEP compliance, Java enterprise patterns, Go idiomatic code, or framework-specific conventions (based on --framework flag). Review package management, build configuration, environment handling, and deployment practices. Include all quality issues from previous phases: {all_previous_contexts}."
94
94
  - Expected output: Best practices compliance report, modernization recommendations
95
95
  - Context: Synthesizes all previous findings for framework-specific guidance
96
96
 
97
97
  ### 4B. CI/CD & DevOps Practices Review
98
- - Use Task tool with subagent_type="cicd-automation::deployment-engineer"
98
+ - Use Task tool with subagent_type="general-purpose"
99
99
  - Prompt: "Review CI/CD pipeline and DevOps practices for: $ARGUMENTS. Evaluate build automation, test automation integration, deployment strategies (blue-green, canary), infrastructure as code, monitoring/observability setup, and incident response procedures. Assess pipeline security, artifact management, and rollback capabilities. Consider all issues identified in previous phases that impact deployment: {all_critical_issues}."
100
100
  - Expected output: Pipeline assessment, DevOps maturity evaluation, automation recommendations
101
101
  - Context: Focuses on operationalizing fixes for all identified issues
@@ -157,11 +157,11 @@ Four strategies address different aspects of context degradation:
157
157
 
158
158
  **Compress**: Reduce tokens while preserving information through summarization, abstraction, and observation masking. This extends effective context capacity.
159
159
 
160
- **Isolate**: Split context across sub-agents or sessions to prevent any single context from growing large enough to degrade. This is the most aggressive strategy but often the most effective.
160
+ **Isolate**: Split context across Task agents or sessions to prevent any single context from growing large enough to degrade. This is the most aggressive strategy but often the most effective.
161
161
 
162
162
  ### Architectural Patterns
163
163
 
164
- Implement these strategies through specific architectural patterns. Use just-in-time context loading to retrieve information only when needed. Use observation masking to replace verbose tool outputs with compact references. Use sub-agent architectures to isolate context for different tasks. Use compaction to summarize growing context before it exceeds limits.
164
+ Implement these strategies through specific architectural patterns. Use just-in-time context loading to retrieve information only when needed. Use observation masking to replace verbose tool outputs with compact references. Use Task agent architectures to isolate context for different tasks. Use compaction to summarize growing context before it exceeds limits.
165
165
 
166
166
  ## Examples
167
167
 
@@ -25,13 +25,13 @@ Context engineering curates the smallest high-signal token set for LLM tasks. Th
25
25
  1. **Context quality > quantity** - High-signal tokens beat exhaustive content
26
26
  2. **Attention is finite** - U-shaped curve favors beginning/end positions
27
27
  3. **Progressive disclosure** - Load information just-in-time
28
- 4. **Isolation prevents degradation** - Partition work across sub-agents
28
+ 4. **Isolation prevents degradation** - Partition work across Task agents
29
29
  5. **Measure before optimizing** - Know your baseline
30
30
 
31
31
  **IMPORTANT:**
32
32
  - Sacrifice grammar for the sake of concision.
33
33
  - Ensure token efficiency while maintaining high quality.
34
- - Pass these rules to subagents.
34
+ - Pass these rules to Task agents.
35
35
 
36
36
  ## Quick Reference
37
37
 
@@ -61,7 +61,7 @@ Context engineering curates the smallest high-signal token set for LLM tasks. Th
61
61
  1. **Write**: Save context externally (scratchpads, files)
62
62
  2. **Select**: Pull only relevant context (retrieval, filtering)
63
63
  3. **Compress**: Reduce tokens while preserving info (summarization)
64
- 4. **Isolate**: Split across sub-agents (partitioning)
64
+ 4. **Isolate**: Split across Task agents (partitioning)
65
65
 
66
66
  ## Anti-Patterns
67
67
 
@@ -75,7 +75,7 @@ Context engineering curates the smallest high-signal token set for LLM tasks. Th
75
75
 
76
76
  1. Place critical info at beginning/end of context
77
77
  2. Implement compaction at 70-80% utilization
78
- 3. Use sub-agents for context isolation, not role-play
78
+ 3. Use Task agents for context isolation, not role-play
79
79
  4. Design tools with 4-question framework (what, when, inputs, returns)
80
80
  5. Optimize for tokens-per-task, not tokens-per-request
81
81
  6. Validate with probe-based evaluation
@@ -61,7 +61,7 @@ Predictable degradation as context grows. Not binary - a continuum.
61
61
  1. **Write**: Save externally (scratchpads, files)
62
62
  2. **Select**: Pull only relevant (retrieval, filtering)
63
63
  3. **Compress**: Reduce tokens (summarization)
64
- 4. **Isolate**: Split across sub-agents (partitioning)
64
+ 4. **Isolate**: Split across Task agents (partitioning)
65
65
 
66
66
  ## Detection Heuristics
67
67
 
@@ -51,7 +51,7 @@ context += [unique_content] # Variable last
51
51
 
52
52
  ## Context Partitioning
53
53
 
54
- Split work across sub-agents with isolated contexts.
54
+ Split work across Task agents with isolated contexts.
55
55
 
56
56
  ```python
57
57
  result = await sub_agent.process(subtask, clean_context=True)
@@ -4,7 +4,7 @@ Distribute work across multiple context windows for isolation and scale.
4
4
 
5
5
  ## Core Insight
6
6
 
7
- Sub-agents exist to **isolate context**, not anthropomorphize roles.
7
+ Task agents exist to **isolate context**, not anthropomorphize roles.
8
8
 
9
9
  ## Token Economics
10
10
 
@@ -157,7 +157,7 @@ Context: 91% [CRITICAL - compaction needed]
157
157
  | 5-Hour | Action |
158
158
  |--------|--------|
159
159
  | < 70% | Normal usage |
160
- | 70-90% | Reduce parallelization, delegate to subagents |
160
+ | 70-90% | Reduce parallelization, delegate to Task agents |
161
161
  | > 90% | Wait for reset or use lower-tier models |
162
162
 
163
163
  | 7-Day | Action |
@@ -81,10 +81,10 @@ Design prompts to maximize cache stability: avoid dynamic content like timestamp
81
81
 
82
82
  ### Context Partitioning
83
83
 
84
- **Sub-Agent Partitioning**
85
- The most aggressive form of context optimization is partitioning work across sub-agents with isolated contexts. Each sub-agent operates in a clean context focused on its subtask without carrying accumulated context from other subtasks.
84
+ **Task Agent Partitioning**
85
+ The most aggressive form of context optimization is partitioning work across Task agents with isolated contexts. Each Task agent operates in a clean context focused on its subtask without carrying accumulated context from other subtasks.
86
86
 
87
- This approach achieves separation of concerns—the detailed search context remains isolated within sub-agents while the coordinator focuses on synthesis and analysis.
87
+ This approach achieves separation of concerns—the detailed search context remains isolated within Task agents while the coordinator focuses on synthesis and analysis.
88
88
 
89
89
  **Result Aggregation**
90
90
  Aggregate results from partitioned subtasks by validating all partitions completed, merging compatible results, and summarizing if still too large.
@@ -11,7 +11,7 @@ source: community
11
11
 
12
12
  # Daily News Report v3.0
13
13
 
14
- > **Architecture Upgrade**: Main Agent Orchestration + SubAgent Execution + Browser Scraping + Smart Caching
14
+ > **Architecture Upgrade**: Main Agent Orchestration + Task Agent Execution + Browser Scraping + Smart Caching
15
15
 
16
16
  ## Core Architecture
17
17
 
@@ -35,7 +35,7 @@ source: community
35
35
  └──────────────────────────────────────────────────────────────────────┘
36
36
  ↓ Dispatch ↑ Return Results
37
37
  ┌─────────────────────────────────────────────────────────────────────┐
38
- SubAgent Execution Layer │
38
+ Task Agent Execution Layer │
39
39
  ├─────────────────────────────────────────────────────────────────────┤
40
40
  │ │
41
41
  │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
@@ -74,7 +74,7 @@ Steps:
74
74
  5. Check if a partial report exists for today (append mode)
75
75
  ```
76
76
 
77
- ### Phase 2: Dispatch SubAgents
77
+ ### Phase 2: Dispatch Task Agents
78
78
 
79
79
  **Strategy**: Parallel dispatch, batch execution, early stopping mechanism
80
80
 
@@ -95,9 +95,9 @@ If still < 20 items:
95
95
  - Browser Worker: ProductHunt, Latent Space (Require JS rendering)
96
96
  ```
97
97
 
98
- ### Phase 3: SubAgent Task Format
98
+ ### Phase 3: Task Agent Task Format
99
99
 
100
- Task format received by each SubAgent:
100
+ Task format received by each Task Agent:
101
101
 
102
102
  ```yaml
103
103
  task: fetch_and_extract
@@ -134,12 +134,12 @@ Main Agent Responsibilities:
134
134
 
135
135
  ```yaml
136
136
  Monitoring:
137
- - Check SubAgent return status (success/partial/failed)
137
+ - Check Task Agent return status (success/partial/failed)
138
138
  - Count collected items
139
139
  - Record success rate per source
140
140
 
141
141
  Feedback Loop:
142
- - If a SubAgent fails, decide whether to retry or skip
142
+ - If a Task Agent fails, decide whether to retry or skip
143
143
  - If a source fails persistently, mark as disabled
144
144
  - Dynamically adjust source selection for subsequent batches
145
145
 
@@ -158,7 +158,7 @@ Deduplication:
158
158
  - Check cache.json to avoid history duplicates
159
159
 
160
160
  Score Calibration:
161
- - Unify scoring standards across SubAgents
161
+ - Unify scoring standards across Task Agents
162
162
  - Adjust weights based on source credibility
163
163
  - Bonus points for manually curated high-quality sources
164
164
 
@@ -212,7 +212,7 @@ Update cache.json:
212
212
  - article_history: Record included articles
213
213
  ```
214
214
 
215
- ## SubAgent Call Examples
215
+ ## Task Agent Call Examples
216
216
 
217
217
  ### Using general-purpose Agent
218
218
 
@@ -260,7 +260,7 @@ Task Call:
260
260
 
261
261
  ```
262
262
  Task Call:
263
- subagent_type: worker
263
+ subagent_type: general-purpose
264
264
  prompt: |
265
265
  task: fetch_and_extract
266
266
  input:
@@ -288,7 +288,7 @@ Task Call:
288
288
  > Curated from N sources today, containing 20 high-quality items
289
289
  > Generation Time: X min | Version: v3.0
290
290
  >
291
- > **Warning**: Sub-agent 'worker' not detected. Running in generic mode (Serial Execution). Performance might be degraded.
291
+ > **Warning**: Task agent 'worker' not detected. Running in generic mode (Serial Execution). Performance might be degraded.
292
292
 
293
293
  ---
294
294
 
@@ -318,11 +318,11 @@ Task Call:
318
318
 
319
319
  1. **Quality over Quantity**: Low-quality content does not enter the report.
320
320
  2. **Early Stop**: Stop scraping once 20 high-quality items are reached.
321
- 3. **Parallel First**: SubAgents in the same batch execute in parallel.
321
+ 3. **Parallel First**: Task Agents in the same batch execute in parallel.
322
322
  4. **Fault Tolerance**: Failure of a single source does not affect the whole process.
323
323
  5. **Cache Reuse**: Avoid re-scraping the same content.
324
324
  6. **Main Agent Control**: All decisions are made by the Main Agent.
325
- 7. **Fallback Awareness**: Detect sub-agent availability, gracefully degrade if unavailable.
325
+ 7. **Fallback Awareness**: Detect Task agent availability, gracefully degrade if unavailable.
326
326
 
327
327
  ## Expected Performance
328
328
 
@@ -336,7 +336,7 @@ Task Call:
336
336
 
337
337
  | Error Type | Handling |
338
338
  |---|---|
339
- | SubAgent Timeout | Log error, continue to next |
339
+ | Task Agent Timeout | Log error, continue to next |
340
340
  | Source 403/404 | Mark disabled, update sources.json |
341
341
  | Extraction Failed | Return raw content, Main Agent decides |
342
342
  | Browser Crash | Skip source, log entry |
@@ -346,7 +346,7 @@ Task Call:
346
346
  To ensure usability across different Agent environments, the following checks must be performed:
347
347
 
348
348
  1. **Environment Check**:
349
- - In Phase 1 initialization, attempt to detect if `worker` sub-agent exists.
349
+ - In Phase 1 initialization, attempt to detect if `worker` Task agent exists.
350
350
  - If not exists (or plugin not installed), automatically switch to **Serial Execution Mode**.
351
351
 
352
352
  2. **Serial Execution Mode**: