@ngxtm/devkit 3.19.0 → 3.21.0

package/merged-commands/incident-response-incident-response.md

@@ -45,19 +45,19 @@ Orchestrate multi-agent incident response with modern SRE practices for rapid re
 ## Phase 1: Detection & Triage
 
 ### 1. Incident Detection and Classification
-- Use Task tool with subagent_type="incident-responder"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "URGENT: Detect and classify incident: $ARGUMENTS. Analyze alerts from PagerDuty/Opsgenie/monitoring. Determine: 1) Incident severity (P0-P3), 2) Affected services and dependencies, 3) User impact and business risk, 4) Initial incident command structure needed. Check error budgets and SLO violations."
 - Output: Severity classification, impact assessment, incident command assignments, SLO status
 - Context: Initial alerts, monitoring dashboards, recent changes
 
 ### 2. Observability Analysis
-- Use Task tool with subagent_type="observability-monitoring::observability-engineer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Perform rapid observability sweep for incident: $ARGUMENTS. Query: 1) Distributed tracing (OpenTelemetry/Jaeger), 2) Metrics correlation (Prometheus/Grafana/DataDog), 3) Log aggregation (ELK/Splunk), 4) APM data, 5) Real User Monitoring. Identify anomalies, error patterns, and service degradation points."
 - Output: Observability findings, anomaly detection, service health matrix, trace analysis
 - Context: Severity level from step 1, affected services
 
 ### 3. Initial Mitigation
-- Use Task tool with subagent_type="incident-responder"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Implement immediate mitigation for P$SEVERITY incident: $ARGUMENTS. Actions: 1) Traffic throttling/rerouting if needed, 2) Feature flag disabling for affected features, 3) Circuit breaker activation, 4) Rollback assessment for recent deployments, 5) Scale resources if capacity-related. Prioritize user experience restoration."
 - Output: Mitigation actions taken, temporary fixes applied, rollback decisions
 - Context: Observability findings, severity classification
@@ -65,19 +65,19 @@ Orchestrate multi-agent incident response with modern SRE practices for rapid re
 ## Phase 2: Investigation & Root Cause Analysis
 
 ### 4. Deep System Debugging
-- Use Task tool with subagent_type="error-debugging::debugger"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Conduct deep debugging for incident: $ARGUMENTS using observability data. Investigate: 1) Stack traces and error logs, 2) Database query performance and locks, 3) Network latency and timeouts, 4) Memory leaks and CPU spikes, 5) Dependency failures and cascading errors. Apply Five Whys analysis."
 - Output: Root cause identification, contributing factors, dependency impact map
 - Context: Observability analysis, mitigation status
 
 ### 5. Security Assessment
-- Use Task tool with subagent_type="security-scanning::security-auditor"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Assess security implications of incident: $ARGUMENTS. Check: 1) DDoS attack indicators, 2) Authentication/authorization failures, 3) Data exposure risks, 4) Certificate issues, 5) Suspicious access patterns. Review WAF logs, security groups, and audit trails."
 - Output: Security assessment, breach analysis, vulnerability identification
 - Context: Root cause findings, system logs
 
 ### 6. Performance Engineering Analysis
-- Use Task tool with subagent_type="application-performance::performance-engineer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Analyze performance aspects of incident: $ARGUMENTS. Examine: 1) Resource utilization patterns, 2) Query optimization opportunities, 3) Caching effectiveness, 4) Load balancer health, 5) CDN performance, 6) Autoscaling triggers. Identify bottlenecks and capacity issues."
 - Output: Performance bottlenecks, resource recommendations, optimization opportunities
 - Context: Debug findings, current mitigation state
@@ -85,13 +85,13 @@ Orchestrate multi-agent incident response with modern SRE practices for rapid re
 ## Phase 3: Resolution & Recovery
 
 ### 7. Fix Implementation
-- Use Task tool with subagent_type="backend-development::backend-architect"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Design and implement production fix for incident: $ARGUMENTS based on root cause. Requirements: 1) Minimal viable fix for rapid deployment, 2) Risk assessment and rollback capability, 3) Staged rollout plan with monitoring, 4) Validation criteria and health checks. Consider both immediate fix and long-term solution."
 - Output: Fix implementation, deployment strategy, validation plan, rollback procedures
 - Context: Root cause analysis, performance findings, security assessment
 
 ### 8. Deployment and Validation
-- Use Task tool with subagent_type="deployment-strategies::deployment-engineer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Execute emergency deployment for incident fix: $ARGUMENTS. Process: 1) Blue-green or canary deployment, 2) Progressive rollout with monitoring, 3) Health check validation at each stage, 4) Rollback triggers configured, 5) Real-time monitoring during deployment. Coordinate with incident command."
 - Output: Deployment status, validation results, monitoring dashboard, rollback readiness
 - Context: Fix implementation, current system state
@@ -99,13 +99,13 @@ Orchestrate multi-agent incident response with modern SRE practices for rapid re
 ## Phase 4: Communication & Coordination
 
 ### 9. Stakeholder Communication
-- Use Task tool with subagent_type="content-marketing::content-marketer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Manage incident communication for: $ARGUMENTS. Create: 1) Status page updates (public-facing), 2) Internal engineering updates (technical details), 3) Executive summary (business impact/ETA), 4) Customer support briefing (talking points), 5) Timeline documentation with key decisions. Update every 15-30 minutes based on severity."
 - Output: Communication artifacts, status updates, stakeholder briefings, timeline log
 - Context: All previous phases, current resolution status
 
 ### 10. Customer Impact Assessment
-- Use Task tool with subagent_type="incident-responder"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Assess and document customer impact for incident: $ARGUMENTS. Analyze: 1) Affected user segments and geography, 2) Failed transactions or data loss, 3) SLA violations and contractual implications, 4) Customer support ticket volume, 5) Revenue impact estimation. Prepare proactive customer outreach list."
 - Output: Customer impact report, SLA analysis, outreach recommendations
 - Context: Resolution progress, communication status
@@ -113,19 +113,19 @@ Orchestrate multi-agent incident response with modern SRE practices for rapid re
 ## Phase 5: Postmortem & Prevention
 
 ### 11. Blameless Postmortem
-- Use Task tool with subagent_type="documentation-generation::docs-architect"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Conduct blameless postmortem for incident: $ARGUMENTS. Document: 1) Complete incident timeline with decisions, 2) Root cause and contributing factors (systems focus), 3) What went well in response, 4) What could improve, 5) Action items with owners and deadlines, 6) Lessons learned for team education. Follow SRE postmortem best practices."
 - Output: Postmortem document, action items list, process improvements, training needs
 - Context: Complete incident history, all agent outputs
 
 ### 12. Monitoring and Alert Enhancement
-- Use Task tool with subagent_type="observability-monitoring::observability-engineer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Enhance monitoring to prevent recurrence of: $ARGUMENTS. Implement: 1) New alerts for early detection, 2) SLI/SLO adjustments if needed, 3) Dashboard improvements for visibility, 4) Runbook automation opportunities, 5) Chaos engineering scenarios for testing. Ensure alerts are actionable and reduce noise."
 - Output: New monitoring configuration, alert rules, dashboard updates, runbook automation
 - Context: Postmortem findings, root cause analysis
 
 ### 13. System Hardening
-- Use Task tool with subagent_type="backend-development::backend-architect"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Design system improvements to prevent incident: $ARGUMENTS. Propose: 1) Architecture changes for resilience (circuit breakers, bulkheads), 2) Graceful degradation strategies, 3) Capacity planning adjustments, 4) Technical debt prioritization, 5) Dependency reduction opportunities. Create implementation roadmap."
 - Output: Architecture improvements, resilience patterns, technical debt items, roadmap
 - Context: Postmortem action items, performance analysis

package/merged-commands/integrate/polar.md

@@ -5,7 +5,7 @@ argument-hint: [tasks]
 
 Think harder.
 Activate `payment-integration` skill.
-Plan & start implementing payment integration with [Polar.sh](https://polar.sh/docs/llms-full.txt) follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules: 
+Plan & start implementing payment integration with [Polar.sh](https://polar.sh/docs/llms-full.txt) follow the Orchestration Protocol, Core Responsibilities, and Development Rules:
 <tasks>$ARGUMENTS</tasks>
 
 ---
@@ -23,6 +23,6 @@ Plan & start implementing payment integration with [Polar.sh](https://polar.sh/d
 
 ## Workflow:
 
-- **Scout**: Use `scout` subagent to find related resources, documents, and code snippets in the current codebase.
-- **Plan**: Trigger slash command `/plan:fast <detailed-instruction-prompt>` to create an implementation plan based on the reports from `scout` subagent.
+- **Scout**: Use Task agent for scouting to find related resources, documents, and code snippets in the current codebase: Task(subagent_type="general-purpose", prompt="You are a scout. Find related resources...", description="Scout codebase")
+- **Plan**: Trigger slash command `/plan:fast <detailed-instruction-prompt>` to create an implementation plan based on the reports from Task agent.
 - **Implementation**: Trigger slash command `/code <plan>` to implement the plan.

package/merged-commands/integrate/sepay.md

@@ -5,7 +5,7 @@ argument-hint: [tasks]
 
 Think harder.
 Activate `payment-integration` skill.
-Plan & start implementing payment integration with [https://developer.sepay.vn/vi](https://developer.sepay.vn/vi) follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules: 
+Plan & start implementing payment integration with [https://developer.sepay.vn/vi](https://developer.sepay.vn/vi) follow the Orchestration Protocol, Core Responsibilities, and Development Rules:
 <tasks>$ARGUMENTS</tasks>
 
 ---
@@ -23,6 +23,6 @@ Plan & start implementing payment integration with [https://developer.sepay.vn/v
 
 ## Workflow:
 
-- **Scout**: Use `scout` subagent to find related resources, documents, and code snippets in the current codebase.
-- **Plan**: Trigger slash command `/plan:fast <detailed-instruction-prompt>` to create an implementation plan based on the reports from `scout` subagent.
+- **Scout**: Use Task agent for scouting to find related resources, documents, and code snippets in the current codebase: Task(subagent_type="general-purpose", prompt="You are a scout. Find related resources...", description="Scout codebase")
+- **Plan**: Trigger slash command `/plan:fast <detailed-instruction-prompt>` to create an implementation plan based on the reports from Task agent.
 - **Implementation**: Trigger slash command `/code <plan>` to implement the plan.

package/merged-commands/journal.md

@@ -2,6 +2,6 @@
 description: ⚡ Write some journal entries.
 ---
 
-Use the `journal-writer` subagent to explore the memories and recent code changes, and write some journal entries.
+Use a Task agent for journal writing to explore the memories and recent code changes, and write some journal entries: Task(subagent_type="general-purpose", prompt="You are a journal-writer. Explore memories and recent code changes, write journal entries...", description="Write journal entries")
 Journal entries should be concise and focused on the most important events, key changes, impacts, and decisions.
 Keep journal entries in the `./docs/journals/` directory.

package/merged-commands/linear-claude-skill.md

@@ -387,13 +387,13 @@ For detailed helper script usage, see **troubleshooting.md**.
 
 ### Parallel Agent Execution
 
-For bulk operations or background execution, use the `Linear-specialist` subagent:
+For bulk operations or background execution, use the `Linear-specialist` Task agent:
 
 ```javascript
 Task({
   description: "Update Linear issues",
   prompt: "Mark ENG-101, ENG-102, ENG-103 as Done",
-  subagent_type: "Linear-specialist"
+  subagent_type: "general-purpose"
 })
 ```
 

package/merged-commands/loki-mode.md

@@ -137,7 +137,7 @@ If bugs are found in these files, document them in `.loki/CONTINUITY.md` under "
 | - Identify highest priority unblocked task                        |
 +-------------------------------------------------------------------+
 | ACT: Execute the task                                             |
-| - Dispatch subagent via Task tool OR execute directly             |
+| - Dispatch Task agent via Task tool OR execute directly             |
 | - Write code, run tests, fix issues                               |
 | - Commit changes atomically (git checkpoint)                      |
 +-------------------------------------------------------------------+
@@ -175,7 +175,7 @@ If bugs are found in these files, document them in `.loki/CONTINUITY.md` under "
 ### Task Tool Model Parameter
 ```python
 # Opus for planning/architecture ONLY
-Task(subagent_type="Plan", model="opus", description="Design system architecture", prompt="...")
+Task(subagent_type="general-purpose", model="opus", description="Design system architecture", prompt="...")
 
 # Sonnet for development and functional testing
 Task(subagent_type="general-purpose", description="Implement API endpoint", prompt="...")
@@ -286,7 +286,7 @@ Task(description="Refactor database layer for performance", prompt="...")     #
 - **Direct Routing:** Minimal context - just the task and relevant file(s)
 - **Supervisor Mode:** Full context - CONTINUITY.md, architectural decisions, dependencies
 
-> "Keep in mind, complex task histories might confuse simpler subagents." - AWS Best Practices
+> "Keep in mind, complex task histories might confuse simpler Task agents." - AWS Best Practices
 
 ### E2E Testing with Playwright MCP (Anthropic Harness Pattern)
 
@@ -325,7 +325,7 @@ mcp_servers = {
 | Metric | What to Track | Store In |
 |--------|---------------|----------|
 | Wall time | Seconds from start to completion | `.loki/metrics/efficiency/` |
-| Agent count | Number of subagents spawned | `.loki/metrics/efficiency/` |
+| Agent count | Number of Task agents spawned | `.loki/metrics/efficiency/` |
 | Retry count | Attempts before success | `.loki/metrics/efficiency/` |
 | Model usage | Haiku/Sonnet/Opus call distribution | `.loki/metrics/efficiency/` |
 
@@ -351,12 +351,12 @@ See `references/tool-orchestration.md` for full implementation details.
 
 ---
 
-## Structured Prompting for Subagents
+## Structured Prompting for Task Agents
 
 **Single-Responsibility Principle:** Each agent should have ONE clear goal and narrow scope.
 ([UiPath Best Practices](https://www.uipath.com/blog/ai/agent-builder-best-practices))
 
-**Every subagent dispatch MUST include:**
+**Every Task agent dispatch MUST include:**
 
 ```markdown
 ## GOAL (What success looks like)
@@ -446,7 +446,7 @@ See `references/agent-types.md` for complete definitions and capabilities.
 - **NEVER** skip code review between tasks
 - **NEVER** proceed with unfixed Critical/High/Medium issues
 - **NEVER** dispatch reviewers sequentially (always parallel - 3x faster)
-- **NEVER** dispatch multiple implementation subagents in parallel (conflicts)
+- **NEVER** dispatch multiple implementation Task agents in parallel (conflicts)
 - **NEVER** implement without reading task requirements first
 
 ### Review Anti-Patterns
@@ -466,7 +466,7 @@ See `references/agent-types.md` for complete definitions and capabilities.
 - **ALWAYS** wait for all reviewers before aggregating
 - **ALWAYS** fix Critical/High/Medium immediately
 - **ALWAYS** re-run ALL 3 reviewers after fixes
-- **ALWAYS** checkpoint state before spawning subagents
+- **ALWAYS** checkpoint state before spawning Task agents
 
 ---
 
@@ -618,14 +618,14 @@ context_budget:
   reserve: "90% for model reasoning"
 ```
 
-### Sub-Agents for Context Isolation
+### Task Agents for Context Isolation
 
-**Use sub-agents to prevent token waste on noisy subtasks:**
+**Use Task agents to prevent token waste on noisy subtasks:**
 
 ```
-Main agent (focused) --> Sub-agent (file search)
-                     --> Sub-agent (test running)
-                     --> Sub-agent (linting)
+Main agent (focused) --> Task agent (file search)
+                     --> Task agent (test running)
+                     --> Task agent (linting)
 ```
 
 See `references/production-patterns.md` for full practitioner patterns.
@@ -690,7 +690,7 @@ Loki Mode with PRD at path/to/prd   # Start with PRD
 |-------|-------|
 | Trigger | "Loki Mode" or "Loki Mode with PRD at [path]" |
 | Skip When | Need human approval, want to review plan first, single small task |
-| Related Skills | subagent-driven-development, executing-plans |
+| Related Skills | task-agent-driven-development, executing-plans |
 
 ---
 

package/merged-commands/machine-learning-ops-ml-pipeline.md

@@ -46,7 +46,7 @@ The multi-agent approach ensures each aspect is handled by domain experts:
 ## Phase 1: Data & Requirements Analysis
 
 <Task>
-subagent_type: data-engineer
+subagent_type: general-purpose
 prompt: |
   Analyze and design data pipeline for ML system with requirements: $ARGUMENTS
 
@@ -73,7 +73,7 @@ prompt: |
 </Task>
 
 <Task>
-subagent_type: data-scientist
+subagent_type: general-purpose
 prompt: |
   Design feature engineering and model requirements for: $ARGUMENTS
   Using data architecture from: {phase1.data-engineer.output}
@@ -103,7 +103,7 @@ prompt: |
 ## Phase 2: Model Development & Training
 
 <Task>
-subagent_type: ml-engineer
+subagent_type: general-purpose
 prompt: |
   Implement training pipeline based on requirements: {phase1.data-scientist.output}
   Using data pipeline: {phase1.data-engineer.output}
@@ -131,7 +131,7 @@ prompt: |
 </Task>
 
 <Task>
-subagent_type: python-pro
+subagent_type: general-purpose
 prompt: |
   Optimize and productionize ML code from: {phase2.ml-engineer.output}
 
@@ -160,7 +160,7 @@ prompt: |
 ## Phase 3: Production Deployment & Serving
 
 <Task>
-subagent_type: mlops-engineer
+subagent_type: general-purpose
 prompt: |
   Design production deployment for models from: {phase2.ml-engineer.output}
   With optimized code from: {phase2.python-pro.output}
@@ -194,7 +194,7 @@ prompt: |
 </Task>
 
 <Task>
-subagent_type: kubernetes-architect
+subagent_type: general-purpose
 prompt: |
   Design Kubernetes infrastructure for ML workloads from: {phase3.mlops-engineer.output}
 
@@ -223,7 +223,7 @@ prompt: |
 ## Phase 4: Monitoring & Continuous Improvement
 
 <Task>
-subagent_type: observability-engineer
+subagent_type: general-purpose
 prompt: |
   Implement comprehensive monitoring for ML system deployed in: {phase3.mlops-engineer.output}
   Using Kubernetes infrastructure: {phase3.kubernetes-architect.output}

package/merged-commands/mcp-management.md

@@ -15,7 +15,7 @@ MCP is an open protocol enabling AI agents to connect to external tools and data
 - Progressive disclosure of MCP capabilities (load only what's needed)
 - Intelligent tool/prompt/resource selection based on task requirements
 - Multi-server management from single config file
-- Context-efficient: subagents handle MCP discovery and execution
+- Context-efficient: Task agents handle MCP discovery and execution
 - Persistent tool catalog: automatically saves discovered tools to JSON for fast reference
 
 ## When to Use This Skill
@@ -25,7 +25,7 @@ Use this skill when:
 2. **Task-Based Tool Selection**: Analyzing which MCP tools are relevant for a specific task
 3. **Executing MCP Tools**: Calling MCP tools programmatically with proper parameter handling
 4. **MCP Integration**: Building or debugging MCP client implementations
-5. **Context Management**: Avoiding context pollution by delegating MCP operations to subagents
+5. **Context Management**: Avoiding context pollution by delegating MCP operations to Task agents
 
 ## Core Capabilities
 
@@ -80,7 +80,7 @@ echo "Take a screenshot of https://example.com" | gemini -y -m gemini-2.5-flash
 npx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'
 ```
 
-**Fallback: mcp-manager Subagent**
+**Fallback: mcp-manager Task agent**
 
 See [references/gemini-cli-integration.md](references/gemini-cli-integration.md) for complete examples.
 
@@ -106,14 +106,14 @@ echo "Take a screenshot of https://example.com. Return JSON only per GEMINI.md i
 - Automatic tool discovery
 - Structured JSON responses (parseable by Claude)
 - GEMINI.md auto-loaded for consistent formatting
-- Faster than subagent orchestration
+- Faster than Task agent orchestration
 - No natural language ambiguity
 
 See [references/gemini-cli-integration.md](references/gemini-cli-integration.md) for complete guide.
 
-### Pattern 2: Subagent-Based Execution (Fallback)
+### Pattern 2: Task Agent-Based Execution (Fallback)
 
-Use `mcp-manager` agent when Gemini CLI unavailable. Subagent discovers tools, selects relevant ones, executes tasks, reports back.
+Use `mcp-manager` agent when Gemini CLI unavailable. Task agent discovers tools, selects relevant ones, executes tasks, reports back.
 
 **Benefit**: Main context stays clean, only relevant tool definitions loaded when needed.
 
@@ -166,7 +166,7 @@ npx tsx cli.ts list-tools  # Saves to assets/tools.json
 npx tsx cli.ts call-tool memory create_entities '{"entities":[...]}'
 ```
 
-**Method 3: mcp-manager Subagent**
+**Method 3: mcp-manager Task agent**
 
 See [references/gemini-cli-integration.md](references/gemini-cli-integration.md) for complete guide.
 
@@ -193,7 +193,7 @@ See [references/mcp-protocol.md](references/mcp-protocol.md) for:
    - Use when: Need specific tool/server control
    - Execute: `npx tsx scripts/cli.ts call-tool <server> <tool> <args>`
 
-3. **mcp-manager Subagent** (Fallback): Context-efficient delegation
+3. **mcp-manager Task agent** (Fallback): Context-efficient delegation
    - Use when: Gemini unavailable or failed
    - Keeps main context clean
 

package/merged-commands/multi-agent-patterns.md

@@ -12,7 +12,7 @@ Master orchestrator, peer-to-peer, and hierarchical multi-agent architectures
 Use this skill when working with master orchestrator, peer-to-peer, and hierarchical multi-agent architectures.
 # Multi-Agent Architecture Patterns
 
-Multi-agent architectures distribute work across multiple language model instances, each with its own context window. When designed well, this distribution enables capabilities beyond single-agent limits. When designed poorly, it introduces coordination overhead that negates benefits. The critical insight is that sub-agents exist primarily to isolate context, not to anthropomorphize role division.
+Multi-agent architectures distribute work across multiple language model instances, each with its own context window. When designed well, this distribution enables capabilities beyond single-agent limits. When designed poorly, it introduces coordination overhead that negates benefits. The critical insight is that Task agents exist primarily to isolate context, not to anthropomorphize role division.
 
 ## When to Activate
 
@@ -26,7 +26,7 @@ Activate this skill when:
 
 ## Core Concepts
 
-Multi-agent systems address single-agent context limitations through distribution. Three dominant patterns exist: supervisor/orchestrator for centralized control, peer-to-peer/swarm for flexible handoffs, and hierarchical for layered abstraction. The critical design principle is context isolation—sub-agents exist primarily to partition context rather than to simulate organizational roles.
+Multi-agent systems address single-agent context limitations through distribution. Three dominant patterns exist: supervisor/orchestrator for centralized control, peer-to-peer/swarm for flexible handoffs, and hierarchical for layered abstraction. The critical design principle is context isolation—Task agents exist primarily to partition context rather than to simulate organizational roles.
 
 Effective multi-agent systems require explicit coordination protocols, consensus mechanisms that avoid sycophancy, and careful attention to failure modes including bottlenecks, divergence, and error propagation.
 
@@ -75,20 +75,20 @@ When to use: Complex tasks with clear decomposition, tasks requiring coordinatio
 
 Advantages: Strict control over workflow, easier to implement human-in-the-loop interventions, ensures adherence to predefined plans.
 
-Disadvantages: Supervisor context becomes bottleneck, supervisor failures cascade to all workers, "telephone game" problem where supervisors paraphrase sub-agent responses incorrectly.
+Disadvantages: Supervisor context becomes bottleneck, supervisor failures cascade to all workers, "telephone game" problem where supervisors paraphrase Task agent responses incorrectly.
 
 **The Telephone Game Problem and Solution**
-LangGraph benchmarks found supervisor architectures initially performed 50% worse than optimized versions due to the "telephone game" problem where supervisors paraphrase sub-agent responses incorrectly, losing fidelity.
+LangGraph benchmarks found supervisor architectures initially performed 50% worse than optimized versions due to the "telephone game" problem where supervisors paraphrase Task agent responses incorrectly, losing fidelity.
 
-The fix: implement a `forward_message` tool allowing sub-agents to pass responses directly to users:
+The fix: implement a `forward_message` tool allowing Task agents to pass responses directly to users:
 
 ```python
 def forward_message(message: str, to_user: bool = True):
     """
-    Forward sub-agent response directly to user without supervisor synthesis.
-    
+    Forward Task agent response directly to user without supervisor synthesis.
+
     Use when:
-    - Sub-agent response is final and complete
+    - Task agent response is final and complete
     - Supervisor synthesis would lose important details
     - Response format must be preserved exactly
     """
@@ -97,9 +97,9 @@ def forward_message(message: str, to_user: bool = True):
     return {"type": "supervisor_input", "content": message}
 ```
 
-With this pattern, swarm architectures slightly outperform supervisors because sub-agents respond directly to users, eliminating translation errors.
+With this pattern, swarm architectures slightly outperform supervisors because Task agents respond directly to users, eliminating translation errors.
 
-Implementation note: Implement direct pass-through mechanisms allowing sub-agents to pass responses directly to users rather than through supervisor synthesis when appropriate.
+Implementation note: Implement direct pass-through mechanisms allowing Task agents to pass responses directly to users rather than through supervisor synthesis when appropriate.
 
 **Pattern 2: Peer-to-Peer/Swarm**
 The peer-to-peer pattern removes central control, allowing agents to communicate directly based on predefined protocols. Any agent can transfer control to any other through explicit handoff mechanisms.
@@ -137,17 +137,17 @@ Disadvantages: Coordination overhead between layers, potential for misalignment
 
 ### Context Isolation as Design Principle
 
-The primary purpose of multi-agent architectures is context isolation. Each sub-agent operates in a clean context window focused on its subtask without carrying accumulated context from other subtasks.
+The primary purpose of multi-agent architectures is context isolation. Each Task agent operates in a clean context window focused on its subtask without carrying accumulated context from other subtasks.
 
 **Isolation Mechanisms**
-Full context delegation: For complex tasks where the sub-agent needs complete understanding, the planner shares its entire context. The sub-agent has its own tools and instructions but receives full context for its decisions.
+Full context delegation: For complex tasks where the Task agent needs complete understanding, the planner shares its entire context. The Task agent has its own tools and instructions but receives full context for its decisions.
 
-Instruction passing: For simple, well-defined subtasks, the planner creates instructions via function call. The sub-agent receives only the instructions needed for its specific task.
+Instruction passing: For simple, well-defined subtasks, the planner creates instructions via function call. The Task agent receives only the instructions needed for its specific task.
 
 File system memory: For complex tasks requiring shared state, agents read and write to persistent storage. The file system serves as the coordination mechanism, avoiding context bloat from shared state passing.
 
 **Isolation Trade-offs**
-Full context delegation provides maximum capability but defeats the purpose of sub-agents. Instruction passing maintains isolation but limits sub-agent flexibility. File system memory enables shared state without context passing but introduces latency and consistency challenges.
+Full context delegation provides maximum capability but defeats the purpose of Task agents. Instruction passing maintains isolation but limits Task agent flexibility. File system memory enables shared state without context passing but introduces latency and consistency challenges.
 
 The right choice depends on task complexity, coordination needs, and acceptable latency.
 

package/merged-commands/multi-platform-apps-multi-platform.md

@@ -31,7 +31,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
 ## Phase 1: Architecture and API Design (Sequential)
 
 ### 1. Define Feature Requirements and API Contracts
-- Use Task tool with subagent_type="backend-architect"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Design the API contract for feature: $ARGUMENTS. Create OpenAPI 3.1 specification with:
   - RESTful endpoints with proper HTTP methods and status codes
   - GraphQL schema if applicable for complex data queries
@@ -44,7 +44,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
 - Expected output: Complete API specification, data models, and integration guidelines
 
 ### 2. Design System and UI/UX Consistency
-- Use Task tool with subagent_type="ui-ux-designer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Create cross-platform design system for feature using API spec: [previous output]. Include:
   - Component specifications for each platform (Material Design, iOS HIG, Fluent)
   - Responsive layouts for web (mobile-first approach)
@@ -57,7 +57,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
 - Expected output: Design system documentation, component library specs, platform guidelines
 
 ### 3. Shared Business Logic Architecture
-- Use Task tool with subagent_type="comprehensive-review::architect-review"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Design shared business logic architecture for cross-platform feature. Define:
   - Core domain models and entities (platform-agnostic)
   - Business rules and validation logic
@@ -72,7 +72,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
 ## Phase 2: Parallel Platform Implementation
 
 ### 4a. Web Implementation (React/Next.js)
-- Use Task tool with subagent_type="frontend-developer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Implement web version of feature using:
   - React 18+ with Next.js 14+ App Router
   - TypeScript for type safety
@@ -87,7 +87,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
 - Expected output: Complete web implementation with tests
 
 ### 4b. iOS Implementation (SwiftUI)
-- Use Task tool with subagent_type="ios-developer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Implement iOS version using:
   - SwiftUI with iOS 17+ features
   - Swift 5.9+ with async/await
@@ -102,7 +102,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
 - Expected output: Native iOS implementation with unit/UI tests
 
 ### 4c. Android Implementation (Kotlin/Compose)
-- Use Task tool with subagent_type="mobile-developer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Implement Android version using:
   - Jetpack Compose with Material 3
   - Kotlin coroutines and Flow
@@ -117,7 +117,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
 - Expected output: Native Android implementation with tests
 
 ### 4d. Desktop Implementation (Optional - Electron/Tauri)
-- Use Task tool with subagent_type="frontend-mobile-development::frontend-developer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Implement desktop version using Tauri 2.0 or Electron with:
   - Shared web codebase where possible
   - Native OS integration (system tray, notifications)
@@ -133,7 +133,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
 ## Phase 3: Integration and Validation
 
 ### 5. API Documentation and Testing
-- Use Task tool with subagent_type="documentation-generation::api-documenter"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Create comprehensive API documentation including:
   - Interactive OpenAPI/Swagger documentation
   - Platform-specific integration guides
@@ -149,7 +149,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
 - Expected output: Complete API documentation portal, test results
 
 ### 6. Cross-Platform Testing and Feature Parity
-- Use Task tool with subagent_type="unit-testing::test-automator"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Validate feature parity across all platforms:
   - Functional testing matrix (features work identically)
   - UI consistency verification (follows design system)
@@ -164,7 +164,7 @@ Build and deploy the same feature consistently across web, mobile, and desktop p
 - Expected output: Test report, parity matrix, performance metrics
 
 ### 7. Platform-Specific Optimizations
-- Use Task tool with subagent_type="application-performance::performance-engineer"
+- Use Task tool with subagent_type="general-purpose"
 - Prompt: "Optimize each platform implementation:
   - Web: Bundle size, lazy loading, CDN setup, SEO
   - iOS: App size, launch time, memory usage, battery

package/merged-commands/nestjs-expert.md

@@ -20,7 +20,7 @@ You are an expert in Nest.js with deep knowledge of enterprise-grade Node.js app
    - Node.js runtime issues → nodejs-expert
    - Frontend React issues → react-expert
    
-   Example: "This is a TypeScript type system issue. Use the typescript-type-expert subagent. Stopping here."
+   Example: "This is a TypeScript type system issue. Use the typescript-type-expert Task agent. Stopping here."
 
 1. Detect Nest.js project setup using internal tools first (Read, Grep, Glob)
 2. Identify architecture patterns and existing modules

package/merged-commands/performance-testing-review-multi-agent-review.md

@@ -59,7 +59,7 @@ The Multi-Agent Review Tool leverages a distributed, specialized agent network t
 - **Dynamic Agent Matching**:
   - Analyze input characteristics
   - Select most appropriate agent types
-  - Configure specialized sub-agents dynamically
+  - Configure specialized Task agents dynamically
 - **Expertise Routing**:
   ```python
   def route_agents(code_context):

package/merged-commands/plan/archive.md

@@ -23,7 +23,7 @@ Use `AskUserQuestion` tool to ask if user wants to document journal entries or n
 Skip this step if user selects "No".
 If user selects "Yes":
 - Analyze the information in previous steps.
-- Use Task tool with `subagent_type="journal-writer"` in parallel to document all plans.
+- Use Task tool with `subagent_type="general-purpose"` in parallel to document all plans: Task(subagent_type="general-purpose", prompt="You are a journal-writer. Document these plans...", description="Write journal entries")
 - Journal entries should be concise and focused on the most important events, key changes, impacts, and decisions.
 - Keep journal entries in the `./docs/journals/` directory.
 

package/merged-commands/plan/ci.md

@@ -8,7 +8,7 @@ Activate `planning` skill.
 ## Github Actions URL
  $ARGUMENTS
 
-Use the `planner` subagent to read the github actions logs, analyze and find the root causes of the issues, then provide a detailed plan for implementing the fixes.
+Use a Task agent for planning to read the github actions logs, analyze and find the root causes of the issues, then provide a detailed plan for implementing the fixes: Task(subagent_type="general-purpose", prompt="You are a planner. Read github actions logs, analyze root causes, create fix plan...", description="Analyze CI logs and plan fixes")
 
 **Plan File Specification:**
 - Every `plan.md` MUST start with YAML frontmatter:

package/merged-commands/plan/fast.md

@@ -19,10 +19,10 @@ Check the `## Plan Context` section in the injected context:
 - If "Plan: none" → Create new plan using naming from `## Naming` section.
 
 ## Workflow
-Use `planner` subagent to:
+Use Task agent for planning: Task(subagent_type="general-purpose", prompt="You are a planner. Create implementation plan...", description="Create plan") to:
 1. If creating new: Create directory using `Plan dir:` from `## Naming` section, then run `node .claude/scripts/set-active-plan.cjs {plan-dir}`
    If reusing: Use the active plan path from Plan Context.
-   Make sure you pass the directory path to every subagent during the process.
+   Make sure you pass the directory path to every Task agent during the process.
 2. Follow strictly to the "Plan Creation & Organization" rules of `planning` skill.
 3. Analyze the codebase by reading `codebase-summary.md`, `code-standards.md`, `system-architecture.md` and `project-overview-pdr.md` file.
 4. Gathers all information and create an implementation plan of this task.

package/merged-commands/plan/hard.md

@@ -21,14 +21,14 @@ Check the `## Plan Context` section in the injected context:
 ## Workflow
 1. If creating new: Create directory using `Plan dir:` from `## Naming` section, then run `node .claude/scripts/set-active-plan.cjs {plan-dir}`
    If reusing: Use the active plan path from Plan Context.
-   Make sure you pass the directory path to every subagent during the process.
+   Make sure you pass the directory path to every Task agent during the process.
 2. Follow strictly to the "Plan Creation & Organization" rules of `planning` skill.
-3. Use multiple `researcher` agents (max 2 agents) in parallel to research for this task:
+3. Use multiple Task agents for research (max 2 agents) in parallel to research for this task: Task(subagent_type="general-purpose", prompt="You are a researcher. Research [aspect]...", description="Research [topic]")
    Each agent research for a different aspect of the task and are allowed to perform max 5 tool calls.
 4. Analyze the codebase by reading `codebase-summary.md`, `code-standards.md`, `system-architecture.md` and `project-overview-pdr.md` file.
    **ONLY PERFORM THIS FOLLOWING STEP IF `codebase-summary.md` is not available or older than 3 days**: Use `/scout <instructions>` slash command to search the codebase for files needed to complete the task.
-5. Main agent gathers all research and scout report filepaths, and pass them to `planner` subagent with the prompt to create an implementation plan of this task.
-6. Main agent receives the implementation plan from `planner` subagent, and ask user to review the plan
+5. Main agent gathers all research and scout report filepaths, and pass them to Task agent for planning with the prompt to create an implementation plan of this task: Task(subagent_type="general-purpose", prompt="You are a planner. Create implementation plan based on research and scout reports...", description="Create implementation plan")
+6. Main agent receives the implementation plan from Task agent, and ask user to review the plan
 
 ## Post-Plan Validation (Optional)