@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
@@ -31,18 +31,18 @@ Build features guided by data insights, A/B testing, and continuous measurement
31
31
  ## Phase 1: Data Analysis and Hypothesis Formation
32
32
 
33
33
  ### 1. Exploratory Data Analysis
34
- - Use Task tool with subagent_type="machine-learning-ops::data-scientist"
34
+ - Use Task tool with subagent_type="general-purpose"
35
35
  - Prompt: "Perform exploratory data analysis for feature: $ARGUMENTS. Analyze existing user behavior data, identify patterns and opportunities, segment users by behavior, and calculate baseline metrics. Use modern analytics tools (Amplitude, Mixpanel, Segment) to understand current user journeys, conversion funnels, and engagement patterns."
36
36
  - Output: EDA report with visualizations, user segments, behavioral patterns, baseline metrics
37
37
 
38
38
  ### 2. Business Hypothesis Development
39
- - Use Task tool with subagent_type="business-analytics::business-analyst"
39
+ - Use Task tool with subagent_type="general-purpose"
40
40
  - Context: Data scientist's EDA findings and behavioral patterns
41
41
  - Prompt: "Formulate business hypotheses for feature: $ARGUMENTS based on data analysis. Define clear success metrics, expected impact on key business KPIs, target user segments, and minimum detectable effects. Create measurable hypotheses using frameworks like ICE scoring or RICE prioritization."
42
42
  - Output: Hypothesis document, success metrics definition, expected ROI calculations
43
43
 
44
44
  ### 3. Statistical Experiment Design
45
- - Use Task tool with subagent_type="machine-learning-ops::data-scientist"
45
+ - Use Task tool with subagent_type="general-purpose"
46
46
  - Context: Business hypotheses and success metrics
47
47
  - Prompt: "Design statistical experiment for feature: $ARGUMENTS. Calculate required sample size for statistical power, define control and treatment groups, specify randomization strategy, and plan for multiple testing corrections. Consider Bayesian A/B testing approaches for faster decision making. Design for both primary and guardrail metrics."
48
48
  - Output: Experiment design document, power analysis, statistical test plan
@@ -50,19 +50,19 @@ Build features guided by data insights, A/B testing, and continuous measurement
50
50
  ## Phase 2: Feature Architecture and Analytics Design
51
51
 
52
52
  ### 4. Feature Architecture Planning
53
- - Use Task tool with subagent_type="data-engineering::backend-architect"
53
+ - Use Task tool with subagent_type="general-purpose"
54
54
  - Context: Business requirements and experiment design
55
55
  - Prompt: "Design feature architecture for: $ARGUMENTS with A/B testing capability. Include feature flag integration (LaunchDarkly, Split.io, or Optimizely), gradual rollout strategy, circuit breakers for safety, and clean separation between control and treatment logic. Ensure architecture supports real-time configuration updates."
56
56
  - Output: Architecture diagrams, feature flag schema, rollout strategy
57
57
 
58
58
  ### 5. Analytics Instrumentation Design
59
- - Use Task tool with subagent_type="data-engineering::data-engineer"
59
+ - Use Task tool with subagent_type="general-purpose"
60
60
  - Context: Feature architecture and success metrics
61
61
  - Prompt: "Design comprehensive analytics instrumentation for: $ARGUMENTS. Define event schemas for user interactions, specify properties for segmentation and analysis, design funnel tracking and conversion events, plan cohort analysis capabilities. Implement using modern SDKs (Segment, Amplitude, Mixpanel) with proper event taxonomy."
62
62
  - Output: Event tracking plan, analytics schema, instrumentation guide
63
63
 
64
64
  ### 6. Data Pipeline Architecture
65
- - Use Task tool with subagent_type="data-engineering::data-engineer"
65
+ - Use Task tool with subagent_type="general-purpose"
66
66
  - Context: Analytics requirements and existing data infrastructure
67
67
  - Prompt: "Design data pipelines for feature: $ARGUMENTS. Include real-time streaming for live metrics (Kafka, Kinesis), batch processing for detailed analysis, data warehouse integration (Snowflake, BigQuery), and feature store for ML if applicable. Ensure proper data governance and GDPR compliance."
68
68
  - Output: Pipeline architecture, ETL/ELT specifications, data flow diagrams
@@ -70,19 +70,19 @@ Build features guided by data insights, A/B testing, and continuous measurement
70
70
  ## Phase 3: Implementation with Instrumentation
71
71
 
72
72
  ### 7. Backend Implementation
73
- - Use Task tool with subagent_type="backend-development::backend-architect"
73
+ - Use Task tool with subagent_type="general-purpose"
74
74
  - Context: Architecture design and feature requirements
75
75
  - Prompt: "Implement backend for feature: $ARGUMENTS with full instrumentation. Include feature flag checks at decision points, comprehensive event tracking for all user actions, performance metrics collection, error tracking and monitoring. Implement proper logging for experiment analysis."
76
76
  - Output: Backend code with analytics, feature flag integration, monitoring setup
77
77
 
78
78
  ### 8. Frontend Implementation
79
- - Use Task tool with subagent_type="frontend-mobile-development::frontend-developer"
79
+ - Use Task tool with subagent_type="general-purpose"
80
80
  - Context: Backend APIs and analytics requirements
81
81
  - Prompt: "Build frontend for feature: $ARGUMENTS with analytics tracking. Implement event tracking for all user interactions, session recording integration if applicable, performance metrics (Core Web Vitals), and proper error boundaries. Ensure consistent experience between control and treatment groups."
82
82
  - Output: Frontend code with analytics, A/B test variants, performance monitoring
83
83
 
84
84
  ### 9. ML Model Integration (if applicable)
85
- - Use Task tool with subagent_type="machine-learning-ops::ml-engineer"
85
+ - Use Task tool with subagent_type="general-purpose"
86
86
  - Context: Feature requirements and data pipelines
87
87
  - Prompt: "Integrate ML models for feature: $ARGUMENTS if needed. Implement online inference with low latency, A/B testing between model versions, model performance tracking, and automatic fallback mechanisms. Set up model monitoring for drift detection."
88
88
  - Output: ML pipeline, model serving infrastructure, monitoring setup
@@ -90,13 +90,13 @@ Build features guided by data insights, A/B testing, and continuous measurement
90
90
  ## Phase 4: Pre-Launch Validation
91
91
 
92
92
  ### 10. Analytics Validation
93
- - Use Task tool with subagent_type="data-engineering::data-engineer"
93
+ - Use Task tool with subagent_type="general-purpose"
94
94
  - Context: Implemented tracking and event schemas
95
95
  - Prompt: "Validate analytics implementation for: $ARGUMENTS. Test all event tracking in staging, verify data quality and completeness, validate funnel definitions, ensure proper user identification and session tracking. Run end-to-end tests for data pipeline."
96
96
  - Output: Validation report, data quality metrics, tracking coverage analysis
97
97
 
98
98
  ### 11. Experiment Setup
99
- - Use Task tool with subagent_type="cloud-infrastructure::deployment-engineer"
99
+ - Use Task tool with subagent_type="general-purpose"
100
100
  - Context: Feature flags and experiment design
101
101
  - Prompt: "Configure experiment infrastructure for: $ARGUMENTS. Set up feature flags with proper targeting rules, configure traffic allocation (start with 5-10%), implement kill switches, set up monitoring alerts for key metrics. Test randomization and assignment logic."
102
102
  - Output: Experiment configuration, monitoring dashboards, rollout plan
@@ -104,13 +104,13 @@ Build features guided by data insights, A/B testing, and continuous measurement
104
104
  ## Phase 5: Launch and Experimentation
105
105
 
106
106
  ### 12. Gradual Rollout
107
- - Use Task tool with subagent_type="cloud-infrastructure::deployment-engineer"
107
+ - Use Task tool with subagent_type="general-purpose"
108
108
  - Context: Experiment configuration and monitoring setup
109
109
  - Prompt: "Execute gradual rollout for feature: $ARGUMENTS. Start with internal dogfooding, then beta users (1-5%), gradually increase to target traffic. Monitor error rates, performance metrics, and early indicators. Implement automated rollback on anomalies."
110
110
  - Output: Rollout execution, monitoring alerts, health metrics
111
111
 
112
112
  ### 13. Real-time Monitoring
113
- - Use Task tool with subagent_type="observability-monitoring::observability-engineer"
113
+ - Use Task tool with subagent_type="general-purpose"
114
114
  - Context: Deployed feature and success metrics
115
115
  - Prompt: "Set up comprehensive monitoring for: $ARGUMENTS. Create real-time dashboards for experiment metrics, configure alerts for statistical significance, monitor guardrail metrics for negative impacts, track system performance and error rates. Use tools like Datadog, New Relic, or custom dashboards."
116
116
  - Output: Monitoring dashboards, alert configurations, SLO definitions
@@ -118,19 +118,19 @@ Build features guided by data insights, A/B testing, and continuous measurement
118
118
  ## Phase 6: Analysis and Decision Making
119
119
 
120
120
  ### 14. Statistical Analysis
121
- - Use Task tool with subagent_type="machine-learning-ops::data-scientist"
121
+ - Use Task tool with subagent_type="general-purpose"
122
122
  - Context: Experiment data and original hypotheses
123
123
  - Prompt: "Analyze A/B test results for: $ARGUMENTS. Calculate statistical significance with confidence intervals, check for segment-level effects, analyze secondary metrics impact, investigate any unexpected patterns. Use both frequentist and Bayesian approaches. Account for multiple testing if applicable."
124
124
  - Output: Statistical analysis report, significance tests, segment analysis
125
125
 
126
126
  ### 15. Business Impact Assessment
127
- - Use Task tool with subagent_type="business-analytics::business-analyst"
127
+ - Use Task tool with subagent_type="general-purpose"
128
128
  - Context: Statistical analysis and business metrics
129
129
  - Prompt: "Assess business impact of feature: $ARGUMENTS. Calculate actual vs expected ROI, analyze impact on key business metrics, evaluate cost-benefit including operational overhead, project long-term value. Make recommendation on full rollout, iteration, or rollback."
130
130
  - Output: Business impact report, ROI analysis, recommendation document
131
131
 
132
132
  ### 16. Post-Launch Optimization
133
- - Use Task tool with subagent_type="machine-learning-ops::data-scientist"
133
+ - Use Task tool with subagent_type="general-purpose"
134
134
  - Context: Launch results and user feedback
135
135
  - Prompt: "Identify optimization opportunities for: $ARGUMENTS based on data. Analyze user behavior patterns in treatment group, identify friction points in user journey, suggest improvements based on data, plan follow-up experiments. Use cohort analysis for long-term impact."
136
136
  - Output: Optimization recommendations, follow-up experiment plans
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Quick Debug — Fast diagnosis for simple bugs
2
+ description: Quick Debug — Fast diagnosis for simple bugs
3
3
  version: "1.0"
4
4
  category: debugging
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: QUICK DIAGNOSIS
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** | `debugger` |
26
+ | **Goal** | Fast root cause identification |
27
+ | **Exit** | Root cause identified |
41
28
 
42
- ## 🎭 Phase 1: QUICK DIAGNOSIS
29
+ ### Delegation
43
30
 
44
- | Agent | `debugger` |
45
- |-------|------------|
46
- | Goal | Fast root cause identification |
47
- | Exit | Root cause identified |
31
+ > Task(subagent_type="general-purpose", prompt="You are a debugger. Perform fast root cause identification for the given issue. Exit when root cause is identified.", description="debugger: Fast root cause identification")
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 findings with:
63
47
 
64
- 1. **Root Cause** — Identified
65
- 2. 🔧 **Fix** → `/fix:fast`
48
+ 1. **Root Cause** — Identified
49
+ 2. **Fix** → `/fix:fast`
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: ⚡⚡⚡ Full Debug — Deep investigation for complex issues
2
+ description: Full Debug — Deep investigation for complex issues
3
3
  version: "1.0"
4
4
  category: debugging
5
5
  execution-mode: execute
@@ -13,77 +13,75 @@ execution-mode: execute
13
13
 
14
14
  ---
15
15
 
16
- ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
16
+ ## DELIVERABLE FILES
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
18
+ | Role | Output |
19
+ |------|--------|
20
+ | debugger | `./reports/debugs/DEBUG-{issue}.md` |
23
21
 
24
- **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
22
+ All files in `./reports/` English only.
25
23
 
26
24
  ---
27
25
 
28
- ## 🔀 TIERED EXECUTION
29
-
30
- | Tier | When | Action |
31
- | ---------- | ------------------ | ---------------------------- |
32
- | **TIER 1** | runSubagent EXISTS | Invoke sub-agent (MANDATORY) |
33
- | **TIER 2** | Tool MISSING | EMBODY agent file (FALLBACK) |
26
+ ## Execution
27
+ One phase at a time, sequential. Each phase must complete before next begins.
34
28
 
35
29
  ---
36
30
 
37
- ## 📁 DELIVERABLE FILES
31
+ ## Phase 1: INFORMATION GATHERING
38
32
 
39
- | Agent | Output |
40
- | -------- | ----------------------------------- |
41
- | debugger | `./reports/debugs/DEBUG-{issue}.md` |
33
+ | Attribute | Value |
34
+ |-----------|-------|
35
+ | **Role** | `scouter` |
36
+ | **Goal** | Gather context and reproduction steps |
37
+ | **Exit** | Context gathered, reproduction documented |
42
38
 
43
- All files in `./reports/` → English only.
39
+ ### Delegation
44
40
 
45
- ---
41
+ > Task(subagent_type="general-purpose", prompt="You are a scouter. Gather context and reproduction steps for the given issue. Exit when context is gathered and reproduction is documented.", description="scouter: Gather context and reproduction steps")
46
42
 
47
- ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
43
+ ---
48
44
 
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).
45
+ ## Phase 2: HYPOTHESIS FORMATION
50
46
 
51
- ---
47
+ | Attribute | Value |
48
+ |-----------|-------|
49
+ | **Role** | `debugger` |
50
+ | **Goal** | Form and rank hypotheses |
51
+ | **Exit** | Hypotheses documented with evidence |
52
52
 
53
- ## 🎭 Phase 1: INFORMATION GATHERING
53
+ ### Delegation
54
54
 
55
- | Agent | `scouter` |
56
- | ----- | ----------------------------------------- |
57
- | Goal | Gather context and reproduction steps |
58
- | Exit | Context gathered, reproduction documented |
55
+ > Task(subagent_type="general-purpose", prompt="You are a debugger. Form and rank hypotheses for the issue. Exit when hypotheses are documented with evidence.", description="debugger: Form and rank hypotheses")
59
56
 
60
57
  ---
61
58
 
62
- ## 🎭 Phase 2: HYPOTHESIS FORMATION
63
-
64
- | Agent | `debugger` |
65
- | ----- | ----------------------------------- |
66
- | Goal | Form and rank hypotheses |
67
- | Exit | Hypotheses documented with evidence |
59
+ ## Phase 3: ROOT CAUSE ANALYSIS
68
60
 
69
- ---
61
+ | Attribute | Value |
62
+ |-----------|-------|
63
+ | **Role** | `debugger` |
64
+ | **Goal** | Deep investigation |
65
+ | **Output** | `./reports/debugs/DEBUG-{issue}.md` |
66
+ | **Exit** | Root cause identified, failure chain documented |
70
67
 
71
- ## 🎭 Phase 3: ROOT CAUSE ANALYSIS
68
+ ### Delegation
72
69
 
73
- | Agent | `debugger` |
74
- | ------ | ----------------------------------------------- |
75
- | Goal | Deep investigation |
76
- | Output | `./reports/debugs/DEBUG-{issue}.md` |
77
- | Exit | Root cause identified, failure chain documented |
70
+ > Task(subagent_type="general-purpose", prompt="You are a debugger. Perform deep investigation to identify root cause. Write findings to ./reports/debugs/DEBUG-{issue}.md. Exit when root cause is identified and failure chain is documented.", description="debugger: Deep root cause investigation")
78
71
 
79
72
  ---
80
73
 
81
- ## 🎭 Phase 4: SOLUTION DESIGN
74
+ ## Phase 4: SOLUTION DESIGN
75
+
76
+ | Attribute | Value |
77
+ |-----------|-------|
78
+ | **Role** | `planner` |
79
+ | **Goal** | Design fix strategy |
80
+ | **Exit** | Fix approach defined with rollback plan |
81
+
82
+ ### Delegation
82
83
 
83
- | Agent | `planner` |
84
- | ----- | --------------------------------------- |
85
- | Goal | Design fix strategy |
86
- | Exit | Fix approach defined with rollback plan |
84
+ > Task(subagent_type="general-purpose", prompt="You are a planner. Design a fix strategy based on the root cause analysis. Exit when fix approach is defined with rollback plan.", description="planner: Design fix strategy")
87
85
 
88
86
  ---
89
87
 
@@ -91,6 +89,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
91
89
 
92
90
  Present findings with:
93
91
 
94
- 1. **Root Cause** — Identified
95
- 2. 🔧 **Fix** → `/fix:hard`
96
- 3. 📝 **Document** → `/docs:core`
92
+ 1. **Root Cause** — Identified
93
+ 2. **Fix** → `/fix:hard`
94
+ 3. **Document** → `/docs:core`
@@ -6,7 +6,7 @@ argument-hint: [issues]
6
6
  **Reported Issues**:
7
7
  $ARGUMENTS
8
8
 
9
- Use the `debugger` subagent to find the root cause of the issues, then analyze and explain the reports to the user.
9
+ Use a Task agent for debugging to find the root cause of the issues, then analyze and explain the reports to the user: Task(subagent_type="general-purpose", prompt="You are a debugger. Find root cause of issues...", description="Debug issues")
10
10
 
11
11
  **IMPORTANT**: **Do not** implement the fix automatically.
12
12
  **IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
@@ -39,7 +39,7 @@ Parse for:
39
39
  ## Workflow
40
40
 
41
41
  ### 1. Initial Triage
42
- Use Task tool (subagent_type="debugger") for AI-powered analysis:
42
+ Use Task tool (subagent_type="general-purpose") for AI-powered analysis:
43
43
  - Error pattern recognition
44
44
  - Stack trace analysis with probable causes
45
45
  - Component dependency analysis
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Deploy Check — Pre-deployment readiness verification
2
+ description: Deploy Check — Pre-deployment readiness verification
3
3
  version: "1.0"
4
4
  category: operations
5
5
  execution-mode: execute
@@ -11,55 +11,21 @@ execution-mode: execute
11
11
 
12
12
  ---
13
13
 
14
- ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
15
-
16
- **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
17
- 1. ORCHESTRATION-LAWS.md
18
- 2. ADAPTIVE-EXECUTION.md
19
- 3. EXECUTION-PROTOCOL.md
20
-
21
- **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
22
-
23
- ---
24
-
25
- ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
26
-
27
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
28
-
29
- ```yaml
30
- tiered_execution:
31
- principle: "Sub-agent FIRST (Tier 1). EMBODY ONLY on system failure (Tier 2)."
32
- for_each_phase:
33
- TIER_1_MANDATORY: "IF tool exists → MUST use SUB_AGENT_DELEGATION"
34
- TIER_2_FALLBACK: "ONLY on system error—NOT complexity/preference/speed"
35
- anti_lazy_fallback:
36
- - ❌ NEVER use Tier 2 when Tier 1 tool is available
37
- - ✅ ALWAYS attempt Tier 1 first when tool exists
38
- ```
14
+ ## Execution
15
+ One phase at a time, sequential. Each phase must complete before next begins.
39
16
 
40
17
  ---
41
18
 
42
- ## INCREMENTAL EXECUTION (MANDATORY)
43
-
44
- 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).
45
-
46
- ---
47
-
48
- ## 🎭 Phase 1: CODE QUALITY CHECK
19
+ ## Phase 1: CODE QUALITY CHECK
49
20
 
50
21
  | Attribute | Value |
51
22
  |-----------|-------|
52
- | **Agent** | `reviewer` |
23
+ | **Role** | `reviewer` |
53
24
  | **Goal** | Verify code quality standards |
54
25
 
55
- ### ⚡ TIERED EXECUTION
56
-
57
- **TIER 1 (MANDATORY when tool exists):**
58
- > Invoke runSubagent for `reviewer`. Context: ISOLATED.
26
+ ### Delegation
59
27
 
60
- **TIER 2 (FALLBACK on system error only):**
61
- > Load `{AGENTS_PATH}/reviewer.md`
62
- > EMBODY [reviewer] — Requires logged system error justification.
28
+ > Task(subagent_type="general-purpose", prompt="You are a reviewer. Verify code quality standards are met. Exit when no critical issues remain, standards are met, and code is approved for deploy.", description="reviewer: Verify code quality standards")
63
29
 
64
30
  **Exit Criteria:**
65
31
 
@@ -69,21 +35,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
69
35
 
70
36
  ---
71
37
 
72
- ## 🎭 Phase 2: TEST VERIFICATION
38
+ ## Phase 2: TEST VERIFICATION
73
39
 
74
40
  | Attribute | Value |
75
41
  |-----------|-------|
76
- | **Agent** | `tester` |
42
+ | **Role** | `tester` |
77
43
  | **Goal** | Verify all tests passing |
78
44
 
79
- ### ⚡ TIERED EXECUTION
45
+ ### Delegation
80
46
 
81
- **TIER 1 (MANDATORY when tool exists):**
82
- > Invoke runSubagent for `tester`. Context: ISOLATED.
83
-
84
- **TIER 2 (FALLBACK on system error only):**
85
- > Load `{AGENTS_PATH}/tester.md`
86
- > EMBODY [tester] — Requires logged system error justification.
47
+ > Task(subagent_type="general-purpose", prompt="You are a tester. Verify all tests are passing with adequate coverage and no flaky tests. Exit when all tests pass, coverage is adequate, and no flaky tests exist.", description="tester: Verify all tests passing")
87
48
 
88
49
  **Exit Criteria:**
89
50
 
@@ -93,21 +54,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
93
54
 
94
55
  ---
95
56
 
96
- ## 🎭 Phase 3: SECURITY SCAN
57
+ ## Phase 3: SECURITY SCAN
97
58
 
98
59
  | Attribute | Value |
99
60
  |-----------|-------|
100
- | **Agent** | `security-engineer` |
61
+ | **Role** | `security-engineer` |
101
62
  | **Goal** | Security vulnerability check |
102
63
 
103
- ### ⚡ TIERED EXECUTION
104
-
105
- **TIER 1 (MANDATORY when tool exists):**
106
- > Invoke runSubagent for `security-engineer`. Context: ISOLATED.
64
+ ### Delegation
107
65
 
108
- **TIER 2 (FALLBACK on system error only):**
109
- > Load `{AGENTS_PATH}/security-engineer.md`
110
- > EMBODY [security-engineer] — Requires logged system error justification.
66
+ > Task(subagent_type="general-purpose", prompt="You are a security-engineer. Perform a security vulnerability check. Exit when no critical vulnerabilities exist, dependencies are secure, and secrets are not exposed.", description="security-engineer: Security vulnerability check")
111
67
 
112
68
  **Exit Criteria:**
113
69
 
@@ -117,21 +73,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
117
73
 
118
74
  ---
119
75
 
120
- ## 🎭 Phase 4: INFRASTRUCTURE CHECK
76
+ ## Phase 4: INFRASTRUCTURE CHECK
121
77
 
122
78
  | Attribute | Value |
123
79
  |-----------|-------|
124
- | **Agent** | `devops-engineer` |
80
+ | **Role** | `devops-engineer` |
125
81
  | **Goal** | Verify infrastructure readiness |
126
82
 
127
- ### ⚡ TIERED EXECUTION
128
-
129
- **TIER 1 (MANDATORY when tool exists):**
130
- > Invoke runSubagent for `devops-engineer`. Context: ISOLATED.
83
+ ### Delegation
131
84
 
132
- **TIER 2 (FALLBACK on system error only):**
133
- > Load `{AGENTS_PATH}/devops-engineer.md`
134
- > EMBODY [devops-engineer] — Requires logged system error justification.
85
+ > Task(subagent_type="general-purpose", prompt="You are a devops-engineer. Verify infrastructure readiness for deployment. Exit when build succeeds, environment is configured, and rollback plan is ready.", description="devops-engineer: Verify infrastructure readiness")
135
86
 
136
87
  **Exit Criteria:**
137
88
 
@@ -145,6 +96,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
145
96
 
146
97
  Present readiness report with:
147
98
 
148
- 1. **Ready** → `/deploy:preview` or `/deploy:production`
149
- 2. **Not Ready** — Issues to address
150
- 3. 🔧 **Fix Issues** → Route to appropriate fix workflow
99
+ 1. **Ready** → `/deploy:preview` or `/deploy:production`
100
+ 2. **Not Ready** — Issues to address
101
+ 3. **Fix Issues** → Route to appropriate fix workflow
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: 🔍 Deploy Preview — Staging/Preview deployment
2
+ description: Deploy Preview — Staging/Preview deployment
3
3
  version: "1.0"
4
4
  category: operations
5
5
  execution-mode: execute
@@ -11,55 +11,21 @@ execution-mode: execute
11
11
 
12
12
  ---
13
13
 
14
- ## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
15
-
16
- **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
17
- 1. ORCHESTRATION-LAWS.md
18
- 2. ADAPTIVE-EXECUTION.md
19
- 3. EXECUTION-PROTOCOL.md
20
-
21
- **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
22
-
23
- ---
24
-
25
- ## 🔀 TIERED EXECUTION PROTOCOL (MANDATORY)
26
-
27
- > **Reference**: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
28
-
29
- ```yaml
30
- tiered_execution:
31
- principle: "Sub-agent FIRST (Tier 1). EMBODY ONLY on system failure (Tier 2)."
32
- for_each_phase:
33
- TIER_1_MANDATORY: "IF tool exists → MUST use SUB_AGENT_DELEGATION"
34
- TIER_2_FALLBACK: "ONLY on system error—NOT complexity/preference/speed"
35
- anti_lazy_fallback:
36
- - ❌ NEVER use Tier 2 when Tier 1 tool is available
37
- - ✅ ALWAYS attempt Tier 1 first when tool exists
38
- ```
14
+ ## Execution
15
+ One phase at a time, sequential. Each phase must complete before next begins.
39
16
 
40
17
  ---
41
18
 
42
- ## INCREMENTAL EXECUTION (MANDATORY)
43
-
44
- 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).
45
-
46
- ---
47
-
48
- ## 🎭 Phase 1: READINESS CHECK
19
+ ## Phase 1: READINESS CHECK
49
20
 
50
21
  | Attribute | Value |
51
22
  |-----------|-------|
52
- | **Agent** | `devops-engineer` |
23
+ | **Role** | `devops-engineer` |
53
24
  | **Goal** | Quick deployment readiness |
54
25
 
55
- ### ⚡ TIERED EXECUTION
26
+ ### Delegation
56
27
 
57
- **TIER 1 (MANDATORY when tool exists):**
58
- > Invoke runSubagent for `devops-engineer`. Context: ISOLATED.
59
-
60
- **TIER 2 (FALLBACK on system error only):**
61
- > Load `{AGENTS_PATH}/devops-engineer.md`
62
- > EMBODY [devops-engineer] — Requires logged system error justification.
28
+ > Task(subagent_type="general-purpose", prompt="You are a devops-engineer. Perform a quick deployment readiness check. Exit when build passes, tests pass, and no blockers exist.", description="devops-engineer: Quick deployment readiness")
63
29
 
64
30
  **Exit Criteria:**
65
31
 
@@ -69,21 +35,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
69
35
 
70
36
  ---
71
37
 
72
- ## 🎭 Phase 2: DEPLOY
38
+ ## Phase 2: DEPLOY
73
39
 
74
40
  | Attribute | Value |
75
41
  |-----------|-------|
76
- | **Agent** | `devops-engineer` |
42
+ | **Role** | `devops-engineer` |
77
43
  | **Goal** | Deploy to preview environment |
78
44
 
79
- ### ⚡ TIERED EXECUTION
80
-
81
- **TIER 1 (MANDATORY when tool exists):**
82
- > Invoke runSubagent for `devops-engineer`. Context: ISOLATED.
45
+ ### Delegation
83
46
 
84
- **TIER 2 (FALLBACK on system error only):**
85
- > Load `{AGENTS_PATH}/devops-engineer.md`
86
- > EMBODY [devops-engineer] — Requires logged system error justification.
47
+ > Task(subagent_type="general-purpose", prompt="You are a devops-engineer. Deploy to preview environment. Exit when deployment is successful and environment is accessible.", description="devops-engineer: Deploy to preview environment")
87
48
 
88
49
  **Exit Criteria:**
89
50
 
@@ -92,21 +53,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
92
53
 
93
54
  ---
94
55
 
95
- ## 🎭 Phase 3: VERIFICATION
56
+ ## Phase 3: VERIFICATION
96
57
 
97
58
  | Attribute | Value |
98
59
  |-----------|-------|
99
- | **Agent** | `devops-engineer` |
60
+ | **Role** | `devops-engineer` |
100
61
  | **Goal** | Verify deployment health |
101
62
 
102
- ### ⚡ TIERED EXECUTION
103
-
104
- **TIER 1 (MANDATORY when tool exists):**
105
- > Invoke runSubagent for `devops-engineer`. Context: ISOLATED.
63
+ ### Delegation
106
64
 
107
- **TIER 2 (FALLBACK on system error only):**
108
- > Load `{AGENTS_PATH}/devops-engineer.md`
109
- > EMBODY [devops-engineer] — Requires logged system error justification.
65
+ > Task(subagent_type="general-purpose", prompt="You are a devops-engineer. Verify deployment health. Exit when health checks pass, core functionality is verified, and preview URL is accessible.", description="devops-engineer: Verify deployment health")
110
66
 
111
67
  **Exit Criteria:**
112
68
 
@@ -120,6 +76,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
120
76
 
121
77
  Present deployment result with:
122
78
 
123
- 1. **Success** — Preview ready for testing
124
- 2. 🚀 **Promote** → `/deploy:production`
125
- 3. **Rollback** → `/deploy:rollback`
79
+ 1. **Success** — Preview ready for testing
80
+ 2. **Promote** → `/deploy:production`
81
+ 3. **Rollback** → `/deploy:rollback`