@ngxtm/devkit 3.18.0 → 3.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/merged-commands/application-performance-performance-optimization.md +13 -13
- package/merged-commands/ask/fast.md +14 -57
- package/merged-commands/ask/hard.md +22 -79
- package/merged-commands/auto.md +6 -33
- package/merged-commands/backend-development-feature-development.md +12 -12
- package/merged-commands/bootstrap/auto/fast.md +15 -15
- package/merged-commands/bootstrap/auto/parallel.md +12 -12
- package/merged-commands/bootstrap/auto.md +14 -14
- package/merged-commands/bootstrap.md +15 -15
- package/merged-commands/brainstorm/fast.md +19 -72
- package/merged-commands/brainstorm/hard.md +23 -84
- package/merged-commands/c4-architecture-c4-architecture.md +5 -5
- package/merged-commands/code/auto.md +16 -16
- package/merged-commands/code/fast.md +19 -72
- package/merged-commands/code/hard.md +38 -122
- package/merged-commands/code/no-test.md +12 -12
- package/merged-commands/code/parallel.md +9 -9
- package/merged-commands/code.md +14 -14
- package/merged-commands/comprehensive-review-full-review.md +8 -8
- package/merged-commands/context-degradation.md +2 -2
- package/merged-commands/context-engineering.md +4 -4
- package/merged-commands/context-optimization.md +3 -3
- package/merged-commands/cook/auto/fast.md +3 -3
- package/merged-commands/cook/auto/parallel.md +9 -9
- package/merged-commands/cook/auto.md +1 -1
- package/merged-commands/cook/fast.md +38 -47
- package/merged-commands/cook/hard.md +46 -41
- package/merged-commands/cook.md +13 -13
- package/merged-commands/daily-news-report.md +15 -15
- package/merged-commands/data-engineering-data-driven-feature.md +16 -16
- package/merged-commands/debug/fast.md +13 -29
- package/merged-commands/debug/hard.md +47 -49
- package/merged-commands/debug.md +1 -1
- package/merged-commands/debugging-toolkit-smart-debug.md +1 -1
- package/merged-commands/deploy/check.md +22 -71
- package/merged-commands/deploy/preview.md +18 -62
- package/merged-commands/deploy/production.md +22 -71
- package/merged-commands/deploy/rollback.md +22 -71
- package/merged-commands/deploy.md +0 -11
- package/merged-commands/design/3d.md +3 -3
- package/merged-commands/design/describe.md +1 -1
- package/merged-commands/design/fast.md +2 -2
- package/merged-commands/design/good.md +3 -3
- package/merged-commands/design/hard.md +15 -85
- package/merged-commands/design/screenshot.md +1 -1
- package/merged-commands/design/video.md +1 -1
- package/merged-commands/design.md +0 -11
- package/merged-commands/doc-coauthoring.md +5 -5
- package/merged-commands/docker-expert.md +1 -1
- package/merged-commands/docs/audit.md +26 -77
- package/merged-commands/docs/business.md +26 -77
- package/merged-commands/docs/core.md +24 -68
- package/merged-commands/docs/init.md +8 -8
- package/merged-commands/docs/update.md +13 -13
- package/merged-commands/docs.md +0 -12
- package/merged-commands/error-debugging-multi-agent-review.md +1 -1
- package/merged-commands/error-diagnostics-smart-debug.md +1 -1
- package/merged-commands/finishing-a-development-branch.md +1 -1
- package/merged-commands/fix/ci.md +2 -2
- package/merged-commands/fix/fast.md +2 -2
- package/merged-commands/fix/hard.md +6 -6
- package/merged-commands/fix/logs.md +5 -5
- package/merged-commands/fix/parallel.md +9 -9
- package/merged-commands/fix/test.md +6 -6
- package/merged-commands/fix/ui.md +8 -8
- package/merged-commands/fixing.md +3 -3
- package/merged-commands/framework-migration-legacy-modernize.md +13 -13
- package/merged-commands/full-stack-orchestration-full-stack-feature.md +12 -12
- package/merged-commands/git/cm.md +1 -1
- package/merged-commands/git/cp.md +1 -1
- package/merged-commands/git/merge.md +1 -1
- package/merged-commands/git/pr.md +1 -1
- package/merged-commands/git-pr-workflows-git-workflow.md +10 -10
- package/merged-commands/google-adk-python.md +1 -1
- package/merged-commands/hr-pro.md +1 -1
- package/merged-commands/incident-response-incident-response.md +13 -13
- package/merged-commands/integrate/polar.md +3 -3
- package/merged-commands/integrate/sepay.md +3 -3
- package/merged-commands/journal.md +1 -1
- package/merged-commands/learn.md +51 -4
- package/merged-commands/linear-claude-skill.md +2 -2
- package/merged-commands/loki-mode.md +14 -14
- package/merged-commands/machine-learning-ops-ml-pipeline.md +7 -7
- package/merged-commands/mcp-management.md +8 -8
- package/merged-commands/multi-agent-patterns.md +14 -14
- package/merged-commands/multi-platform-apps-multi-platform.md +10 -10
- package/merged-commands/nestjs-expert.md +1 -1
- package/merged-commands/performance-testing-review-multi-agent-review.md +1 -1
- package/merged-commands/plan/archive.md +1 -1
- package/merged-commands/plan/ci.md +1 -1
- package/merged-commands/plan/fast.md +2 -2
- package/merged-commands/plan/hard.md +4 -4
- package/merged-commands/plan/parallel.md +5 -5
- package/merged-commands/plan/two.md +6 -6
- package/merged-commands/requesting-code-review.md +6 -6
- package/merged-commands/review/codebase/parallel.md +5 -5
- package/merged-commands/review/codebase.md +5 -5
- package/merged-commands/review/fast.md +13 -29
- package/merged-commands/review/hard.md +48 -49
- package/merged-commands/review.md +0 -11
- package/merged-commands/security-scanning-security-hardening.md +13 -13
- package/merged-commands/skill/add.md +6 -6
- package/merged-commands/skill/create.md +6 -6
- package/merged-commands/skill/fix-logs.md +6 -6
- package/merged-commands/skill/optimize/auto.md +1 -1
- package/merged-commands/skill/optimize.md +1 -1
- package/merged-commands/skill/plan.md +1 -1
- package/merged-commands/skill/update.md +6 -6
- package/merged-commands/subagent-driven-development.md +53 -53
- package/merged-commands/tdd-workflows-tdd-cycle.md +12 -12
- package/merged-commands/tdd-workflows-tdd-red.md +1 -1
- package/merged-commands/tdd-workflows-tdd-refactor.md +1 -1
- package/merged-commands/test/fast.md +22 -33
- package/merged-commands/test/hard.md +59 -56
- package/merged-commands/test/ui.md +1 -1
- package/merged-commands/test.md +1 -1
- package/merged-commands/typescript-expert.md +1 -1
- package/merged-commands/use-mcp.md +5 -5
- package/merged-commands/writing-plans.md +3 -3
- package/merged-commands/writing-skills.md +8 -8
- package/package.json +1 -1
- package/rules-index.json +1 -1
- package/skills/application-performance-performance-optimization/SKILL.md +13 -13
- package/skills/azure-ai-agents-python/references/tools.md +1 -1
- package/skills/backend-development-feature-development/SKILL.md +12 -12
- package/skills/best-practices/references/anti-patterns.md +2 -2
- package/skills/best-practices/references/best-practices-guide.md +14 -14
- package/skills/c4-architecture-c4-architecture/SKILL.md +5 -5
- package/skills/comprehensive-review-full-review/SKILL.md +8 -8
- package/skills/context-degradation/SKILL.md +2 -2
- package/skills/context-engineering/SKILL.md +4 -4
- package/skills/context-engineering/references/context-degradation.md +1 -1
- package/skills/context-engineering/references/context-optimization.md +1 -1
- package/skills/context-engineering/references/multi-agent-patterns.md +1 -1
- package/skills/context-engineering/references/runtime-awareness.md +1 -1
- package/skills/context-optimization/SKILL.md +3 -3
- package/skills/daily-news-report/SKILL.md +15 -15
- package/skills/data-engineering-data-driven-feature/SKILL.md +16 -16
- package/skills/debugging-toolkit-smart-debug/SKILL.md +1 -1
- package/skills/doc-coauthoring/SKILL.md +5 -5
- package/skills/docker-expert/SKILL.md +1 -1
- package/skills/error-debugging-multi-agent-review/SKILL.md +1 -1
- package/skills/error-diagnostics-smart-debug/SKILL.md +1 -1
- package/skills/finishing-a-development-branch/SKILL.md +1 -1
- package/skills/fixing/SKILL.md +3 -3
- package/skills/fixing/references/parallel-exploration.md +4 -4
- package/skills/fixing/references/skill-activation-matrix.md +3 -3
- package/skills/fixing/references/workflow-deep.md +11 -11
- package/skills/fixing/references/workflow-quick.md +4 -4
- package/skills/fixing/references/workflow-standard.md +12 -12
- package/skills/framework-migration-legacy-modernize/SKILL.md +13 -13
- package/skills/full-stack-orchestration-full-stack-feature/SKILL.md +12 -12
- package/skills/git-pr-workflows-git-workflow/SKILL.md +10 -10
- package/skills/google-adk-python/SKILL.md +1 -1
- package/skills/hr-pro/SKILL.md +1 -1
- package/skills/incident-response-incident-response/SKILL.md +13 -13
- package/skills/incident-response-smart-fix/resources/implementation-playbook.md +17 -17
- package/skills/learn/SKILL.md +51 -4
- package/skills/linear-claude-skill/SKILL.md +2 -2
- package/skills/loki-mode/ACKNOWLEDGEMENTS.md +4 -4
- package/skills/loki-mode/CHANGELOG.md +9 -9
- package/skills/loki-mode/CONTEXT-EXPORT.md +1 -1
- package/skills/loki-mode/README.md +2 -2
- package/skills/loki-mode/SKILL.md +14 -14
- package/skills/loki-mode/autonomy/run.sh +1 -1
- package/skills/loki-mode/integrations/vibe-kanban.md +1 -1
- package/skills/loki-mode/references/core-workflow.md +4 -4
- package/skills/loki-mode/references/production-patterns.md +6 -6
- package/skills/loki-mode/references/quality-control.md +2 -2
- package/skills/loki-mode/references/sdlc-phases.md +3 -3
- package/skills/machine-learning-ops-ml-pipeline/SKILL.md +7 -7
- package/skills/mcp-builder/reference/evaluation.md +3 -3
- package/skills/mcp-management/README.md +6 -6
- package/skills/mcp-management/SKILL.md +8 -8
- package/skills/mcp-management/references/gemini-cli-integration.md +1 -1
- package/skills/multi-agent-patterns/SKILL.md +14 -14
- package/skills/multi-platform-apps-multi-platform/SKILL.md +10 -10
- package/skills/nestjs-expert/SKILL.md +1 -1
- package/skills/performance-testing-review-multi-agent-review/SKILL.md +1 -1
- package/skills/planning-with-files/reference.md +2 -2
- package/skills/requesting-code-review/SKILL.md +6 -6
- package/skills/security-scanning-security-hardening/SKILL.md +13 -13
- package/skills/subagent-driven-development/SKILL.md +53 -53
- package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +1 -1
- package/skills/subagent-driven-development/implementer-prompt.md +3 -3
- package/skills/subagent-driven-development/spec-reviewer-prompt.md +1 -1
- package/skills/tdd-workflows-tdd-cycle/SKILL.md +12 -12
- package/skills/tdd-workflows-tdd-green/resources/implementation-playbook.md +1 -1
- package/skills/tdd-workflows-tdd-red/SKILL.md +1 -1
- package/skills/tdd-workflows-tdd-refactor/SKILL.md +1 -1
- package/skills/typescript-expert/SKILL.md +1 -1
- package/skills/writing-plans/SKILL.md +3 -3
- package/skills/writing-skills/SKILL.md +8 -8
- package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +1 -1
- package/skills/writing-skills/references/cso/README.md +3 -3
- package/skills/writing-skills/testing-skills-with-subagents.md +1 -1
|
@@ -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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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:
|
|
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
|
-
##
|
|
16
|
+
## Execution
|
|
17
17
|
|
|
18
|
-
|
|
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
|
-
##
|
|
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
|
-
| **
|
|
26
|
+
| **Role** | `scouter` |
|
|
56
27
|
| **Goal** | Find relevant code and documentation |
|
|
57
28
|
|
|
58
|
-
###
|
|
59
|
-
|
|
60
|
-
**TIER 1 (MANDATORY when tool exists):**
|
|
61
|
-
|
|
62
|
-
> Invoke runSubagent for `scouter`. Context: ISOLATED.
|
|
29
|
+
### Delegation
|
|
63
30
|
|
|
64
|
-
|
|
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
|
-
##
|
|
41
|
+
## Phase 2: ANSWER FORMULATION
|
|
78
42
|
|
|
79
43
|
| Attribute | Value |
|
|
80
44
|
| --------- | -------------------------------- |
|
|
81
|
-
| **
|
|
45
|
+
| **Role** | `researcher` |
|
|
82
46
|
| **Goal** | Formulate clear, accurate answer |
|
|
83
47
|
|
|
84
|
-
###
|
|
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
|
-
>
|
|
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.
|
|
118
|
-
2.
|
|
119
|
-
3.
|
|
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:
|
|
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
|
-
##
|
|
16
|
+
## Execution
|
|
17
17
|
|
|
18
|
-
|
|
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
|
-
##
|
|
22
|
+
## Phase 1: QUESTION ANALYSIS
|
|
52
23
|
|
|
53
24
|
| Attribute | Value |
|
|
54
25
|
| --------- | ------------------------------------------- |
|
|
55
|
-
| **
|
|
26
|
+
| **Role** | `brainstormer` |
|
|
56
27
|
| **Goal** | Decompose question into research components |
|
|
57
28
|
|
|
58
|
-
###
|
|
59
|
-
|
|
60
|
-
**TIER 1 (MANDATORY when tool exists):**
|
|
29
|
+
### Delegation
|
|
61
30
|
|
|
62
|
-
>
|
|
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
|
-
##
|
|
41
|
+
## Phase 2: CODEBASE ANALYSIS
|
|
78
42
|
|
|
79
43
|
| Attribute | Value |
|
|
80
44
|
| --------- | ----------------------------- |
|
|
81
|
-
| **
|
|
45
|
+
| **Role** | `scouter` |
|
|
82
46
|
| **Goal** | Map relevant codebase context |
|
|
83
47
|
|
|
84
|
-
###
|
|
85
|
-
|
|
86
|
-
**TIER 1 (MANDATORY when tool exists):**
|
|
48
|
+
### Delegation
|
|
87
49
|
|
|
88
|
-
>
|
|
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
|
-
##
|
|
60
|
+
## Phase 3: EXTERNAL RESEARCH
|
|
104
61
|
|
|
105
62
|
| Attribute | Value |
|
|
106
63
|
| --------- | -------------------------------------------- |
|
|
107
|
-
| **
|
|
64
|
+
| **Role** | `researcher` |
|
|
108
65
|
| **Goal** | Research external sources and best practices |
|
|
109
66
|
|
|
110
|
-
###
|
|
111
|
-
|
|
112
|
-
**TIER 1 (MANDATORY when tool exists):**
|
|
67
|
+
### Delegation
|
|
113
68
|
|
|
114
|
-
>
|
|
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
|
-
##
|
|
79
|
+
## Phase 4: SYNTHESIS
|
|
130
80
|
|
|
131
81
|
| Attribute | Value |
|
|
132
82
|
| --------- | ------------------------------- |
|
|
133
|
-
| **
|
|
83
|
+
| **Role** | `researcher` |
|
|
134
84
|
| **Goal** | Synthesize comprehensive answer |
|
|
135
85
|
|
|
136
|
-
###
|
|
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
|
-
>
|
|
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.
|
|
160
|
-
2.
|
|
161
|
-
3.
|
|
102
|
+
1. **Answered** — Question resolved
|
|
103
|
+
2. **Plan** → `/plan:hard` if implementation needed
|
|
104
|
+
3. **Implement** → `/code:hard` for complex implementation
|
package/merged-commands/auto.md
CHANGED
|
@@ -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
|
-
| **
|
|
31
|
+
| **Role** | `tech-lead` |
|
|
49
32
|
| **Goal** | Classify task and select workflow |
|
|
50
33
|
|
|
51
|
-
###
|
|
34
|
+
### Delegation
|
|
52
35
|
|
|
53
|
-
|
|
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
|
-
| **
|
|
64
|
+
| **Role** | `tech-lead` |
|
|
87
65
|
| **Goal** | Synthesize results and present summary |
|
|
88
66
|
|
|
89
|
-
###
|
|
90
|
-
|
|
91
|
-
**IF platform supports subagents:**
|
|
92
|
-
> Delegate to `tech-lead` subagent. Do NOT read agent file directly.
|
|
67
|
+
### Delegation
|
|
93
68
|
|
|
94
|
-
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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="
|
|
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
|