@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
@@ -38,21 +38,21 @@ Optimize application performance end-to-end using specialized performance and op
38
38
 
39
39
  ### 1. Comprehensive Performance Profiling
40
40
 
41
- - Use Task tool with subagent_type="performance-engineer"
41
+ - Use Task tool with subagent_type="general-purpose"
42
42
  - Prompt: "Profile application performance comprehensively for: $ARGUMENTS. Generate flame graphs for CPU usage, heap dumps for memory analysis, trace I/O operations, and identify hot paths. Use APM tools like DataDog or New Relic if available. Include database query profiling, API response times, and frontend rendering metrics. Establish performance baselines for all critical user journeys."
43
43
  - Context: Initial performance investigation
44
44
  - Output: Detailed performance profile with flame graphs, memory analysis, bottleneck identification, baseline metrics
45
45
 
46
46
  ### 2. Observability Stack Assessment
47
47
 
48
- - Use Task tool with subagent_type="observability-engineer"
48
+ - Use Task tool with subagent_type="general-purpose"
49
49
  - Prompt: "Assess current observability setup for: $ARGUMENTS. Review existing monitoring, distributed tracing with OpenTelemetry, log aggregation, and metrics collection. Identify gaps in visibility, missing metrics, and areas needing better instrumentation. Recommend APM tool integration and custom metrics for business-critical operations."
50
50
  - Context: Performance profile from step 1
51
51
  - Output: Observability assessment report, instrumentation gaps, monitoring recommendations
52
52
 
53
53
  ### 3. User Experience Analysis
54
54
 
55
- - Use Task tool with subagent_type="performance-engineer"
55
+ - Use Task tool with subagent_type="general-purpose"
56
56
  - Prompt: "Analyze user experience metrics for: $ARGUMENTS. Measure Core Web Vitals (LCP, FID, CLS), page load times, time to interactive, and perceived performance. Use Real User Monitoring (RUM) data if available. Identify user journeys with poor performance and their business impact."
57
57
  - Context: Performance baselines from step 1
58
58
  - Output: UX performance report, Core Web Vitals analysis, user impact assessment
@@ -61,21 +61,21 @@ Optimize application performance end-to-end using specialized performance and op
61
61
 
62
62
  ### 4. Database Performance Optimization
63
63
 
64
- - Use Task tool with subagent_type="database-cloud-optimization::database-optimizer"
64
+ - Use Task tool with subagent_type="general-purpose"
65
65
  - Prompt: "Optimize database performance for: $ARGUMENTS based on profiling data: {context_from_phase_1}. Analyze slow query logs, create missing indexes, optimize execution plans, implement query result caching with Redis/Memcached. Review connection pooling, prepared statements, and batch processing opportunities. Consider read replicas and database sharding if needed."
66
66
  - Context: Performance bottlenecks from phase 1
67
67
  - Output: Optimized queries, new indexes, caching strategy, connection pool configuration
68
68
 
69
69
  ### 5. Backend Code & API Optimization
70
70
 
71
- - Use Task tool with subagent_type="backend-development::backend-architect"
71
+ - Use Task tool with subagent_type="general-purpose"
72
72
  - Prompt: "Optimize backend services for: $ARGUMENTS targeting bottlenecks: {context_from_phase_1}. Implement efficient algorithms, add application-level caching, optimize N+1 queries, use async/await patterns effectively. Implement pagination, response compression, GraphQL query optimization, and batch API operations. Add circuit breakers and bulkheads for resilience."
73
73
  - Context: Database optimizations from step 4, profiling data from phase 1
74
74
  - Output: Optimized backend code, caching implementation, API improvements, resilience patterns
75
75
 
76
76
  ### 6. Microservices & Distributed System Optimization
77
77
 
78
- - Use Task tool with subagent_type="performance-engineer"
78
+ - Use Task tool with subagent_type="general-purpose"
79
79
  - Prompt: "Optimize distributed system performance for: $ARGUMENTS. Analyze service-to-service communication, implement service mesh optimizations, optimize message queue performance (Kafka/RabbitMQ), reduce network hops. Implement distributed caching strategies and optimize serialization/deserialization."
80
80
  - Context: Backend optimizations from step 5
81
81
  - Output: Service communication improvements, message queue optimization, distributed caching setup
@@ -84,21 +84,21 @@ Optimize application performance end-to-end using specialized performance and op
84
84
 
85
85
  ### 7. Frontend Bundle & Loading Optimization
86
86
 
87
- - Use Task tool with subagent_type="frontend-developer"
87
+ - Use Task tool with subagent_type="general-purpose"
88
88
  - Prompt: "Optimize frontend performance for: $ARGUMENTS targeting Core Web Vitals: {context_from_phase_1}. Implement code splitting, tree shaking, lazy loading, and dynamic imports. Optimize bundle sizes with webpack/rollup analysis. Implement resource hints (prefetch, preconnect, preload). Optimize critical rendering path and eliminate render-blocking resources."
89
89
  - Context: UX analysis from phase 1, backend optimizations from phase 2
90
90
  - Output: Optimized bundles, lazy loading implementation, improved Core Web Vitals
91
91
 
92
92
  ### 8. CDN & Edge Optimization
93
93
 
94
- - Use Task tool with subagent_type="cloud-infrastructure::cloud-architect"
94
+ - Use Task tool with subagent_type="general-purpose"
95
95
  - Prompt: "Optimize CDN and edge performance for: $ARGUMENTS. Configure CloudFlare/CloudFront for optimal caching, implement edge functions for dynamic content, set up image optimization with responsive images and WebP/AVIF formats. Configure HTTP/2 and HTTP/3, implement Brotli compression. Set up geographic distribution for global users."
96
96
  - Context: Frontend optimizations from step 7
97
97
  - Output: CDN configuration, edge caching rules, compression setup, geographic optimization
98
98
 
99
99
  ### 9. Mobile & Progressive Web App Optimization
100
100
 
101
- - Use Task tool with subagent_type="frontend-mobile-development::mobile-developer"
101
+ - Use Task tool with subagent_type="general-purpose"
102
102
  - Prompt: "Optimize mobile experience for: $ARGUMENTS. Implement service workers for offline functionality, optimize for slow networks with adaptive loading. Reduce JavaScript execution time for mobile CPUs. Implement virtual scrolling for long lists. Optimize touch responsiveness and smooth animations. Consider React Native/Flutter specific optimizations if applicable."
103
103
  - Context: Frontend optimizations from steps 7-8
104
104
  - Output: Mobile-optimized code, PWA implementation, offline functionality
@@ -107,14 +107,14 @@ Optimize application performance end-to-end using specialized performance and op
107
107
 
108
108
  ### 10. Comprehensive Load Testing
109
109
 
110
- - Use Task tool with subagent_type="performance-engineer"
110
+ - Use Task tool with subagent_type="general-purpose"
111
111
  - Prompt: "Conduct comprehensive load testing for: $ARGUMENTS using k6/Gatling/Artillery. Design realistic load scenarios based on production traffic patterns. Test normal load, peak load, and stress scenarios. Include API testing, browser-based testing, and WebSocket testing if applicable. Measure response times, throughput, error rates, and resource utilization at various load levels."
112
112
  - Context: All optimizations from phases 1-3
113
113
  - Output: Load test results, performance under load, breaking points, scalability analysis
114
114
 
115
115
  ### 11. Performance Regression Testing
116
116
 
117
- - Use Task tool with subagent_type="performance-testing-review::test-automator"
117
+ - Use Task tool with subagent_type="general-purpose"
118
118
  - Prompt: "Create automated performance regression tests for: $ARGUMENTS. Set up performance budgets for key metrics, integrate with CI/CD pipeline using GitHub Actions or similar. Create Lighthouse CI tests for frontend, API performance tests with Artillery, and database performance benchmarks. Implement automatic rollback triggers for performance regressions."
119
119
  - Context: Load test results from step 10, baseline metrics from phase 1
120
120
  - Output: Performance test suite, CI/CD integration, regression prevention system
@@ -123,14 +123,14 @@ Optimize application performance end-to-end using specialized performance and op
123
123
 
124
124
  ### 12. Production Monitoring Setup
125
125
 
126
- - Use Task tool with subagent_type="observability-engineer"
126
+ - Use Task tool with subagent_type="general-purpose"
127
127
  - Prompt: "Implement production performance monitoring for: $ARGUMENTS. Set up APM with DataDog/New Relic/Dynatrace, configure distributed tracing with OpenTelemetry, implement custom business metrics. Create Grafana dashboards for key metrics, set up PagerDuty alerts for performance degradation. Define SLIs/SLOs for critical services with error budgets."
128
128
  - Context: Performance improvements from all previous phases
129
129
  - Output: Monitoring dashboards, alert rules, SLI/SLO definitions, runbooks
130
130
 
131
131
  ### 13. Continuous Performance Optimization
132
132
 
133
- - Use Task tool with subagent_type="performance-engineer"
133
+ - Use Task tool with subagent_type="general-purpose"
134
134
  - Prompt: "Establish continuous optimization process for: $ARGUMENTS. Create performance budget tracking, implement A/B testing for performance changes, set up continuous profiling in production. Document optimization opportunities backlog, create capacity planning models, and establish regular performance review cycles."
135
135
  - Context: Monitoring setup from step 12, all previous optimization work
136
136
  - Output: Performance budget tracking, optimization backlog, capacity planning, review process
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Quick Answer — Direct response from codebase context
2
+ description: Quick Answer — Direct response from codebase context
3
3
  version: "1.0"
4
4
  category: knowledge
5
5
  execution-mode: execute
@@ -13,58 +13,22 @@ execution-mode: execute
13
13
 
14
14
  ---
15
15
 
16
- ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
16
+ ## Execution
17
17
 
18
- **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
-
20
- 1. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
23
-
24
- **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
18
+ One phase at a time, sequential. Each phase must complete before next begins.
25
19
 
26
20
  ---
27
21
 
28
- ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
29
-
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
31
-
32
- ```yaml
33
- tiered_execution:
34
- principle: "Sub-agent FIRST (Tier 1). EMBODY ONLY on system failure (Tier 2)."
35
- for_each_phase:
36
- TIER_1_MANDATORY: "IF tool exists → MUST use SUB_AGENT_DELEGATION"
37
- TIER_2_FALLBACK: "ONLY on system error—NOT complexity/preference/speed"
38
- anti_lazy_fallback:
39
- - ❌ NEVER use Tier 2 when Tier 1 tool is available
40
- - ✅ ALWAYS attempt Tier 1 first when tool exists
41
- ```
42
-
43
- ---
44
-
45
- ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
46
-
47
- 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).
48
-
49
- ---
50
-
51
- ## 🎭 Phase 1: CONTEXT GATHERING
22
+ ## Phase 1: CONTEXT GATHERING
52
23
 
53
24
  | Attribute | Value |
54
25
  | --------- | ------------------------------------ |
55
- | **Agent** | `scouter` |
26
+ | **Role** | `scouter` |
56
27
  | **Goal** | Find relevant code and documentation |
57
28
 
58
- ### ⚡ TIERED EXECUTION
59
-
60
- **TIER 1 (MANDATORY when tool exists):**
61
-
62
- > Invoke runSubagent for `scouter`. Context: ISOLATED.
29
+ ### Delegation
63
30
 
64
- **TIER 2 (FALLBACK on system error only):**
65
-
66
- > Load `{AGENTS_PATH}/scouter.md`
67
- > EMBODY [scouter] — Requires logged system error justification.
31
+ > Task(subagent_type="general-purpose", prompt="You are a scouter. Find relevant code and documentation for the given question. Exit when: relevant files identified, context gathered, information sufficient.", description="scouter: Find relevant code and documentation")
68
32
 
69
33
  **Exit Criteria:**
70
34
 
@@ -74,23 +38,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
74
38
 
75
39
  ---
76
40
 
77
- ## 🎭 Phase 2: ANSWER FORMULATION
41
+ ## Phase 2: ANSWER FORMULATION
78
42
 
79
43
  | Attribute | Value |
80
44
  | --------- | -------------------------------- |
81
- | **Agent** | `researcher` |
45
+ | **Role** | `researcher` |
82
46
  | **Goal** | Formulate clear, accurate answer |
83
47
 
84
- ### ⚡ TIERED EXECUTION
85
-
86
- **TIER 1 (MANDATORY when tool exists):**
87
-
88
- > Invoke runSubagent for `researcher`. Context: ISOLATED.
89
-
90
- **TIER 2 (FALLBACK on system error only):**
48
+ ### Delegation
91
49
 
92
- > Load `{AGENTS_PATH}/researcher.md`
93
- > EMBODY [researcher] — Requires logged system error justification.
50
+ > Task(subagent_type="general-purpose", prompt="You are a researcher. Formulate a clear, accurate answer based on the gathered context. Exit when: answer formulated, sources cited, confidence level noted.", description="researcher: Formulate clear, accurate answer")
94
51
 
95
52
  **Exit Criteria:**
96
53
 
@@ -114,6 +71,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
114
71
 
115
72
  Present answer with:
116
73
 
117
- 1. **Answered** — Question resolved
118
- 2. 🔬 **Deep Dive** → `/ask:hard` for more detail
119
- 3. 💻 **Implement** → Route to implementation workflow
74
+ 1. **Answered** — Question resolved
75
+ 2. **Deep Dive** → `/ask:hard` for more detail
76
+ 3. **Implement** → Route to implementation workflow
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: ⚡⚡⚡ Research Answer — External research with comprehensive analysis
2
+ description: Research Answer — External research with comprehensive analysis
3
3
  version: "1.0"
4
4
  category: knowledge
5
5
  execution-mode: execute
@@ -13,58 +13,22 @@ execution-mode: execute
13
13
 
14
14
  ---
15
15
 
16
- ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
16
+ ## Execution
17
17
 
18
- **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
19
-
20
- 1. ORCHESTRATION-LAWS.md
21
- 2. ADAPTIVE-EXECUTION.md
22
- 3. EXECUTION-PROTOCOL.md
23
-
24
- **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
-
26
- ---
27
-
28
- ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
29
-
30
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
31
-
32
- ```yaml
33
- tiered_execution:
34
- principle: "Sub-agent FIRST (Tier 1). EMBODY ONLY on system failure (Tier 2)."
35
- for_each_phase:
36
- TIER_1_MANDATORY: "IF tool exists → MUST use SUB_AGENT_DELEGATION"
37
- TIER_2_FALLBACK: "ONLY on system error—NOT complexity/preference/speed"
38
- anti_lazy_fallback:
39
- - ❌ NEVER use Tier 2 when Tier 1 tool is available
40
- - ✅ ALWAYS attempt Tier 1 first when tool exists
41
- ```
42
-
43
- ---
44
-
45
- ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
46
-
47
- 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).
18
+ One phase at a time, sequential. Each phase must complete before next begins.
48
19
 
49
20
  ---
50
21
 
51
- ## 🎭 Phase 1: QUESTION ANALYSIS
22
+ ## Phase 1: QUESTION ANALYSIS
52
23
 
53
24
  | Attribute | Value |
54
25
  | --------- | ------------------------------------------- |
55
- | **Agent** | `brainstormer` |
26
+ | **Role** | `brainstormer` |
56
27
  | **Goal** | Decompose question into research components |
57
28
 
58
- ### ⚡ TIERED EXECUTION
59
-
60
- **TIER 1 (MANDATORY when tool exists):**
29
+ ### Delegation
61
30
 
62
- > Invoke runSubagent for `brainstormer`. Context: ISOLATED.
63
-
64
- **TIER 2 (FALLBACK on system error only):**
65
-
66
- > Load `{AGENTS_PATH}/brainstormer.md`
67
- > EMBODY [brainstormer] — Requires logged system error justification.
31
+ > Task(subagent_type="general-purpose", prompt="You are a brainstormer. Decompose the question into research components. Exit when: question scope defined, research areas identified, success criteria established.", description="brainstormer: Decompose question into research components")
68
32
 
69
33
  **Exit Criteria:**
70
34
 
@@ -74,23 +38,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
74
38
 
75
39
  ---
76
40
 
77
- ## 🎭 Phase 2: CODEBASE ANALYSIS
41
+ ## Phase 2: CODEBASE ANALYSIS
78
42
 
79
43
  | Attribute | Value |
80
44
  | --------- | ----------------------------- |
81
- | **Agent** | `scouter` |
45
+ | **Role** | `scouter` |
82
46
  | **Goal** | Map relevant codebase context |
83
47
 
84
- ### ⚡ TIERED EXECUTION
85
-
86
- **TIER 1 (MANDATORY when tool exists):**
48
+ ### Delegation
87
49
 
88
- > Invoke runSubagent for `scouter`. Context: ISOLATED.
89
-
90
- **TIER 2 (FALLBACK on system error only):**
91
-
92
- > Load `{AGENTS_PATH}/scouter.md`
93
- > EMBODY [scouter] — Requires logged system error justification.
50
+ > Task(subagent_type="general-purpose", prompt="You are a scouter. Map relevant codebase context for the question. Exit when: relevant code found, patterns documented, internal context complete.", description="scouter: Map relevant codebase context")
94
51
 
95
52
  **Exit Criteria:**
96
53
 
@@ -100,23 +57,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
100
57
 
101
58
  ---
102
59
 
103
- ## 🎭 Phase 3: EXTERNAL RESEARCH
60
+ ## Phase 3: EXTERNAL RESEARCH
104
61
 
105
62
  | Attribute | Value |
106
63
  | --------- | -------------------------------------------- |
107
- | **Agent** | `researcher` |
64
+ | **Role** | `researcher` |
108
65
  | **Goal** | Research external sources and best practices |
109
66
 
110
- ### ⚡ TIERED EXECUTION
111
-
112
- **TIER 1 (MANDATORY when tool exists):**
67
+ ### Delegation
113
68
 
114
- > Invoke runSubagent for `researcher`. Context: ISOLATED.
115
-
116
- **TIER 2 (FALLBACK on system error only):**
117
-
118
- > Load `{AGENTS_PATH}/researcher.md`
119
- > EMBODY [researcher] — Requires logged system error justification.
69
+ > Task(subagent_type="general-purpose", prompt="You are a researcher. Research external sources and best practices relevant to the question. Exit when: external sources consulted, best practices identified, sources documented.", description="researcher: Research external sources and best practices")
120
70
 
121
71
  **Exit Criteria:**
122
72
 
@@ -126,23 +76,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
126
76
 
127
77
  ---
128
78
 
129
- ## 🎭 Phase 4: SYNTHESIS
79
+ ## Phase 4: SYNTHESIS
130
80
 
131
81
  | Attribute | Value |
132
82
  | --------- | ------------------------------- |
133
- | **Agent** | `researcher` |
83
+ | **Role** | `researcher` |
134
84
  | **Goal** | Synthesize comprehensive answer |
135
85
 
136
- ### ⚡ TIERED EXECUTION
137
-
138
- **TIER 1 (MANDATORY when tool exists):**
139
-
140
- > Invoke runSubagent for `researcher`. Context: ISOLATED.
141
-
142
- **TIER 2 (FALLBACK on system error only):**
86
+ ### Delegation
143
87
 
144
- > Load `{AGENTS_PATH}/researcher.md`
145
- > EMBODY [researcher] — Requires logged system error justification.
88
+ > Task(subagent_type="general-purpose", prompt="You are a researcher. Synthesize all gathered information into a comprehensive answer. Exit when: all sources synthesized, answer comprehensive, actionable recommendations included.", description="researcher: Synthesize comprehensive answer")
146
89
 
147
90
  **Exit Criteria:**
148
91
 
@@ -156,6 +99,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
156
99
 
157
100
  Present research report with:
158
101
 
159
- 1. **Answered** — Question resolved
160
- 2. 📋 **Plan** → `/plan:hard` if implementation needed
161
- 3. 💻 **Implement** → `/code:hard` for complex implementation
102
+ 1. **Answered** — Question resolved
103
+ 2. **Plan** → `/plan:hard` if implementation needed
104
+ 3. **Implement** → `/code:hard` for complex implementation
@@ -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
  ```
@@ -35,27 +24,16 @@ execution-mode: router
35
24
 
36
25
  ---
37
26
 
38
- ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
39
-
40
- 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).
41
-
42
- ---
43
-
44
27
  ## 🎭 Phase 1: TASK ANALYSIS
45
28
 
46
29
  | Attribute | Value |
47
30
  |-----------|-------|
48
- | **Agent** | `tech-lead` |
31
+ | **Role** | `tech-lead` |
49
32
  | **Goal** | Classify task and select workflow |
50
33
 
51
- ### ⚡ ADAPTIVE EXECUTION
34
+ ### Delegation
52
35
 
53
- **IF platform supports subagents:**
54
- > Delegate to `tech-lead` subagent. Do NOT read agent file directly.
55
-
56
- **ELSE (EMBODY fallback):**
57
- > Load `{AGENTS_PATH}/tech-lead.md`
58
- > EMBODY [tech-lead] — Apply methodology from agent file.
36
+ > Task(subagent_type="general-purpose", prompt="You are a tech-lead. Classify task and select workflow. [See exit criteria below]", description="tech-lead")
59
37
 
60
38
  **Exit Criteria:**
61
39
 
@@ -83,17 +61,12 @@ Execute selected workflow phases without pause:
83
61
 
84
62
  | Attribute | Value |
85
63
  |-----------|-------|
86
- | **Agent** | `tech-lead` |
64
+ | **Role** | `tech-lead` |
87
65
  | **Goal** | Synthesize results and present summary |
88
66
 
89
- ### ⚡ ADAPTIVE EXECUTION
90
-
91
- **IF platform supports subagents:**
92
- > Delegate to `tech-lead` subagent. Do NOT read agent file directly.
67
+ ### Delegation
93
68
 
94
- **ELSE (EMBODY fallback):**
95
- > Load `{AGENTS_PATH}/tech-lead.md`
96
- > EMBODY [tech-lead] — Apply methodology from agent file.
69
+ > Task(subagent_type="general-purpose", prompt="You are a tech-lead. Synthesize results and present summary. [See exit criteria below]", description="tech-lead")
97
70
 
98
71
  **Exit Criteria:**
99
72
 
@@ -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