@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
@@ -81,10 +81,10 @@ Design prompts to maximize cache stability: avoid dynamic content like timestamp
81
81
 
82
82
  ### Context Partitioning
83
83
 
84
- **Sub-Agent Partitioning**
85
- The most aggressive form of context optimization is partitioning work across sub-agents with isolated contexts. Each sub-agent operates in a clean context focused on its subtask without carrying accumulated context from other subtasks.
84
+ **Task Agent Partitioning**
85
+ The most aggressive form of context optimization is partitioning work across Task agents with isolated contexts. Each Task agent operates in a clean context focused on its subtask without carrying accumulated context from other subtasks.
86
86
 
87
- This approach achieves separation of concerns—the detailed search context remains isolated within sub-agents while the coordinator focuses on synthesis and analysis.
87
+ This approach achieves separation of concerns—the detailed search context remains isolated within Task agents while the coordinator focuses on synthesis and analysis.
88
88
 
89
89
  **Result Aggregation**
90
90
  Aggregate results from partitioned subtasks by validating all partitions completed, merging compatible results, and summarizing if still too large.
@@ -3,7 +3,7 @@ description: ⚡ No research. Only scout, plan & implement ["trust me bro"]
3
3
  argument-hint: [tasks-or-prompt]
4
4
  ---
5
5
 
6
- Think harder to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
+ Think harder 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
  ---
@@ -21,6 +21,6 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
21
21
 
22
22
  ## Workflow:
23
23
 
24
- - **Scout**: Use `scout` subagent to find related resources, documents, and code snippets in the current codebase.
25
- - **Plan**: Trigger slash command `/plan:fast <detailed-instruction-prompt>` to create an implementation plan based on the reports from `scout` subagent.
24
+ - **Scout**: Use a Task agent for scouting: Task(subagent_type="general-purpose", prompt="You are a scout. Find related resources, documents, and code snippets in the current codebase.", description="Scout codebase") to find related resources, documents, and code snippets in the current codebase.
25
+ - **Plan**: Trigger slash command `/plan:fast <detailed-instruction-prompt>` to create an implementation plan based on the reports from the Task agent for scouting.
26
26
  - **Implementation**: Trigger slash command `/code "skip code review step" <plan-path-name>` to implement the plan.
@@ -10,7 +10,7 @@ argument-hint: [tasks]
10
10
  ## Workflow
11
11
 
12
12
  ### 1. Research (Optional)
13
- - Use max 2 `researcher` agents in parallel if tasks complex
13
+ - Use max 2 Task agents for research in parallel if tasks complex
14
14
  - Use `/scout:ext` to search codebase
15
15
  - Keep reports ≤150 lines
16
16
 
@@ -20,30 +20,30 @@ argument-hint: [tasks]
20
20
 
21
21
  ### 3. Parallel Implementation
22
22
  - Read `plan.md` for dependency graph
23
- - Launch multiple `fullstack-developer` agents in PARALLEL for concurrent phases
24
- - Example: "Phases 1-3 parallel" → launch 3 agents simultaneously
23
+ - Launch multiple Task agents for fullstack development in PARALLEL for concurrent phases
24
+ - Example: "Phases 1-3 parallel" → launch 3 Task agents simultaneously
25
25
  - Pass phase file path: `{plan-dir}/phase-XX-*.md`
26
26
  - Include environment info
27
27
  - Wait for all parallel phases complete before dependent phases
28
28
  - Sequential phases: launch one agent at a time
29
29
 
30
30
  ### 4. Testing
31
- - Use `tester` subagent for full test suite
31
+ - Use a Task agent for testing for full test suite
32
32
  - NO fake data/mocks/cheats
33
- - If fail: use `debugger`, fix, repeat
33
+ - If fail: use Task agent for debugging, fix, repeat
34
34
 
35
35
  ### 5. Code Review
36
- - Use `code-reviewer` for all changes
36
+ - Use Task agent for code review for all changes
37
37
  - If critical issues: fix, retest
38
38
 
39
39
  ### 6. Project Management & Docs
40
- - If approved: use `project-manager` + `docs-manager` in parallel
40
+ - If approved: use Task agent for project management + Task agent for documentation in parallel
41
41
  - Update plan files, docs, roadmap
42
42
  - If rejected: fix and repeat
43
43
 
44
44
  ### 7. Final Report
45
45
  - Summary of all parallel phases
46
46
  - Guide to get started
47
- - Ask to commit (use `git-manager` if yes)
47
+ - Ask to commit (use Task agent for git operations if yes)
48
48
 
49
- **Example:** Phases 1-3 parallel → Launch 3 fullstack-developer agents → Wait → Phase 4 sequential
49
+ **Example:** Phases 1-3 parallel → Launch 3 Task agents for fullstack development → Wait → Phase 4 sequential
@@ -3,7 +3,7 @@ description: ⚡⚡ Implement a feature automatically ("trust me bro")
3
3
  argument-hint: [tasks]
4
4
  ---
5
5
 
6
- **Ultrathink** to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
+ **Ultrathink** 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
  **IMPORTANT:** Analyze the list of skills at `.claude/skills/*` and intelligently activate the skills that are needed for the task during the process.
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Quick Feature — Rapid feature implementation
2
+ description: Quick Feature — Rapid feature implementation
3
3
  version: "1.0"
4
4
  category: engineering
5
5
  execution-mode: execute
@@ -13,30 +13,7 @@ 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
29
-
30
- | Tier | When | Action |
31
- | ---------- | ------------------ | ---------------------------- |
32
- | **TIER 1** | runSubagent EXISTS | Invoke sub-agent (MANDATORY) |
33
- | **TIER 2** | Tool MISSING | EMBODY agent file (FALLBACK) |
34
-
35
- **❌ Anti-Lazy**: Never use TIER 2 when TIER 1 tool available.
36
-
37
- ---
38
-
39
- ## 📁 PRIOR PLAN CHECK
16
+ ## PRIOR PLAN CHECK
40
17
 
41
18
  ```
42
19
  IF ./reports/plans/PLAN-{feature}.md exists:
@@ -49,38 +26,52 @@ Any files in `./reports/` or `./documents/` → English only.
49
26
 
50
27
  ---
51
28
 
52
- ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
29
+ ## Execution
53
30
 
54
- 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).
31
+ One phase at a time, sequential. Each phase must complete before next begins.
55
32
 
56
33
  ---
57
34
 
58
- ## 🎭 Phase 1: CONTEXT SCAN
35
+ ## Phase 1: CONTEXT SCAN
36
+
37
+ | Attribute | Value |
38
+ | --------- | --------------------------------------------- |
39
+ | **Role** | `scouter` |
40
+ | **Goal** | Quick context gathering |
41
+ | **Exit** | Patterns found, integration points identified |
42
+
43
+ ### Delegation
59
44
 
60
- | Agent | `scouter` |
61
- | ----- | --------------------------------------------- |
62
- | Goal | Quick context gathering |
63
- | Exit | Patterns found, integration points identified |
45
+ > Task(subagent_type="general-purpose", prompt="You are a scouter. Perform quick context gathering for the feature. Exit when: patterns found, integration points identified.", description="scouter: Quick context gathering")
64
46
 
65
47
  ---
66
48
 
67
- ## 🎭 Phase 2: MICRO-PLANNING
49
+ ## Phase 2: MICRO-PLANNING
68
50
 
69
- | Agent | `planner` |
70
- | ----- | ---------------------------------- |
71
- | Goal | Quick implementation checklist |
72
- | Exit | Steps identified, approach defined |
51
+ | Attribute | Value |
52
+ | --------- | ---------------------------------- |
53
+ | **Role** | `planner` |
54
+ | **Goal** | Quick implementation checklist |
55
+ | **Exit** | Steps identified, approach defined |
56
+
57
+ ### Delegation
58
+
59
+ > Task(subagent_type="general-purpose", prompt="You are a planner. Create a quick implementation checklist for the feature. Exit when: steps identified, approach defined.", description="planner: Quick implementation checklist")
73
60
 
74
61
  ---
75
62
 
76
- ## 🎭 Phase 3: IMPLEMENTATION
63
+ ## Phase 3: IMPLEMENTATION
64
+
65
+ | Attribute | Value |
66
+ | ---------------- | --------------------------------------------------------------------- |
67
+ | **Role** | Route by domain: UI → `frontend-engineer`, API → `backend-engineer`, DB → `database-architect` |
68
+ | **Prerequisite** | READ `./reports/plans/PLAN-{feature}.md` if exists |
69
+ | **Goal** | Implement feature |
70
+ | **Exit** | Feature implemented, code compiles, basic testing done |
71
+
72
+ ### Delegation
77
73
 
78
- | Agent | Route by domain |
79
- | ------------ | ----------------------------------------------------------------------------- |
80
- | Route | UI → `frontend-engineer`, API → `backend-engineer`, DB → `database-architect` |
81
- | Prerequisite | READ `./reports/plans/PLAN-{feature}.md` if exists |
82
- | Goal | Implement feature |
83
- | Exit | Feature implemented, code compiles, basic testing done |
74
+ > Task(subagent_type="general-purpose", prompt="You are a domain engineer (frontend, backend, or database as appropriate). Implement the feature following existing patterns. READ plan file if exists. Exit when: feature implemented, code compiles, basic testing done.", description="engineer: Implement feature")
84
75
 
85
76
  ---
86
77
 
@@ -98,6 +89,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
98
89
 
99
90
  Present feature with:
100
91
 
101
- 1. **Done** — Feature complete
102
- 2. 🧪 **Test** → `/test`
103
- 3. 📝 **Docs** → `/docs:core`
92
+ 1. **Done** — Feature complete
93
+ 2. **Test** → `/test`
94
+ 3. **Docs** → `/docs:core`
@@ -13,34 +13,9 @@ 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
29
-
30
- > Reference: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
31
-
32
- | Tier | When | Action |
33
- | ---------- | ----------------------------- | ---------------------------- |
34
- | **TIER 1** | runSubagent/Agent Tool EXISTS | Invoke sub-agent (MANDATORY) |
35
- | **TIER 2** | Tool MISSING or SYSTEM error | EMBODY agent file (FALLBACK) |
36
-
37
- **❌ Anti-Lazy**: Never use TIER 2 when TIER 1 tool available.
38
-
39
- ---
40
-
41
16
  ## 📁 DELIVERABLE FILES
42
17
 
43
- | Agent | Output |
18
+ | Role | Output |
44
19
  | ------------ | ----------------------------------------------- |
45
20
  | brainstormer | `./reports/brainstorms/BRAINSTORM-{feature}.md` |
46
21
  | researcher | `./reports/researchers/RESEARCH-{feature}.md` |
@@ -70,77 +45,99 @@ All files in `./reports/` → English only.
70
45
 
71
46
  ---
72
47
 
73
- ## ⛔ INCREMENTAL EXECUTION (MANDATORY)
74
-
75
- 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). Format: rules/EXECUTION-PROTOCOL.md § Phase output structure.
76
-
77
- ---
78
-
79
48
  ## 🎭 Phase 1: REQUIREMENTS CLARIFICATION
80
49
 
81
- | Agent | `brainstormer` |
50
+ | Role | `brainstormer` |
82
51
  | ----- | -------------------------------------------------------------------- |
83
52
  | Goal | Full requirements discovery |
84
53
  | Exit | Requirements clear, constraints identified, success criteria defined |
85
54
 
55
+ ### Delegation
56
+
57
+ > Task(subagent_type="general-purpose", prompt="You are a brainstormer. Full requirements discovery. [See exit criteria above]", description="brainstormer")
58
+
86
59
  ---
87
60
 
88
61
  ## 🎭 Phase 2: RESEARCH
89
62
 
90
- | Agent | `researcher` |
63
+ | Role | `researcher` |
91
64
  | ----- | -------------------------------------------------------------------------- |
92
65
  | Goal | Research best practices and patterns |
93
66
  | Exit | Patterns researched, best practices identified, recommendations documented |
94
67
 
68
+ ### Delegation
69
+
70
+ > Task(subagent_type="general-purpose", prompt="You are a researcher. Research best practices and patterns. [See exit criteria above]", description="researcher")
71
+
95
72
  ---
96
73
 
97
74
  ## 🎭 Phase 3: CODEBASE ANALYSIS
98
75
 
99
- | Agent | `scouter` |
76
+ | Role | `scouter` |
100
77
  | ----- | ----------------------------------------------------------------------- |
101
78
  | Goal | Map architecture and integration points |
102
79
  | Exit | Architecture understood, integration points mapped, patterns documented |
103
80
 
81
+ ### Delegation
82
+
83
+ > Task(subagent_type="general-purpose", prompt="You are a scouter. Map architecture and integration points. [See exit criteria above]", description="scouter")
84
+
104
85
  ---
105
86
 
106
87
  ## 🎭 Phase 3.5: DATABASE DESIGN (IF DATA CHANGES)
107
88
 
108
- | Agent | `database-architect` |
89
+ | Role | `database-architect` |
109
90
  | ------- | ----------------------------------------------------------- |
110
91
  | Trigger | Feature involves database changes/migrations |
111
92
  | Goal | Schema design and data modeling |
112
93
  | Exit | Schema designed, migrations planned, query patterns defined |
113
94
 
95
+ ### Delegation
96
+
97
+ > Task(subagent_type="general-purpose", prompt="You are a database-architect. Schema design and data modeling. [See exit criteria above]", description="database-architect")
98
+
114
99
  ---
115
100
 
116
101
  ## 🎭 Phase 4: DESIGN (IF UI NEEDED)
117
102
 
118
- | Agent | `designer` |
103
+ | Role | `designer` |
119
104
  | ------- | ----------------------------------------------------- |
120
105
  | Trigger | Feature has UI components |
121
106
  | Goal | UI/UX design |
122
107
  | Exit | Design created, accessibility considered, specs ready |
123
108
 
109
+ ### Delegation
110
+
111
+ > Task(subagent_type="general-purpose", prompt="You are a designer. UI/UX design. [See exit criteria above]", description="designer")
112
+
124
113
  ---
125
114
 
126
115
  ## 🎭 Phase 5: PLANNING
127
116
 
128
- | Agent | `planner` |
117
+ | Role | `planner` |
129
118
  | ------------ | --------------------------------------------------- |
130
119
  | Prerequisite | **READ** RESEARCH + SCOUT + DESIGN files |
131
120
  | Goal | Create detailed implementation plan |
132
121
  | Output | `./reports/plans/PLAN-{feature}.md` |
133
122
  | Exit | Plan file created, phases defined, risks identified |
134
123
 
124
+ ### Delegation
125
+
126
+ > Task(subagent_type="general-purpose", prompt="You are a planner. READ RESEARCH + SCOUT + DESIGN files. Create detailed implementation plan. [See exit criteria above]", description="planner")
127
+
135
128
  ---
136
129
 
137
130
  ## 🎭 Phase 6: IMPLEMENTATION
138
131
 
139
- | Agent | `tech-lead` → routes to specialists |
132
+ | Role | `tech-lead` → routes to specialists |
140
133
  | ------------ | ------------------------------------------------------- |
141
134
  | Prerequisite | **READ and FOLLOW** `./reports/plans/PLAN-{feature}.md` |
142
135
  | Goal | Execute implementation plan |
143
136
 
137
+ ### Delegation
138
+
139
+ > Task(subagent_type="general-purpose", prompt="You are a tech-lead. READ and FOLLOW the PLAN file. Execute implementation plan. [See exit criteria below]", description="tech-lead")
140
+
144
141
  **STRICT ADHERENCE:**
145
142
 
146
143
  ```
@@ -159,11 +156,15 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
159
156
 
160
157
  ## 🎭 Phase 7: TESTING
161
158
 
162
- | Agent | `tester` |
159
+ | Role | `tester` |
163
160
  | ------------ | ---------------------------- |
164
161
  | Prerequisite | **READ** PLAN + Code changes |
165
162
  | Goal | Comprehensive testing |
166
163
 
164
+ ### Delegation
165
+
166
+ > Task(subagent_type="general-purpose", prompt="You are a tester. READ PLAN + Code changes. Comprehensive testing with plan checkpoint verification. [See exit criteria below]", description="tester")
167
+
167
168
  **PLAN CHECKPOINT VERIFICATION:**
168
169
 
169
170
  ```
@@ -178,11 +179,15 @@ FOR EACH checkpoint in PLAN:
178
179
 
179
180
  ## 🎭 Phase 8: REVIEW
180
181
 
181
- | Agent | `reviewer` |
182
+ | Role | `reviewer` |
182
183
  | ------------ | -------------------------------- |
183
184
  | Prerequisite | **READ** PLAN + Code + Tests |
184
185
  | Goal | Quality review + Plan compliance |
185
186
 
187
+ ### Delegation
188
+
189
+ > Task(subagent_type="general-purpose", prompt="You are a reviewer. READ PLAN + Code + Tests. Quality review and plan compliance check. [See exit criteria below]", description="reviewer")
190
+
186
191
  **REVIEW CHECKLIST:**
187
192
 
188
193
  - Does code implement plan specification?
@@ -3,14 +3,14 @@ description: ⚡⚡⚡ Implement a feature [step by step]
3
3
  argument-hint: [tasks]
4
4
  ---
5
5
 
6
- Think harder to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
6
+ Think harder 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
  ---
10
10
 
11
11
  ## Role Responsibilities
12
12
  - You are an elite software engineering expert who specializes in system architecture design and technical decision-making.
13
- - Your core mission is to collaborate with users to find the best possible solutions while maintaining brutal honesty about feasibility and trade-offs, then collaborate with your subagents to implement the plan.
13
+ - Your core mission is to collaborate with users to find the best possible solutions while maintaining brutal honesty about feasibility and trade-offs, then collaborate with your Task agents to implement the plan.
14
14
  - You operate by the holy trinity of software engineering: **YAGNI** (You Aren't Gonna Need It), **KISS** (Keep It Simple, Stupid), and **DRY** (Don't Repeat Yourself). Every solution you propose must honor these principles.
15
15
 
16
16
  ---
@@ -41,13 +41,13 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
41
41
 
42
42
  ### Research
43
43
 
44
- * Use multiple `researcher` subagents in parallel to explore the user's request, idea validation, challenges, and find the best possible solutions.
44
+ * Use multiple Task agents for research in parallel to explore the user's request, idea validation, challenges, and find the best possible solutions.
45
45
  * Keep every research markdown report concise (≤150 lines) while covering all requested topics and citations.
46
46
  * Use `/scout:ext` (preferred) or `/scout` (fallback) slash command to search the codebase for files needed to complete the task
47
47
 
48
48
  ### Plan
49
49
 
50
- *. Use `planner` subagent to analyze reports from `researcher` and `scout` subagents to create an implementation plan using the progressive disclosure structure:
50
+ *. Use a Task agent for planning: Task(subagent_type="general-purpose", prompt="You are a planner. Analyze reports from researcher and scout Task agents to create an implementation plan using the progressive disclosure structure:...
51
51
  - Create a directory using naming pattern from `## Naming` section.
52
52
  - Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
53
53
  - 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).
@@ -55,7 +55,7 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
55
55
  ### Implementation
56
56
 
57
57
  * Use `/code` Slash Command to implement the plan step by step, follow the implementation plan in `./plans` directory.
58
- * Use `ui-ux-designer` subagent to implement the frontend part follow the design guidelines at `./docs/design-guidelines.md` file.
58
+ * Use a Task agent for UI/UX design: Task(subagent_type="general-purpose", prompt="You are a ui-ux-designer. Implement the frontend part follow the design guidelines at ./docs/design-guidelines.md file.", description="Implement frontend UI") to implement the frontend part follow the design guidelines at `./docs/design-guidelines.md` file.
59
59
  * Use `ai-multimodal` skill to generate image assets.
60
60
  * Use `ai-multimodal` skill to analyze and verify generated assets.
61
61
  * Use `media-processing` skill for image editing (crop, resize, remove background) if needed.
@@ -64,13 +64,13 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
64
64
  ### Testing
65
65
 
66
66
  * Write the tests for the plan, **make sure you don't use fake data, mocks, cheats, tricks, temporary solutions, just to pass the build or github actions**, tests should be real and cover all possible cases.
67
- * Use `tester` subagent to run the tests, make sure it works, then report back to main agent.
68
- * If there are issues or failed tests, use `debugger` subagent to find the root cause of the issues, then ask main agent to fix all of them and
67
+ * Use a Task agent for testing: Task(subagent_type="general-purpose", prompt="You are a tester. Run the tests, make sure it works, then report back to main agent.", description="Run tests") to run the tests, make sure it works, then report back to main agent.
68
+ * If there are issues or failed tests, use a Task agent for debugging: Task(subagent_type="general-purpose", prompt="You are a debugger. Find the root cause of the issues.", description="Debug failures") to find the root cause of the issues, then ask main agent to fix all of them and
69
69
  * Repeat the process until all tests pass or no more issues are reported. Again, do not ignore failed tests or use fake data just to pass the build or github actions.
70
70
 
71
71
  ### Code Review
72
72
 
73
- * After finishing, delegate to `code-reviewer` subagent to review code. If there are critical issues, ask main agent to improve the code and tell `tester` agent to run the tests again.
73
+ * After finishing, delegate to a Task agent for code review: Task(subagent_type="general-purpose", prompt="You are a code-reviewer. Review code.", description="Code review") to review code. If there are critical issues, ask main agent to improve the code and tell the Task agent for testing to run the tests again.
74
74
  * Repeat the "Testing" process until all tests pass.
75
75
  * When all tests pass, code is reviewed, the tasks are completed, report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
76
76
  * **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
@@ -78,10 +78,10 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
78
78
  ### Project Management & Documentation
79
79
 
80
80
  **If user approves the changes:**
81
- * Use `project-manager` and `docs-manager` subagents in parallel to update the project progress and documentation:
82
- * Use `project-manager` subagent to update the project progress and task status in the given plan file.
83
- * Use `docs-manager` subagent to update the docs in `./docs` directory if needed.
84
- * Use `project-manager` subagent to create a project roadmap at `./docs/project-roadmap.md` file.
81
+ * Use Task agents for project management and documentation in parallel to update the project progress and documentation:
82
+ * Use a Task agent for project management: Task(subagent_type="general-purpose", prompt="You are a project-manager. Update the project progress and task status in the given plan file.", description="Update project progress") to update the project progress and task status in the given plan file.
83
+ * Use a Task agent for documentation: Task(subagent_type="general-purpose", prompt="You are a docs-manager. Update the docs in ./docs directory if needed.", description="Update docs") to update the docs in `./docs` directory if needed.
84
+ * Use a Task agent for project management: Task(subagent_type="general-purpose", prompt="You are a project-manager. Create a project roadmap at ./docs/project-roadmap.md file.", description="Create roadmap") to create a project roadmap at `./docs/project-roadmap.md` file.
85
85
  * **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
86
86
 
87
87
  **If user rejects the changes:**
@@ -95,7 +95,7 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
95
95
 
96
96
  ### Final Report
97
97
  * Report back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
98
- * Ask the user if they want to commit and push to git repository, if yes, use `git-manager` subagent to commit and push to git repository.
98
+ * Ask the user if they want to commit and push to git repository, if yes, use a Task agent for git operations: Task(subagent_type="general-purpose", prompt="You are a git-manager. Commit and push to git repository.", description="Git commit and push") to commit and push to git repository.
99
99
  - **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
100
100
  - **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
101
101
 
@@ -11,7 +11,7 @@ source: community
11
11
 
12
12
  # Daily News Report v3.0
13
13
 
14
- > **Architecture Upgrade**: Main Agent Orchestration + SubAgent Execution + Browser Scraping + Smart Caching
14
+ > **Architecture Upgrade**: Main Agent Orchestration + Task Agent Execution + Browser Scraping + Smart Caching
15
15
 
16
16
  ## Core Architecture
17
17
 
@@ -35,7 +35,7 @@ source: community
35
35
  └──────────────────────────────────────────────────────────────────────┘
36
36
  ↓ Dispatch ↑ Return Results
37
37
  ┌─────────────────────────────────────────────────────────────────────┐
38
- SubAgent Execution Layer │
38
+ Task Agent Execution Layer │
39
39
  ├─────────────────────────────────────────────────────────────────────┤
40
40
  │ │
41
41
  │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
@@ -74,7 +74,7 @@ Steps:
74
74
  5. Check if a partial report exists for today (append mode)
75
75
  ```
76
76
 
77
- ### Phase 2: Dispatch SubAgents
77
+ ### Phase 2: Dispatch Task Agents
78
78
 
79
79
  **Strategy**: Parallel dispatch, batch execution, early stopping mechanism
80
80
 
@@ -95,9 +95,9 @@ If still < 20 items:
95
95
  - Browser Worker: ProductHunt, Latent Space (Require JS rendering)
96
96
  ```
97
97
 
98
- ### Phase 3: SubAgent Task Format
98
+ ### Phase 3: Task Agent Task Format
99
99
 
100
- Task format received by each SubAgent:
100
+ Task format received by each Task Agent:
101
101
 
102
102
  ```yaml
103
103
  task: fetch_and_extract
@@ -134,12 +134,12 @@ Main Agent Responsibilities:
134
134
 
135
135
  ```yaml
136
136
  Monitoring:
137
- - Check SubAgent return status (success/partial/failed)
137
+ - Check Task Agent return status (success/partial/failed)
138
138
  - Count collected items
139
139
  - Record success rate per source
140
140
 
141
141
  Feedback Loop:
142
- - If a SubAgent fails, decide whether to retry or skip
142
+ - If a Task Agent fails, decide whether to retry or skip
143
143
  - If a source fails persistently, mark as disabled
144
144
  - Dynamically adjust source selection for subsequent batches
145
145
 
@@ -158,7 +158,7 @@ Deduplication:
158
158
  - Check cache.json to avoid history duplicates
159
159
 
160
160
  Score Calibration:
161
- - Unify scoring standards across SubAgents
161
+ - Unify scoring standards across Task Agents
162
162
  - Adjust weights based on source credibility
163
163
  - Bonus points for manually curated high-quality sources
164
164
 
@@ -212,7 +212,7 @@ Update cache.json:
212
212
  - article_history: Record included articles
213
213
  ```
214
214
 
215
- ## SubAgent Call Examples
215
+ ## Task Agent Call Examples
216
216
 
217
217
  ### Using general-purpose Agent
218
218
 
@@ -260,7 +260,7 @@ Task Call:
260
260
 
261
261
  ```
262
262
  Task Call:
263
- subagent_type: worker
263
+ subagent_type: general-purpose
264
264
  prompt: |
265
265
  task: fetch_and_extract
266
266
  input:
@@ -288,7 +288,7 @@ Task Call:
288
288
  > Curated from N sources today, containing 20 high-quality items
289
289
  > Generation Time: X min | Version: v3.0
290
290
  >
291
- > **Warning**: Sub-agent 'worker' not detected. Running in generic mode (Serial Execution). Performance might be degraded.
291
+ > **Warning**: Task agent 'worker' not detected. Running in generic mode (Serial Execution). Performance might be degraded.
292
292
 
293
293
  ---
294
294
 
@@ -318,11 +318,11 @@ Task Call:
318
318
 
319
319
  1. **Quality over Quantity**: Low-quality content does not enter the report.
320
320
  2. **Early Stop**: Stop scraping once 20 high-quality items are reached.
321
- 3. **Parallel First**: SubAgents in the same batch execute in parallel.
321
+ 3. **Parallel First**: Task Agents in the same batch execute in parallel.
322
322
  4. **Fault Tolerance**: Failure of a single source does not affect the whole process.
323
323
  5. **Cache Reuse**: Avoid re-scraping the same content.
324
324
  6. **Main Agent Control**: All decisions are made by the Main Agent.
325
- 7. **Fallback Awareness**: Detect sub-agent availability, gracefully degrade if unavailable.
325
+ 7. **Fallback Awareness**: Detect Task agent availability, gracefully degrade if unavailable.
326
326
 
327
327
  ## Expected Performance
328
328
 
@@ -336,7 +336,7 @@ Task Call:
336
336
 
337
337
  | Error Type | Handling |
338
338
  |---|---|
339
- | SubAgent Timeout | Log error, continue to next |
339
+ | Task Agent Timeout | Log error, continue to next |
340
340
  | Source 403/404 | Mark disabled, update sources.json |
341
341
  | Extraction Failed | Return raw content, Main Agent decides |
342
342
  | Browser Crash | Skip source, log entry |
@@ -346,7 +346,7 @@ Task Call:
346
346
  To ensure usability across different Agent environments, the following checks must be performed:
347
347
 
348
348
  1. **Environment Check**:
349
- - In Phase 1 initialization, attempt to detect if `worker` sub-agent exists.
349
+ - In Phase 1 initialization, attempt to detect if `worker` Task agent exists.
350
350
  - If not exists (or plugin not installed), automatically switch to **Serial Execution Mode**.
351
351
 
352
352
  2. **Serial Execution Mode**: