@ngxtm/devkit 3.19.0 → 3.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (194) 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/requesting-code-review.md +6 -6
  95. package/merged-commands/review/codebase/parallel.md +5 -5
  96. package/merged-commands/review/codebase.md +5 -5
  97. package/merged-commands/review/fast.md +13 -29
  98. package/merged-commands/review/hard.md +48 -49
  99. package/merged-commands/review.md +0 -11
  100. package/merged-commands/security-scanning-security-hardening.md +13 -13
  101. package/merged-commands/skill/add.md +6 -6
  102. package/merged-commands/skill/create.md +6 -6
  103. package/merged-commands/skill/fix-logs.md +6 -6
  104. package/merged-commands/skill/optimize/auto.md +1 -1
  105. package/merged-commands/skill/optimize.md +1 -1
  106. package/merged-commands/skill/plan.md +1 -1
  107. package/merged-commands/skill/update.md +6 -6
  108. package/merged-commands/subagent-driven-development.md +53 -53
  109. package/merged-commands/tdd-workflows-tdd-cycle.md +12 -12
  110. package/merged-commands/tdd-workflows-tdd-red.md +1 -1
  111. package/merged-commands/tdd-workflows-tdd-refactor.md +1 -1
  112. package/merged-commands/test/fast.md +22 -33
  113. package/merged-commands/test/hard.md +59 -56
  114. package/merged-commands/test/ui.md +1 -1
  115. package/merged-commands/test.md +1 -1
  116. package/merged-commands/typescript-expert.md +1 -1
  117. package/merged-commands/use-mcp.md +5 -5
  118. package/merged-commands/writing-plans.md +3 -3
  119. package/merged-commands/writing-skills.md +8 -8
  120. package/package.json +1 -1
  121. package/rules-index.json +1 -1
  122. package/skills/application-performance-performance-optimization/SKILL.md +13 -13
  123. package/skills/azure-ai-agents-python/references/tools.md +1 -1
  124. package/skills/backend-development-feature-development/SKILL.md +12 -12
  125. package/skills/best-practices/references/anti-patterns.md +2 -2
  126. package/skills/best-practices/references/best-practices-guide.md +14 -14
  127. package/skills/c4-architecture-c4-architecture/SKILL.md +5 -5
  128. package/skills/comprehensive-review-full-review/SKILL.md +8 -8
  129. package/skills/context-degradation/SKILL.md +2 -2
  130. package/skills/context-engineering/SKILL.md +4 -4
  131. package/skills/context-engineering/references/context-degradation.md +1 -1
  132. package/skills/context-engineering/references/context-optimization.md +1 -1
  133. package/skills/context-engineering/references/multi-agent-patterns.md +1 -1
  134. package/skills/context-engineering/references/runtime-awareness.md +1 -1
  135. package/skills/context-optimization/SKILL.md +3 -3
  136. package/skills/daily-news-report/SKILL.md +15 -15
  137. package/skills/data-engineering-data-driven-feature/SKILL.md +16 -16
  138. package/skills/debugging-toolkit-smart-debug/SKILL.md +1 -1
  139. package/skills/doc-coauthoring/SKILL.md +5 -5
  140. package/skills/docker-expert/SKILL.md +1 -1
  141. package/skills/error-debugging-multi-agent-review/SKILL.md +1 -1
  142. package/skills/error-diagnostics-smart-debug/SKILL.md +1 -1
  143. package/skills/finishing-a-development-branch/SKILL.md +1 -1
  144. package/skills/fixing/SKILL.md +3 -3
  145. package/skills/fixing/references/parallel-exploration.md +4 -4
  146. package/skills/fixing/references/skill-activation-matrix.md +3 -3
  147. package/skills/fixing/references/workflow-deep.md +11 -11
  148. package/skills/fixing/references/workflow-quick.md +4 -4
  149. package/skills/fixing/references/workflow-standard.md +12 -12
  150. package/skills/framework-migration-legacy-modernize/SKILL.md +13 -13
  151. package/skills/full-stack-orchestration-full-stack-feature/SKILL.md +12 -12
  152. package/skills/git-pr-workflows-git-workflow/SKILL.md +10 -10
  153. package/skills/google-adk-python/SKILL.md +1 -1
  154. package/skills/hr-pro/SKILL.md +1 -1
  155. package/skills/incident-response-incident-response/SKILL.md +13 -13
  156. package/skills/incident-response-smart-fix/resources/implementation-playbook.md +17 -17
  157. package/skills/linear-claude-skill/SKILL.md +2 -2
  158. package/skills/loki-mode/ACKNOWLEDGEMENTS.md +4 -4
  159. package/skills/loki-mode/CHANGELOG.md +9 -9
  160. package/skills/loki-mode/CONTEXT-EXPORT.md +1 -1
  161. package/skills/loki-mode/README.md +2 -2
  162. package/skills/loki-mode/SKILL.md +14 -14
  163. package/skills/loki-mode/autonomy/run.sh +1 -1
  164. package/skills/loki-mode/integrations/vibe-kanban.md +1 -1
  165. package/skills/loki-mode/references/core-workflow.md +4 -4
  166. package/skills/loki-mode/references/production-patterns.md +6 -6
  167. package/skills/loki-mode/references/quality-control.md +2 -2
  168. package/skills/loki-mode/references/sdlc-phases.md +3 -3
  169. package/skills/machine-learning-ops-ml-pipeline/SKILL.md +7 -7
  170. package/skills/mcp-builder/reference/evaluation.md +3 -3
  171. package/skills/mcp-management/README.md +6 -6
  172. package/skills/mcp-management/SKILL.md +8 -8
  173. package/skills/mcp-management/references/gemini-cli-integration.md +1 -1
  174. package/skills/multi-agent-patterns/SKILL.md +14 -14
  175. package/skills/multi-platform-apps-multi-platform/SKILL.md +10 -10
  176. package/skills/nestjs-expert/SKILL.md +1 -1
  177. package/skills/performance-testing-review-multi-agent-review/SKILL.md +1 -1
  178. package/skills/planning-with-files/reference.md +2 -2
  179. package/skills/requesting-code-review/SKILL.md +6 -6
  180. package/skills/security-scanning-security-hardening/SKILL.md +13 -13
  181. package/skills/subagent-driven-development/SKILL.md +53 -53
  182. package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +1 -1
  183. package/skills/subagent-driven-development/implementer-prompt.md +3 -3
  184. package/skills/subagent-driven-development/spec-reviewer-prompt.md +1 -1
  185. package/skills/tdd-workflows-tdd-cycle/SKILL.md +12 -12
  186. package/skills/tdd-workflows-tdd-green/resources/implementation-playbook.md +1 -1
  187. package/skills/tdd-workflows-tdd-red/SKILL.md +1 -1
  188. package/skills/tdd-workflows-tdd-refactor/SKILL.md +1 -1
  189. package/skills/typescript-expert/SKILL.md +1 -1
  190. package/skills/writing-plans/SKILL.md +3 -3
  191. package/skills/writing-skills/SKILL.md +8 -8
  192. package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +1 -1
  193. package/skills/writing-skills/references/cso/README.md +3 -3
  194. package/skills/writing-skills/testing-skills-with-subagents.md +1 -1
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: 🚀 Deploy Production — Production release with safety gates
2
+ description: Deploy Production — Production release with safety gates
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: FULL READINESS CHECK
19
+ ## Phase 1: FULL READINESS CHECK
49
20
 
50
21
  | Attribute | Value |
51
22
  |-----------|-------|
52
- | **Agent** | `devops-engineer` |
23
+ | **Role** | `devops-engineer` |
53
24
  | **Goal** | Complete pre-production verification |
54
25
 
55
- ### ⚡ TIERED EXECUTION
56
-
57
- **TIER 1 (MANDATORY when tool exists):**
58
- > Invoke runSubagent for `devops-engineer`. Context: ISOLATED.
26
+ ### Delegation
59
27
 
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. Complete pre-production verification. Exit when all tests pass, security scan is clean, rollback plan is documented, and monitoring is ready.", description="devops-engineer: Complete pre-production verification")
63
29
 
64
30
  **Exit Criteria:**
65
31
 
@@ -70,21 +36,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
70
36
 
71
37
  ---
72
38
 
73
- ## 🎭 Phase 2: SECURITY GATE
39
+ ## Phase 2: SECURITY GATE
74
40
 
75
41
  | Attribute | Value |
76
42
  |-----------|-------|
77
- | **Agent** | `security-engineer` |
43
+ | **Role** | `security-engineer` |
78
44
  | **Goal** | Final security verification |
79
45
 
80
- ### ⚡ TIERED EXECUTION
46
+ ### Delegation
81
47
 
82
- **TIER 1 (MANDATORY when tool exists):**
83
- > Invoke runSubagent for `security-engineer`. Context: ISOLATED.
84
-
85
- **TIER 2 (FALLBACK on system error only):**
86
- > Load `{AGENTS_PATH}/security-engineer.md`
87
- > EMBODY [security-engineer] — Requires logged system error justification.
48
+ > Task(subagent_type="general-purpose", prompt="You are a security-engineer. Perform final security verification before production deployment. Exit when no critical vulnerabilities exist, secrets are secured, and deployment is approved for production.", description="security-engineer: Final security verification")
88
49
 
89
50
  **Exit Criteria:**
90
51
 
@@ -94,21 +55,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
94
55
 
95
56
  ---
96
57
 
97
- ## 🎭 Phase 3: PRODUCTION DEPLOY
58
+ ## Phase 3: PRODUCTION DEPLOY
98
59
 
99
60
  | Attribute | Value |
100
61
  |-----------|-------|
101
- | **Agent** | `devops-engineer` |
62
+ | **Role** | `devops-engineer` |
102
63
  | **Goal** | Execute production deployment |
103
64
 
104
- ### ⚡ TIERED EXECUTION
105
-
106
- **TIER 1 (MANDATORY when tool exists):**
107
- > Invoke runSubagent for `devops-engineer`. Context: ISOLATED.
65
+ ### Delegation
108
66
 
109
- **TIER 2 (FALLBACK on system error only):**
110
- > Load `{AGENTS_PATH}/devops-engineer.md`
111
- > EMBODY [devops-engineer] — Requires logged system error justification.
67
+ > Task(subagent_type="general-purpose", prompt="You are a devops-engineer. Execute production deployment. Exit when deployment is successful and zero-downtime is achieved (if applicable).", description="devops-engineer: Execute production deployment")
112
68
 
113
69
  **Exit Criteria:**
114
70
 
@@ -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: POST-DEPLOY VERIFICATION
76
+ ## Phase 4: POST-DEPLOY VERIFICATION
121
77
 
122
78
  | Attribute | Value |
123
79
  |-----------|-------|
124
- | **Agent** | `devops-engineer` |
80
+ | **Role** | `devops-engineer` |
125
81
  | **Goal** | Production health verification |
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 production health after deployment. Exit when health checks pass, core paths are verified, and monitoring is normal.", description="devops-engineer: Production health verification")
135
86
 
136
87
  **Exit Criteria:**
137
88
 
@@ -155,6 +106,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
155
106
 
156
107
  Present deployment result with:
157
108
 
158
- 1. **Success** — Production deployed
159
- 2. **Rollback** → `/deploy:rollback` if issues
160
- 3. 📊 **Monitor** — Watch dashboards
109
+ 1. **Success** — Production deployed
110
+ 2. **Rollback** → `/deploy:rollback` if issues
111
+ 3. **Monitor** — Watch dashboards
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Deploy Rollback — Revert to previous deployment
2
+ description: Deploy Rollback — Revert to previous 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: ASSESS SITUATION
19
+ ## Phase 1: ASSESS SITUATION
49
20
 
50
21
  | Attribute | Value |
51
22
  |-----------|-------|
52
- | **Agent** | `devops-engineer` |
23
+ | **Role** | `devops-engineer` |
53
24
  | **Goal** | Identify rollback target |
54
25
 
55
- ### ⚡ TIERED EXECUTION
56
-
57
- **TIER 1 (MANDATORY when tool exists):**
58
- > Invoke runSubagent for `devops-engineer`. Context: ISOLATED.
26
+ ### Delegation
59
27
 
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. Identify the rollback target. Exit when current state is documented, rollback target is identified, and impact is assessed.", description="devops-engineer: Identify rollback target")
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: EXECUTE ROLLBACK
38
+ ## Phase 2: EXECUTE ROLLBACK
73
39
 
74
40
  | Attribute | Value |
75
41
  |-----------|-------|
76
- | **Agent** | `devops-engineer` |
42
+ | **Role** | `devops-engineer` |
77
43
  | **Goal** | Execute rollback procedure |
78
44
 
79
- ### ⚡ TIERED EXECUTION
45
+ ### Delegation
80
46
 
81
- **TIER 1 (MANDATORY when tool exists):**
82
- > Invoke runSubagent for `devops-engineer`. Context: ISOLATED.
83
-
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. Execute the rollback procedure. Exit when rollback is complete and previous version is deployed.", description="devops-engineer: Execute rollback procedure")
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 rollback success |
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 rollback success. Exit when health checks pass, previous functionality is restored, and issue is resolved.", description="devops-engineer: Verify rollback success")
110
66
 
111
67
  **Exit Criteria:**
112
68
 
@@ -116,21 +72,16 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
116
72
 
117
73
  ---
118
74
 
119
- ## 🎭 Phase 4: ROOT CAUSE ANALYSIS
75
+ ## Phase 4: ROOT CAUSE ANALYSIS
120
76
 
121
77
  | Attribute | Value |
122
78
  |-----------|-------|
123
- | **Agent** | `debugger` |
79
+ | **Role** | `debugger` |
124
80
  | **Goal** | Document what went wrong |
125
81
 
126
- ### ⚡ TIERED EXECUTION
127
-
128
- **TIER 1 (MANDATORY when tool exists):**
129
- > Invoke runSubagent for `debugger`. Context: ISOLATED.
82
+ ### Delegation
130
83
 
131
- **TIER 2 (FALLBACK on system error only):**
132
- > Load `{AGENTS_PATH}/debugger.md`
133
- > EMBODY [debugger] — Requires logged system error justification.
84
+ > Task(subagent_type="general-purpose", prompt="You are a debugger. Document what went wrong with the deployment. Exit when failure is documented, root cause is identified, and prevention plan is noted.", description="debugger: Document what went wrong")
134
85
 
135
86
  **Exit Criteria:**
136
87
 
@@ -144,6 +95,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
144
95
 
145
96
  Present rollback result with:
146
97
 
147
- 1. **Rolled Back** — System stable
148
- 2. 🐛 **Debug** → `/debug:hard` for root cause
149
- 3. 📝 **Document** — Post-mortem documentation
98
+ 1. **Rolled Back** — System stable
99
+ 2. **Debug** → `/debug:hard` for root cause
100
+ 3. **Document** — Post-mortem documentation
@@ -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
  ```
@@ -3,7 +3,7 @@ description: Create immersive interactive 3D designs with Three.js
3
3
  argument-hint: [tasks]
4
4
  ---
5
5
 
6
- Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
+ Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Task Agents Team and Development Rules:
7
7
  <tasks>$ARGUMENTS</tasks>
8
8
 
9
9
  ## Required Skills (Priority Order)
@@ -20,12 +20,12 @@ Think hard to plan & start working on these tasks follow the Orchestration Proto
20
20
  python3 .claude/skills/ui-ux-pro-max/scripts/search.py "immersive 3d" --domain style
21
21
  python3 .claude/skills/ui-ux-pro-max/scripts/search.py "animation" --domain ux
22
22
  ```
23
- 1. Use `ui-ux-designer` subagent and `researcher` subagent to create a comprehensive 3D design plan following the progressive disclosure structure:
23
+ 1. Use a Task agent for UI/UX design and a Task agent for research to create a comprehensive 3D design plan following the progressive disclosure structure:
24
24
  - Create a directory using naming pattern from `## Naming` section.
25
25
  - Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
26
26
  - For each phase, add `phase-XX-phase-name.md` files containing sections (Context links, Overview with date/priority/statuses, Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps).
27
27
  - Keep every research markdown report concise (≤150 lines) while covering all requested topics and citations.
28
- 2. Then use `ui-ux-designer` subagent to implement the plan step by step.
28
+ 2. Then use a Task agent for UI/UX design: Task(subagent_type="general-purpose", prompt="You are a ui-ux-designer. Implement the plan step by step.", description="Implement 3D design") to implement the plan step by step.
29
29
  3. Create immersive 3D experiences using Three.js with particle effects, custom shaders, and interactive elements.
30
30
  4. Leverage all available Gemini skills (ai-multimodal, ai-multimodal) for asset generation and validation.
31
31
  5. Report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
@@ -16,7 +16,7 @@ Think hard to describe the design based on this screenshot/video:
16
16
  1. Use `ai-multimodal` skills to describe super details of the screenshot/video so the developer can implement it easily.
17
17
  - Be specific about design style, every element, elements' positions, every interaction, every animation, every transition, every color, every border, every icon, every font style, font size, font weight, every spacing, every padding, every margin, every size, every shape, every texture, every material, every light, every shadow, every reflection, every refraction, every blur, every glow, every image, background transparency, etc.
18
18
  - **IMPORTANT:** Try to predict the font name (Google Fonts) and font size in the given screenshot, don't just use Inter or Poppins.
19
- 2. Use `ui-ux-designer` subagent to create a design implementation plan following the progressive disclosure structure so the result matches the screenshot/video:
19
+ 2. Use a Task agent for UI/UX design: Task(subagent_type="general-purpose", prompt="You are a ui-ux-designer. Create a design implementation plan following the progressive disclosure structure so the result matches the screenshot/video.", description="Create design plan") to create a design implementation plan following the progressive disclosure structure so the result matches the screenshot/video:
20
20
  - Create a directory using naming pattern from `## Naming` section.
21
21
  - Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
22
22
  - For each phase, add `phase-XX-phase-name.md` files containing sections (Context links, Overview with date/priority/statuses, Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps).
@@ -3,7 +3,7 @@ description: Create a quick design
3
3
  argument-hint: [tasks]
4
4
  ---
5
5
 
6
- Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
+ Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Task Agents Team and Development Rules:
7
7
  <tasks>$ARGUMENTS</tasks>
8
8
 
9
9
  ## Required Skills (Priority Order)
@@ -20,7 +20,7 @@ Think hard to plan & start working on these tasks follow the Orchestration Proto
20
20
  python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<mood>" --domain typography
21
21
  python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<industry>" --domain color
22
22
  ```
23
- 2. Use `ui-ux-designer` subagent to start the design process.
23
+ 2. Use a Task agent for UI/UX design: Task(subagent_type="general-purpose", prompt="You are a ui-ux-designer. Start the design process.", description="Design") to start the design process.
24
24
  3. If user doesn't specify, create the design in pure HTML/CSS/JS.
25
25
  4. Report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
26
26
  5. If user approves the changes, update the `./docs/design-guidelines.md` docs if needed.
@@ -3,7 +3,7 @@ description: Create an immersive design
3
3
  argument-hint: [tasks]
4
4
  ---
5
5
 
6
- Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
+ Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Task Agents Team and Development Rules:
7
7
  <tasks>$ARGUMENTS</tasks>
8
8
 
9
9
  ## Required Skills (Priority Order)
@@ -20,8 +20,8 @@ Think hard to plan & start working on these tasks follow the Orchestration Proto
20
20
  python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<mood>" --domain typography
21
21
  python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<industry>" --domain color
22
22
  ```
23
- 2. Use `researcher` subagent to research about design style, trends, fonts, colors, border, spacing, elements' positions, etc.
24
- 3. Use `ui-ux-designer` subagent to implement the design step by step based on the research.
23
+ 2. Use a Task agent for research: Task(subagent_type="general-purpose", prompt="You are a researcher. Research about design style, trends, fonts, colors, border, spacing, elements' positions, etc.", description="Research design") to research about design style, trends, fonts, colors, border, spacing, elements' positions, etc.
24
+ 3. Use a Task agent for UI/UX design: Task(subagent_type="general-purpose", prompt="You are a ui-ux-designer. Implement the design step by step based on the research.", description="Implement design") to implement the design step by step based on the research.
25
25
  4. If user doesn't specify, create the design in pure HTML/CSS/JS.
26
26
  5. Report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
27
27
  6. If user approves the changes, update the `./docs/design-guidelines.md` docs if needed.
@@ -13,35 +13,6 @@ 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
-
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
16
  ## ⚠️ CRITICAL: DELIVERABLE FILE RULES
46
17
 
47
18
  ```yaml
@@ -59,29 +30,16 @@ All files in `./reports/` → English only.
59
30
 
60
31
  ---
61
32
 
62
- ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
63
-
64
- 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).
65
-
66
- ---
67
-
68
33
  ## 🎭 Phase 1: REQUIREMENTS DISCOVERY
69
34
 
70
35
  | Attribute | Value |
71
36
  | --------- | --------------------------- |
72
- | **Agent** | `brainstormer` |
37
+ | **Role** | `brainstormer` |
73
38
  | **Goal** | Clarify design requirements |
74
39
 
75
- ### ⚡ TIERED EXECUTION
76
-
77
- **TIER 1 (MANDATORY when tool exists):**
78
-
79
- > Invoke runSubagent for `brainstormer`. Context: ISOLATED.
80
-
81
- **TIER 2 (FALLBACK on system error only):**
40
+ ### Delegation
82
41
 
83
- > Load `{AGENTS_PATH}/brainstormer.md`
84
- > EMBODY [brainstormer] — Requires logged system error justification.
42
+ > Task(subagent_type="general-purpose", prompt="You are a brainstormer. Clarify design requirements. [See exit criteria below]", description="brainstormer")
85
43
 
86
44
  **Exit Criteria:**
87
45
 
@@ -96,19 +54,12 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
96
54
 
97
55
  | Attribute | Value |
98
56
  | --------- | ------------------------------- |
99
- | **Agent** | `researcher` |
57
+ | **Role** | `researcher` |
100
58
  | **Goal** | Research design patterns and UX |
101
59
 
102
- ### ⚡ TIERED EXECUTION
60
+ ### Delegation
103
61
 
104
- **TIER 1 (MANDATORY when tool exists):**
105
-
106
- > Invoke runSubagent for `researcher`. Context: ISOLATED.
107
-
108
- **TIER 2 (FALLBACK on system error only):**
109
-
110
- > Load `{AGENTS_PATH}/researcher.md`
111
- > EMBODY [researcher] — Requires logged system error justification.
62
+ > Task(subagent_type="general-purpose", prompt="You are a researcher. Research design patterns and UX. [See exit criteria below]", description="researcher")
112
63
 
113
64
  **Exit Criteria:**
114
65
 
@@ -122,19 +73,12 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
122
73
 
123
74
  | Attribute | Value |
124
75
  | --------- | -------------------------- |
125
- | **Agent** | `scouter` |
76
+ | **Role** | `scouter` |
126
77
  | **Goal** | Map existing design system |
127
78
 
128
- ### ⚡ TIERED EXECUTION
129
-
130
- **TIER 1 (MANDATORY when tool exists):**
79
+ ### Delegation
131
80
 
132
- > Invoke runSubagent for `scouter`. Context: ISOLATED.
133
-
134
- **TIER 2 (FALLBACK on system error only):**
135
-
136
- > Load `{AGENTS_PATH}/scouter.md`
137
- > EMBODY [scouter] — Requires logged system error justification.
81
+ > Task(subagent_type="general-purpose", prompt="You are a scouter. Map existing design system. [See exit criteria below]", description="scouter")
138
82
 
139
83
  **Exit Criteria:**
140
84
 
@@ -149,19 +93,12 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
149
93
 
150
94
  | Attribute | Value |
151
95
  | --------- | ---------------------- |
152
- | **Agent** | `designer` |
96
+ | **Role** | `designer` |
153
97
  | **Goal** | Full design with specs |
154
98
 
155
- ### ⚡ TIERED EXECUTION
156
-
157
- **TIER 1 (MANDATORY when tool exists):**
158
-
159
- > Invoke runSubagent for `designer`. Context: ISOLATED.
99
+ ### Delegation
160
100
 
161
- **TIER 2 (FALLBACK on system error only):**
162
-
163
- > Load `{AGENTS_PATH}/designer.md`
164
- > EMBODY [designer] — Requires logged system error justification.
101
+ > Task(subagent_type="general-purpose", prompt="You are a designer. Create full design with specs. [See exit criteria below]", description="designer")
165
102
 
166
103
  **Exit Criteria:**
167
104
 
@@ -177,19 +114,12 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
177
114
 
178
115
  | Attribute | Value |
179
116
  | --------- | --------------------- |
180
- | **Agent** | `reviewer` |
117
+ | **Role** | `reviewer` |
181
118
  | **Goal** | Review design quality |
182
119
 
183
- ### ⚡ TIERED EXECUTION
184
-
185
- **TIER 1 (MANDATORY when tool exists):**
186
-
187
- > Invoke runSubagent for `reviewer`. Context: ISOLATED.
188
-
189
- **TIER 2 (FALLBACK on system error only):**
120
+ ### Delegation
190
121
 
191
- > Load `{AGENTS_PATH}/reviewer.md`
192
- > EMBODY [reviewer] — Requires logged system error justification.
122
+ > Task(subagent_type="general-purpose", prompt="You are a reviewer. Review design quality. [See exit criteria below]", description="reviewer")
193
123
 
194
124
  **Exit Criteria:**
195
125
 
@@ -15,7 +15,7 @@ Think hard to plan & start designing follow exactly this screenshot:
15
15
  ## Workflow:
16
16
  1. Use `ai-multimodal` skills to describe super details of the screenshot (design style, trends, fonts, colors, border, spacing, elements' positions, size, shape, texture, material, light, shadow, reflection, refraction, blur, glow, image, background transparency, transition, etc.)
17
17
  - **IMPORTANT:** Try to predict the font name (Google Fonts) and font size in the given screenshot, don't just use Inter or Poppins.
18
- 2. Use `ui-ux-designer` subagent to create a design plan following the progressive disclosure structure so the final result matches the screenshot:
18
+ 2. Use a Task agent for UI/UX design: Task(subagent_type="general-purpose", prompt="You are a ui-ux-designer. Create a design plan following the progressive disclosure structure so the final result matches the screenshot.", description="Create design plan") to create a design plan following the progressive disclosure structure so the final result matches the screenshot:
19
19
  - Create a directory using naming pattern from `## Naming` section.
20
20
  - Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
21
21
  - For each phase, add `phase-XX-phase-name.md` files containing sections (Context links, Overview with date/priority/statuses, Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps).
@@ -15,7 +15,7 @@ Think hard to plan & start designing follow exactly this video:
15
15
  ## Workflow:
16
16
  1. Use `ai-multimodal` skills to describe super details of the video: be specific about describing every element, every interaction, every animation, every transition, every color, every font, every border, every spacing, every size, every shape, every texture, every material, every light, every shadow, every reflection, every refraction, every blur, every glow, every image, background transparency, etc.
17
17
  - **IMPORTANT:** Try to predict the font name (Google Fonts) and font size in the given video, don't just use Inter or Poppins.
18
- 2. Use `ui-ux-designer` subagent to create a design plan following the progressive disclosure structure so the final result matches the video:
18
+ 2. Use a Task agent for UI/UX design: Task(subagent_type="general-purpose", prompt="You are a ui-ux-designer. Create a design plan following the progressive disclosure structure so the final result matches the video.", description="Create design plan") to create a design plan following the progressive disclosure structure so the final result matches the video:
19
19
  - Create a directory using naming pattern from `## Naming` section.
20
20
  - Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
21
21
  - For each phase, add `phase-XX-phase-name.md` files containing sections (Context links, Overview with date/priority/statuses, Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps).
@@ -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
  ```
@@ -250,7 +250,7 @@ Explain that testing will now occur to see if the document actually works for re
250
250
 
251
251
  ### Testing Approach
252
252
 
253
- **If access to sub-agents is available (e.g., in Claude Code):**
253
+ **If access to Task agents is available (e.g., in Claude Code):**
254
254
 
255
255
  Perform the testing directly without user involvement.
256
256
 
@@ -260,11 +260,11 @@ Announce intention to predict what questions readers might ask when trying to di
260
260
 
261
261
  Generate 5-10 questions that readers would realistically ask.
262
262
 
263
- ### Step 2: Test with Sub-Agent
263
+ ### Step 2: Test with Task Agent
264
264
 
265
265
  Announce that these questions will be tested with a fresh Claude instance (no context from this conversation).
266
266
 
267
- For each question, invoke a sub-agent with just the document content and the question.
267
+ For each question, invoke a Task agent with just the document content and the question.
268
268
 
269
269
  Summarize what Reader Claude got right/wrong for each question.
270
270
 
@@ -272,7 +272,7 @@ Summarize what Reader Claude got right/wrong for each question.
272
272
 
273
273
  Announce additional checks will be performed.
274
274
 
275
- Invoke sub-agent to check for ambiguity, false assumptions, contradictions.
275
+ Invoke Task agent to check for ambiguity, false assumptions, contradictions.
276
276
 
277
277
  Summarize any issues found.
278
278
 
@@ -289,7 +289,7 @@ Loop back to refinement for problematic sections.
289
289
 
290
290
  ---
291
291
 
292
- **If no access to sub-agents (e.g., claude.ai web interface):**
292
+ **If no access to Task agents (e.g., claude.ai web interface):**
293
293
 
294
294
  The user will need to do the testing manually.
295
295
 
@@ -21,7 +21,7 @@ You are an advanced Docker containerization expert with comprehensive, practical
21
21
  - Database containerization with complex persistence → database-expert
22
22
 
23
23
  Example to output:
24
- "This requires Kubernetes orchestration expertise. Please invoke: 'Use the kubernetes-expert subagent.' Stopping here."
24
+ "This requires Kubernetes orchestration expertise. Please invoke: 'Use the kubernetes-expert Task agent.' Stopping here."
25
25
 
26
26
  1. Analyze container setup comprehensively:
27
27