Fix duplicate agent name collisions (#554)

* fix: namespace duplicate agent names

* fix: format duplicate-name regression test

* fix: align command phase output references

* docs: clarify agent naming formula
This commit is contained in:
Seth Hobson
2026-05-24 19:55:35 -04:00
committed by GitHub
parent 9834a5f38d
commit 8df77ecd46
114 changed files with 218 additions and 154 deletions
+2 -2
View File
@@ -102,8 +102,8 @@ jobs:
print(f"OK: {len(mp.get('plugins', []))} marketplace entries validated")
PY
- name: Check agent name collision baseline
run: python3 tools/check_agent_name_collisions.py --max-duplicate-names 30 --max-colliding-files 95
- name: Check agent name uniqueness
run: python3 tools/check_agent_name_collisions.py --fail-on-duplicates
plugin-eval-tests:
name: plugin-eval pytest
+10
View File
@@ -72,6 +72,16 @@ Link from `SKILL.md` like ``See `references/details.md` for the full algorithm.`
link target as backticked path text so the gardener's dead-link checker doesn't false-positive
on illustrative examples.
### Use globally unique agent names
Claude Code keys installed agents by the YAML frontmatter `name`, so two plugins that
ship the same agent name can silently overwrite each other when installed together. Use
plugin-scoped names for common roles using `<plugin-directory>-<agent-file-stem>`
(`backend-development-test-automator`, not `test-automator`) and update any bundled
command `subagent_type` references to match.
CI runs `tools/check_agent_name_collisions.py --fail-on-duplicates` to keep the source
tree collision-free.
### Don't collide with Codex built-in agent names
`default`, `worker`, and `explorer` are built-in Codex subagent roles. If you name a custom
@@ -1,5 +1,5 @@
---
name: context-manager
name: agent-orchestration-context-manager
description: Elite AI context engineering specialist mastering dynamic context management, vector databases, knowledge graphs, and intelligent memory systems. Orchestrates context across multi-agent workflows, enterprise AI systems, and long-running projects with 2024/2025 best practices. Use PROACTIVELY for complex AI orchestration.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: backend-architect
name: api-scaffolding-backend-architect
description: Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems. Masters REST/GraphQL/gRPC APIs, event-driven architectures, service mesh patterns, and modern backend frameworks. Handles service boundary definition, inter-service communication, resilience patterns, and observability. Use PROACTIVELY when creating new backend services or APIs.
model: inherit
---
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: django-pro
name: api-scaffolding-django-pro
description: Master Django 5.x with async views, DRF, Celery, and Django Channels. Build scalable web applications with proper architecture, testing, and deployment. Use PROACTIVELY for Django development, ORM optimization, or complex Django patterns.
model: opus
---
@@ -1,5 +1,5 @@
---
name: fastapi-pro
name: api-scaffolding-fastapi-pro
description: Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async patterns. Use PROACTIVELY for FastAPI development, async optimization, or API architecture.
model: opus
---
@@ -1,5 +1,5 @@
---
name: graphql-architect
name: api-scaffolding-graphql-architect
description: Master modern GraphQL with federation, performance optimization, and enterprise security. Build scalable schemas, implement advanced caching, and design real-time systems. Use PROACTIVELY for GraphQL architecture or performance optimization.
model: opus
---
@@ -1,5 +1,5 @@
---
name: api-documenter
name: api-testing-observability-api-documenter
description: Master API documentation with OpenAPI 3.1, AI-powered tools, and modern developer experience practices. Create interactive docs, generate SDKs, and build comprehensive developer portals. Use PROACTIVELY for API documentation or developer portal creation.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: frontend-developer
name: application-performance-frontend-developer
description: Build React components, implement responsive layouts, and handle client-side state management. Masters React 19, Next.js 15, and modern frontend architecture. Optimizes performance and ensures accessibility. Use PROACTIVELY when creating UI components or fixing frontend issues.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: observability-engineer
name: application-performance-observability-engineer
description: Build production-ready monitoring, logging, and tracing systems. Implements comprehensive observability strategies, SLI/SLO management, and incident response workflows. Use PROACTIVELY for monitoring infrastructure, performance optimization, or production reliability.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: performance-engineer
name: application-performance-performance-engineer
description: Expert performance engineer specializing in modern observability, application optimization, and scalable system performance. Masters OpenTelemetry, distributed tracing, load testing, multi-tier caching, Core Web Vitals, and performance monitoring. Handles end-to-end optimization, real user monitoring, and scalability patterns. Use PROACTIVELY for performance optimization, observability, or scalability challenges.
model: inherit
---
@@ -72,7 +72,7 @@ Use the Task tool to launch the performance engineer:
```
Task:
subagent_type: "performance-engineer"
subagent_type: "application-performance-performance-engineer"
description: "Profile application performance for $TARGET"
prompt: |
Profile application performance comprehensively for: $TARGET.
@@ -104,7 +104,7 @@ Use the Task tool:
```
Task:
subagent_type: "observability-engineer"
subagent_type: "application-performance-observability-engineer"
description: "Assess observability setup for $TARGET"
prompt: |
Assess current observability setup for: $TARGET.
@@ -138,7 +138,7 @@ Use the Task tool:
```
Task:
subagent_type: "performance-engineer"
subagent_type: "application-performance-performance-engineer"
description: "Analyze user experience metrics for $TARGET"
prompt: |
Analyze user experience metrics for: $TARGET.
@@ -275,7 +275,7 @@ Use the Task tool:
```
Task:
subagent_type: "performance-engineer"
subagent_type: "application-performance-performance-engineer"
description: "Optimize distributed system performance for $TARGET"
prompt: |
Optimize distributed system performance for: $TARGET.
@@ -335,7 +335,7 @@ Use the Task tool:
```
Task:
subagent_type: "frontend-developer"
subagent_type: "application-performance-frontend-developer"
description: "Optimize frontend performance for $TARGET"
prompt: |
Optimize frontend performance for: $TARGET targeting Core Web Vitals improvements.
@@ -469,7 +469,7 @@ Use the Task tool:
```
Task:
subagent_type: "performance-engineer"
subagent_type: "application-performance-performance-engineer"
description: "Conduct comprehensive load testing for $TARGET"
prompt: |
Conduct comprehensive load testing for: $TARGET using k6/Gatling/Artillery.
@@ -565,7 +565,7 @@ Use the Task tool:
```
Task:
subagent_type: "observability-engineer"
subagent_type: "application-performance-observability-engineer"
description: "Implement production performance monitoring for $TARGET"
prompt: |
Implement production performance monitoring for: $TARGET.
@@ -603,7 +603,7 @@ Use the Task tool:
```
Task:
subagent_type: "performance-engineer"
subagent_type: "application-performance-performance-engineer"
description: "Establish continuous optimization process for $TARGET"
prompt: |
Establish continuous optimization process for: $TARGET.
@@ -1,5 +1,5 @@
---
name: backend-architect
name: backend-api-security-backend-architect
description: Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems. Masters REST/GraphQL/gRPC APIs, event-driven architectures, service mesh patterns, and modern backend frameworks. Handles service boundary definition, inter-service communication, resilience patterns, and observability. Use PROACTIVELY when creating new backend services or APIs.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: backend-security-coder
name: backend-api-security-backend-security-coder
description: Expert in secure backend coding practices specializing in input validation, authentication, and API security. Use PROACTIVELY for backend security implementations or security code reviews.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: backend-architect
name: backend-development-backend-architect
description: Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems. Masters REST/GraphQL/gRPC APIs, event-driven architectures, service mesh patterns, and modern backend frameworks. Handles service boundary definition, inter-service communication, resilience patterns, and observability. Use PROACTIVELY when creating new backend services or APIs.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: graphql-architect
name: backend-development-graphql-architect
description: Master modern GraphQL with federation, performance optimization, and enterprise security. Build scalable schemas, implement advanced caching, and design real-time systems. Use PROACTIVELY for GraphQL architecture or performance optimization.
model: opus
---
@@ -1,5 +1,5 @@
---
name: performance-engineer
name: backend-development-performance-engineer
description: Profile and optimize application performance including response times, memory usage, query efficiency, and scalability. Use for performance review during feature development.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: security-auditor
name: backend-development-security-auditor
description: Review code and architecture for security vulnerabilities, OWASP Top 10, auth flaws, and compliance issues. Use for security review during feature development.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: tdd-orchestrator
name: backend-development-tdd-orchestrator
description: Master TDD orchestrator specializing in red-green-refactor discipline, multi-agent workflow coordination, and comprehensive test-driven development practices. Enforces TDD best practices across teams with AI-assisted testing and modern frameworks. Use PROACTIVELY for TDD implementation and governance.
model: opus
---
@@ -1,5 +1,5 @@
---
name: test-automator
name: backend-development-test-automator
description: Create comprehensive test suites including unit, integration, and E2E tests. Supports TDD/BDD workflows. Use for test creation during feature development.
model: sonnet
---
@@ -126,7 +126,7 @@ Use the Task tool to launch the architecture agent:
```
Task:
subagent_type: "backend-architect"
subagent_type: "backend-development-backend-architect"
description: "Design architecture for $FEATURE"
prompt: |
Design the technical architecture for this feature.
@@ -179,7 +179,7 @@ Use the Task tool to launch the backend architect for implementation:
```
Task:
subagent_type: "backend-architect"
subagent_type: "backend-development-backend-architect"
description: "Implement backend for $FEATURE"
prompt: |
Implement the backend for this feature based on the approved architecture.
@@ -253,7 +253,7 @@ Launch three agents in parallel using multiple Task tool calls in a single respo
```
Task:
subagent_type: "test-automator"
subagent_type: "backend-development-test-automator"
description: "Create test suite for $FEATURE"
prompt: |
Create a comprehensive test suite for this feature.
@@ -280,7 +280,7 @@ Task:
```
Task:
subagent_type: "security-auditor"
subagent_type: "backend-development-security-auditor"
description: "Security review of $FEATURE"
prompt: |
Perform a security review of this feature implementation.
@@ -304,7 +304,7 @@ Task:
```
Task:
subagent_type: "performance-engineer"
subagent_type: "backend-development-performance-engineer"
description: "Performance review of $FEATURE"
prompt: |
Review the performance of this feature implementation.
@@ -1,5 +1,5 @@
---
name: cloud-architect
name: cicd-automation-cloud-architect
description: Expert cloud architect specializing in AWS/Azure/GCP/OCI multi-cloud infrastructure design, advanced IaC (Terraform/OpenTofu/CDK), FinOps cost optimization, and modern architectural patterns. Masters serverless, microservices, security, compliance, and disaster recovery. Use PROACTIVELY for cloud architecture, cost optimization, migration planning, or multi-cloud strategies.
model: opus
---
@@ -1,5 +1,5 @@
---
name: deployment-engineer
name: cicd-automation-deployment-engineer
description: Expert deployment engineer specializing in modern CI/CD pipelines, GitOps workflows, and advanced deployment automation. Masters GitHub Actions, ArgoCD/Flux, progressive delivery, container security, and platform engineering. Handles zero-downtime deployments, security scanning, and developer experience optimization. Use PROACTIVELY for CI/CD design, GitOps implementation, or deployment automation.
model: haiku
---
@@ -1,5 +1,5 @@
---
name: devops-troubleshooter
name: cicd-automation-devops-troubleshooter
description: Expert DevOps troubleshooter specializing in rapid incident response, advanced debugging, and modern observability. Masters log analysis, distributed tracing, Kubernetes debugging, performance optimization, and root cause analysis. Handles production outages, system reliability, and preventive monitoring. Use PROACTIVELY for debugging, incident response, or system troubleshooting.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: kubernetes-architect
name: cicd-automation-kubernetes-architect
description: Expert Kubernetes architect specializing in cloud-native infrastructure, advanced GitOps workflows (ArgoCD/Flux), and enterprise container orchestration. Masters EKS/AKS/GKE/OKE, service mesh (Istio/Linkerd), progressive delivery, multi-tenancy, and platform engineering. Handles security, observability, cost optimization, and developer experience. Use PROACTIVELY for K8s architecture, GitOps implementation, or cloud-native platform design.
model: opus
---
@@ -1,5 +1,5 @@
---
name: terraform-specialist
name: cicd-automation-terraform-specialist
description: Expert Terraform/OpenTofu specialist mastering advanced IaC automation, state management, and enterprise infrastructure patterns. Handles complex module design, multi-cloud deployments, GitOps workflows, policy as code, and CI/CD integration. Covers migration strategies, security best practices, and modern IaC ecosystems. Use PROACTIVELY for advanced IaC, state management, or infrastructure automation.
model: opus
---
@@ -1,5 +1,5 @@
---
name: cloud-architect
name: cloud-infrastructure-cloud-architect
description: Expert cloud architect specializing in AWS/Azure/GCP/OCI multi-cloud infrastructure design, advanced IaC (Terraform/OpenTofu/CDK), FinOps cost optimization, and modern architectural patterns. Masters serverless, microservices, security, compliance, and disaster recovery. Use PROACTIVELY for cloud architecture, cost optimization, migration planning, or multi-cloud strategies.
model: opus
---
@@ -1,5 +1,5 @@
---
name: deployment-engineer
name: cloud-infrastructure-deployment-engineer
description: Expert deployment engineer specializing in modern CI/CD pipelines, GitOps workflows, and advanced deployment automation. Masters GitHub Actions, ArgoCD/Flux, progressive delivery, container security, and platform engineering. Handles zero-downtime deployments, security scanning, and developer experience optimization. Use PROACTIVELY for CI/CD design, GitOps implementation, or deployment automation.
model: haiku
---
@@ -1,5 +1,5 @@
---
name: kubernetes-architect
name: cloud-infrastructure-kubernetes-architect
description: Expert Kubernetes architect specializing in cloud-native infrastructure, advanced GitOps workflows (ArgoCD/Flux), and enterprise container orchestration. Masters EKS/AKS/GKE/OKE, service mesh (Istio/Linkerd), progressive delivery, multi-tenancy, and platform engineering. Handles security, observability, cost optimization, and developer experience. Use PROACTIVELY for K8s architecture, GitOps implementation, or cloud-native platform design.
model: opus
---
@@ -1,5 +1,5 @@
---
name: network-engineer
name: cloud-infrastructure-network-engineer
description: Expert network engineer specializing in modern cloud networking, security architectures, and performance optimization. Masters multi-cloud connectivity, service mesh, zero-trust networking, SSL/TLS, global load balancing, and advanced troubleshooting. Handles CDN optimization, network automation, and compliance. Use PROACTIVELY for network design, connectivity issues, or performance optimization.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: terraform-specialist
name: cloud-infrastructure-terraform-specialist
description: Expert Terraform/OpenTofu specialist mastering advanced IaC automation, state management, and enterprise infrastructure patterns. Handles complex module design, multi-cloud deployments, GitOps workflows, policy as code, and CI/CD integration. Covers migration strategies, security best practices, and modern IaC ecosystems. Use PROACTIVELY for advanced IaC, state management, or infrastructure automation.
model: opus
---
@@ -1,5 +1,5 @@
---
name: code-reviewer
name: code-documentation-code-reviewer
description: Elite code review expert specializing in modern AI-powered code analysis, security vulnerabilities, performance optimization, and production reliability. Masters static analysis tools, security scanning, and configuration review with 2024/2025 best practices. Use PROACTIVELY for code quality assurance.
model: opus
---
@@ -1,5 +1,5 @@
---
name: docs-architect
name: code-documentation-docs-architect
description: Creates comprehensive technical documentation from existing codebases. Analyzes architecture, design patterns, and implementation details to produce long-form technical manuals and ebooks. Use PROACTIVELY for system documentation, architecture guides, or technical deep-dives.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: tutorial-engineer
name: code-documentation-tutorial-engineer
description: Creates step-by-step tutorials and educational content from code. Transforms complex concepts into progressive learning experiences with hands-on examples. Use PROACTIVELY for onboarding guides, feature tutorials, or concept explanations.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: code-reviewer
name: code-refactoring-code-reviewer
description: Elite code review expert specializing in modern AI-powered code analysis, security vulnerabilities, performance optimization, and production reliability. Masters static analysis tools, security scanning, and configuration review with 2024/2025 best practices. Use PROACTIVELY for code quality assurance.
model: opus
---
@@ -1,5 +1,5 @@
---
name: legacy-modernizer
name: code-refactoring-legacy-modernizer
description: Refactor legacy codebases, migrate outdated frameworks, and implement gradual modernization. Handles technical debt, dependency updates, and backward compatibility. Use PROACTIVELY for legacy system updates, framework migrations, or technical debt reduction.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: code-reviewer
name: codebase-cleanup-code-reviewer
description: Elite code review expert specializing in modern AI-powered code analysis, security vulnerabilities, performance optimization, and production reliability. Masters static analysis tools, security scanning, and configuration review with 2024/2025 best practices. Use PROACTIVELY for code quality assurance.
model: opus
---
@@ -1,5 +1,5 @@
---
name: test-automator
name: codebase-cleanup-test-automator
description: Master AI-powered test automation with modern frameworks, self-healing tests, and comprehensive quality engineering. Build scalable testing strategies with advanced CI/CD integration. Use PROACTIVELY for testing automation or quality assurance.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: architect-review
name: comprehensive-review-architect-review
description: Master software architect specializing in modern architecture patterns, clean architecture, microservices, event-driven systems, and DDD. Reviews system designs and code changes for architectural integrity, scalability, and maintainability. Use PROACTIVELY for architectural decisions.
model: opus
---
@@ -1,5 +1,5 @@
---
name: code-reviewer
name: comprehensive-review-code-reviewer
description: Elite code review expert specializing in modern AI-powered code analysis, security vulnerabilities, performance optimization, and production reliability. Masters static analysis tools, security scanning, and configuration review with 2024/2025 best practices. Use PROACTIVELY for code quality assurance.
model: opus
---
@@ -1,5 +1,5 @@
---
name: security-auditor
name: comprehensive-review-security-auditor
description: Expert security auditor specializing in DevSecOps, comprehensive cybersecurity, and compliance frameworks. Masters vulnerability assessment, threat modeling, secure authentication (OAuth2/OIDC), OWASP standards, cloud security, and security automation. Handles DevSecOps integration, compliance (GDPR/HIPAA/SOC2), and incident response. Use PROACTIVELY for security audits, DevSecOps, or compliance implementation.
model: opus
---
@@ -111,7 +111,7 @@ Run both agents in parallel using multiple Task tool calls in a single response.
```
Task:
subagent_type: "code-reviewer"
subagent_type: "comprehensive-review-code-reviewer"
description: "Code quality analysis for $ARGUMENTS"
prompt: |
Perform a comprehensive code quality review.
@@ -141,7 +141,7 @@ Task:
```
Task:
subagent_type: "architect-review"
subagent_type: "comprehensive-review-architect-review"
description: "Architecture review for $ARGUMENTS"
prompt: |
Review the architectural design and structural integrity of the target code.
@@ -198,7 +198,7 @@ Run both agents in parallel using multiple Task tool calls in a single response.
```
Task:
subagent_type: "security-auditor"
subagent_type: "comprehensive-review-security-auditor"
description: "Security audit for $ARGUMENTS"
prompt: |
Execute a comprehensive security audit on the target code.
@@ -1,5 +1,5 @@
---
name: context-manager
name: context-management-context-manager
description: Elite AI context engineering specialist mastering dynamic context management, vector databases, knowledge graphs, and intelligent memory systems. Orchestrates context across multi-agent workflows, enterprise AI systems, and long-running projects with 2024/2025 best practices. Use PROACTIVELY for complex AI orchestration.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: backend-architect
name: data-engineering-backend-architect
description: Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems. Masters REST/GraphQL/gRPC APIs, event-driven architectures, service mesh patterns, and modern backend frameworks. Handles service boundary definition, inter-service communication, resilience patterns, and observability. Use PROACTIVELY when creating new backend services or APIs.
model: inherit
---
@@ -187,7 +187,7 @@ Use the Task tool:
```
Task:
subagent_type: "backend-architect"
subagent_type: "data-engineering-backend-architect"
description: "Design feature architecture for $FEATURE with A/B testing capability"
prompt: |
Design the feature architecture for: $FEATURE with A/B testing capability.
@@ -310,7 +310,7 @@ Use the Task tool:
```
Task:
subagent_type: "backend-architect"
subagent_type: "data-engineering-backend-architect"
description: "Implement backend for $FEATURE with full instrumentation"
prompt: |
Implement the backend for feature: $FEATURE with full instrumentation.
@@ -1,5 +1,5 @@
---
name: backend-security-coder
name: data-validation-suite-backend-security-coder
description: Expert in secure backend coding practices specializing in input validation, authentication, and API security. Use PROACTIVELY for backend security implementations or security code reviews.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: backend-architect
name: database-cloud-optimization-backend-architect
description: Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems. Masters REST/GraphQL/gRPC APIs, event-driven architectures, service mesh patterns, and modern backend frameworks. Handles service boundary definition, inter-service communication, resilience patterns, and observability. Use PROACTIVELY when creating new backend services or APIs.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: cloud-architect
name: database-cloud-optimization-cloud-architect
description: Expert cloud architect specializing in AWS/Azure/GCP/OCI multi-cloud infrastructure design, advanced IaC (Terraform/OpenTofu/CDK), FinOps cost optimization, and modern architectural patterns. Masters serverless, microservices, security, compliance, and disaster recovery. Use PROACTIVELY for cloud architecture, cost optimization, migration planning, or multi-cloud strategies.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: database-architect
name: database-cloud-optimization-database-architect
description: Expert database architect specializing in data layer design from scratch, technology selection, schema modeling, and scalable database architectures. Masters SQL/NoSQL/TimeSeries database selection, normalization strategies, migration planning, and performance-first design. Handles both greenfield architectures and re-architecture of existing systems. Use PROACTIVELY for database architecture, technology selection, or data modeling decisions.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: database-optimizer
name: database-cloud-optimization-database-optimizer
description: Expert database optimizer specializing in modern performance tuning, query optimization, and scalable architectures. Masters advanced indexing, N+1 resolution, multi-tier caching, partitioning strategies, and cloud database optimization. Handles complex query analysis, migration strategies, and performance monitoring. Use PROACTIVELY for database optimization, performance issues, or scalability challenges.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: database-architect
name: database-design-database-architect
description: Expert database architect specializing in data layer design from scratch, technology selection, schema modeling, and scalable database architectures. Masters SQL/NoSQL/TimeSeries database selection, normalization strategies, migration planning, and performance-first design. Handles both greenfield architectures and re-architecture of existing systems. Use PROACTIVELY for database architecture, technology selection, or data modeling decisions.
model: opus
---
@@ -1,5 +1,5 @@
---
name: database-optimizer
name: database-migrations-database-optimizer
description: Expert database optimizer specializing in modern performance tuning, query optimization, and scalable architectures. Masters advanced indexing, N+1 resolution, multi-tier caching, partitioning strategies, and cloud database optimization. Handles complex query analysis, migration strategies, and performance monitoring. Use PROACTIVELY for database optimization, performance issues, or scalability challenges.
model: inherit
---
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: debugger
name: debugging-toolkit-debugger
description: Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: dx-optimizer
name: debugging-toolkit-dx-optimizer
description: Developer Experience specialist. Improves tooling, setup, and workflows. Use PROACTIVELY when setting up new projects, after team feedback, or when development friction is noticed.
model: sonnet
---
@@ -17,7 +17,7 @@ Parse for:
### 1. Initial Triage
Use Task tool (subagent_type="debugger") for AI-powered analysis:
Use Task tool (subagent_type="debugging-toolkit-debugger") for AI-powered analysis:
- Error pattern recognition
- Stack trace analysis with probable causes
@@ -1,5 +1,5 @@
---
name: legacy-modernizer
name: dependency-management-legacy-modernizer
description: Refactor legacy codebases, migrate outdated frameworks, and implement gradual modernization. Handles technical debt, dependency updates, and backward compatibility. Use PROACTIVELY for legacy system updates, framework migrations, or technical debt reduction.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: deployment-engineer
name: deployment-strategies-deployment-engineer
description: Expert deployment engineer specializing in modern CI/CD pipelines, GitOps workflows, and advanced deployment automation. Masters GitHub Actions, ArgoCD/Flux, progressive delivery, container security, and platform engineering. Handles zero-downtime deployments, security scanning, and developer experience optimization. Use PROACTIVELY for CI/CD design, GitOps implementation, or deployment automation.
model: haiku
---
@@ -1,5 +1,5 @@
---
name: terraform-specialist
name: deployment-strategies-terraform-specialist
description: Expert Terraform/OpenTofu specialist mastering advanced IaC automation, state management, and enterprise infrastructure patterns. Handles complex module design, multi-cloud deployments, GitOps workflows, policy as code, and CI/CD integration. Covers migration strategies, security best practices, and modern IaC ecosystems. Use PROACTIVELY for advanced IaC, state management, or infrastructure automation.
model: opus
---
@@ -1,5 +1,5 @@
---
name: cloud-architect
name: deployment-validation-cloud-architect
description: Expert cloud architect specializing in AWS/Azure/GCP/OCI multi-cloud infrastructure design, advanced IaC (Terraform/OpenTofu/CDK), FinOps cost optimization, and modern architectural patterns. Masters serverless, microservices, security, compliance, and disaster recovery. Use PROACTIVELY for cloud architecture, cost optimization, migration planning, or multi-cloud strategies.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: devops-troubleshooter
name: distributed-debugging-devops-troubleshooter
description: Expert DevOps troubleshooter specializing in rapid incident response, advanced debugging, and modern observability. Masters log analysis, distributed tracing, Kubernetes debugging, performance optimization, and root cause analysis. Handles production outages, system reliability, and preventive monitoring. Use PROACTIVELY for debugging, incident response, or system troubleshooting.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: error-detective
name: distributed-debugging-error-detective
description: Search logs and codebases for error patterns, stack traces, and anomalies. Correlates errors across systems and identifies root causes. Use PROACTIVELY when debugging issues, analyzing logs, or investigating production errors.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: api-documenter
name: documentation-generation-api-documenter
description: Master API documentation with OpenAPI 3.1, AI-powered tools, and modern developer experience practices. Create interactive docs, generate SDKs, and build comprehensive developer portals. Use PROACTIVELY for API documentation or developer portal creation.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: docs-architect
name: documentation-generation-docs-architect
description: Creates comprehensive technical documentation from existing codebases. Analyzes architecture, design patterns, and implementation details to produce long-form technical manuals and ebooks. Use PROACTIVELY for system documentation, architecture guides, or technical deep-dives.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: tutorial-engineer
name: documentation-generation-tutorial-engineer
description: Creates step-by-step tutorials and educational content from code. Transforms complex concepts into progressive learning experiences with hands-on examples. Use PROACTIVELY for onboarding guides, feature tutorials, or concept explanations.
model: sonnet
---
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: debugger
name: error-debugging-debugger
description: Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: error-detective
name: error-debugging-error-detective
description: Search logs and codebases for error patterns, stack traces, and anomalies. Correlates errors across systems and identifies root causes. Use PROACTIVELY when debugging issues, analyzing logs, or investigating production errors.
model: sonnet
---
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: debugger
name: error-diagnostics-debugger
description: Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: error-detective
name: error-diagnostics-error-detective
description: Search logs and codebases for error patterns, stack traces, and anomalies. Correlates errors across systems and identifies root causes. Use PROACTIVELY when debugging issues, analyzing logs, or investigating production errors.
model: sonnet
---
@@ -21,7 +21,7 @@ Parse for:
### 1. Initial Triage
Use Task tool (subagent_type="debugger") for AI-powered analysis:
Use Task tool (subagent_type="error-diagnostics-debugger") for AI-powered analysis:
- Error pattern recognition
- Stack trace analysis with probable causes
@@ -1,5 +1,5 @@
---
name: architect-review
name: framework-migration-architect-review
description: Master software architect specializing in modern architecture patterns, clean architecture, microservices, event-driven systems, and DDD. Reviews system designs and code changes for architectural integrity, scalability, and maintainability. Use PROACTIVELY for architectural decisions.
model: opus
---
@@ -1,5 +1,5 @@
---
name: legacy-modernizer
name: framework-migration-legacy-modernizer
description: Refactor legacy codebases, migrate outdated frameworks, and implement gradual modernization. Handles technical debt, dependency updates, and backward compatibility. Use PROACTIVELY for legacy system updates, framework migrations, or technical debt reduction.
model: sonnet
---
@@ -67,11 +67,11 @@ Extract the target description from `$ARGUMENTS` (everything before the flags).
### Step 1: Comprehensive Legacy System Analysis
Use the Task tool with subagent_type="legacy-modernizer":
Use the Task tool with subagent_type="framework-migration-legacy-modernizer":
```
Task:
subagent_type: "legacy-modernizer"
subagent_type: "framework-migration-legacy-modernizer"
description: "Analyze legacy codebase for modernization readiness"
prompt: |
Analyze the legacy codebase at $TARGET. Document a technical debt inventory including:
@@ -96,11 +96,11 @@ Update `state.json`: set `current_step` to 2, add `"01-legacy-assessment.md"` to
Read `.legacy-modernize/01-legacy-assessment.md` to load assessment context.
Use the Task tool with subagent_type="architect-review":
Use the Task tool with subagent_type="framework-migration-architect-review":
```
Task:
subagent_type: "architect-review"
subagent_type: "framework-migration-architect-review"
description: "Create dependency graph and integration point catalog"
prompt: |
Based on the legacy assessment report below, create a comprehensive dependency graph.
@@ -548,11 +548,11 @@ Do NOT proceed to Phase 5 until the user approves.
Read `.legacy-modernize/01-legacy-assessment.md`, `.legacy-modernize/08-first-wave.md`, and `.legacy-modernize/11-rollout.md`.
Use the Task tool with subagent_type="legacy-modernizer":
Use the Task tool with subagent_type="framework-migration-legacy-modernizer":
```
Task:
subagent_type: "legacy-modernizer"
subagent_type: "framework-migration-legacy-modernizer"
description: "Plan safe decommissioning of replaced legacy components"
prompt: |
Plan safe decommissioning of replaced legacy components.
@@ -1,5 +1,5 @@
---
name: frontend-developer
name: frontend-mobile-development-frontend-developer
description: Build React components, implement responsive layouts, and handle client-side state management. Masters React 19, Next.js 15, and modern frontend architecture. Optimizes performance and ensures accessibility. Use PROACTIVELY when creating UI components or fixing frontend issues.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: mobile-developer
name: frontend-mobile-development-mobile-developer
description: Develop React Native, Flutter, or native mobile apps with modern architecture patterns. Masters cross-platform development, native integrations, offline sync, and app store optimization. Use PROACTIVELY for mobile features, cross-platform code, or app optimization.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: frontend-developer
name: frontend-mobile-security-frontend-developer
description: Build React components, implement responsive layouts, and handle client-side state management. Masters React 19, Next.js 15, and modern frontend architecture. Optimizes performance and ensures accessibility. Use PROACTIVELY when creating UI components or fixing frontend issues.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: deployment-engineer
name: full-stack-orchestration-deployment-engineer
description: Expert deployment engineer specializing in modern CI/CD pipelines, GitOps workflows, and advanced deployment automation. Masters GitHub Actions, ArgoCD/Flux, progressive delivery, container security, and platform engineering. Handles zero-downtime deployments, security scanning, and developer experience optimization. Use PROACTIVELY for CI/CD design, GitOps implementation, or deployment automation.
model: haiku
---
@@ -1,5 +1,5 @@
---
name: performance-engineer
name: full-stack-orchestration-performance-engineer
description: Expert performance engineer specializing in modern observability, application optimization, and scalable system performance. Masters OpenTelemetry, distributed tracing, load testing, multi-tier caching, Core Web Vitals, and performance monitoring. Handles end-to-end optimization, real user monitoring, and scalability patterns. Use PROACTIVELY for performance optimization, observability, or scalability challenges.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: security-auditor
name: full-stack-orchestration-security-auditor
description: Expert security auditor specializing in DevSecOps, comprehensive cybersecurity, and compliance frameworks. Masters vulnerability assessment, threat modeling, secure authentication (OAuth2/OIDC), OWASP standards, cloud security, and security automation. Handles DevSecOps integration, compliance (GDPR/HIPAA/SOC2), and incident response. Use PROACTIVELY for security audits, DevSecOps, or compliance implementation.
model: opus
---
@@ -1,5 +1,5 @@
---
name: test-automator
name: full-stack-orchestration-test-automator
description: Master AI-powered test automation with modern frameworks, self-healing tests, and comprehensive quality engineering. Build scalable testing strategies with advanced CI/CD integration. Use PROACTIVELY for testing automation or quality assurance.
model: sonnet
---
@@ -348,7 +348,7 @@ Launch three agents in parallel using multiple Task tool calls in a single respo
```
Task:
subagent_type: "test-automator"
subagent_type: "full-stack-orchestration-test-automator"
description: "Create test suite for $FEATURE"
prompt: |
Create a comprehensive test suite for this full-stack feature.
@@ -379,7 +379,7 @@ Task:
```
Task:
subagent_type: "security-auditor"
subagent_type: "full-stack-orchestration-security-auditor"
description: "Security review of $FEATURE"
prompt: |
Perform a security review of this full-stack feature implementation.
@@ -407,7 +407,7 @@ Task:
```
Task:
subagent_type: "performance-engineer"
subagent_type: "full-stack-orchestration-performance-engineer"
description: "Performance review of $FEATURE"
prompt: |
Review the performance of this full-stack feature implementation.
@@ -489,7 +489,7 @@ Use the Task tool:
```
Task:
subagent_type: "deployment-engineer"
subagent_type: "full-stack-orchestration-deployment-engineer"
description: "Create deployment config for $FEATURE"
prompt: |
Create the deployment and infrastructure configuration for this full-stack feature.
@@ -1,5 +1,5 @@
---
name: code-reviewer
name: git-pr-workflows-code-reviewer
description: Elite code review expert specializing in modern AI-powered code analysis, security vulnerabilities, performance optimization, and production reliability. Masters static analysis tools, security scanning, and configuration review with 2024/2025 best practices. Use PROACTIVELY for code quality assurance.
model: opus
---
@@ -88,7 +88,7 @@ Use the Task tool to launch the code reviewer:
```
Task:
subagent_type: "code-reviewer"
subagent_type: "git-pr-workflows-code-reviewer"
description: "Review uncommitted changes for code quality"
prompt: |
Review all uncommitted changes for code quality issues.
@@ -127,7 +127,7 @@ Use the Task tool:
```
Task:
subagent_type: "code-reviewer"
subagent_type: "git-pr-workflows-code-reviewer"
description: "Analyze changes for dependencies and breaking changes"
prompt: |
Analyze the changes for dependency and breaking change issues.
@@ -305,7 +305,7 @@ Use the Task tool:
```
Task:
subagent_type: "code-reviewer"
subagent_type: "git-pr-workflows-code-reviewer"
description: "Categorize changes for commit message"
prompt: |
Analyze all changes and categorize them according to Conventional Commits specification.
@@ -1,5 +1,5 @@
---
name: code-reviewer
name: incident-response-code-reviewer
description: Reviews code for logic flaws, type safety gaps, error handling issues, architectural concerns, and similar vulnerability patterns. Provides fix design recommendations.
model: sonnet
---
+1 -1
View File
@@ -1,5 +1,5 @@
---
name: debugger
name: incident-response-debugger
description: Performs deep root cause analysis through code path tracing, git bisect automation, dependency analysis, and systematic hypothesis testing for production bugs.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: devops-troubleshooter
name: incident-response-devops-troubleshooter
description: Expert DevOps troubleshooter specializing in rapid incident response, advanced debugging, and modern observability. Masters log analysis, distributed tracing, Kubernetes debugging, performance optimization, and root cause analysis. Handles production outages, system reliability, and preventive monitoring. Use PROACTIVELY for debugging, incident response, or system troubleshooting.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: error-detective
name: incident-response-error-detective
description: Analyzes error traces, logs, and observability data to identify error signatures, reproduction steps, user impact, and timeline context for production issues.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: test-automator
name: incident-response-test-automator
description: Creates comprehensive test suites including unit, integration, regression, and security tests. Validates fixes with full coverage and cross-environment testing.
model: sonnet
---
@@ -188,7 +188,7 @@ Read `.incident-response/02-observability.md` and `.incident-response/03-mitigat
```
Task:
subagent_type: "debugger"
subagent_type: "incident-response-debugger"
description: "Deep debugging for: $INCIDENT"
prompt: |
Conduct deep debugging for this incident using observability data.
@@ -350,7 +350,7 @@ Read `.incident-response/06-fix.md`.
```
Task:
subagent_type: "devops-troubleshooter"
subagent_type: "incident-response-devops-troubleshooter"
description: "Deploy and validate fix for: $INCIDENT"
prompt: |
Execute emergency deployment for incident fix.
@@ -72,7 +72,7 @@ Use the Task tool to launch the error detective agent:
```
Task:
subagent_type: "error-detective"
subagent_type: "incident-response-error-detective"
description: "Analyze error context for: $ISSUE"
prompt: |
Analyze error traces, logs, and observability data for: $ISSUE
@@ -112,7 +112,7 @@ Use the Task tool to launch the debugger agent:
```
Task:
subagent_type: "debugger"
subagent_type: "incident-response-debugger"
description: "Identify root cause for: $ISSUE"
prompt: |
Perform root cause investigation using error-detective output:
@@ -179,7 +179,7 @@ Use the Task tool to launch the debugger agent:
```
Task:
subagent_type: "debugger"
subagent_type: "incident-response-debugger"
description: "Deep code analysis for: $ISSUE"
prompt: |
Perform deep code analysis and bisect investigation:
@@ -213,7 +213,7 @@ Use the Task tool to launch the code reviewer agent:
```
Task:
subagent_type: "code-reviewer"
subagent_type: "incident-response-code-reviewer"
description: "Review code logic for: $ISSUE"
prompt: |
Review code logic and identify design issues:
@@ -325,7 +325,7 @@ Use the Task tool to launch the test automator:
```
Task:
subagent_type: "test-automator"
subagent_type: "incident-response-test-automator"
description: "Regression testing for: $ISSUE fix"
prompt: |
Run comprehensive regression testing and verify fix quality:
@@ -448,7 +448,7 @@ Read `.smart-fix/05-implementation.md` and `.smart-fix/06-verification.md`.
```
Task:
subagent_type: "code-reviewer"
subagent_type: "incident-response-code-reviewer"
description: "Final review for: $ISSUE fix"
prompt: |
Perform final code review and approve for deployment:
@@ -1,5 +1,5 @@
---
name: kubernetes-architect
name: kubernetes-operations-kubernetes-architect
description: Expert Kubernetes architect specializing in cloud-native infrastructure, advanced GitOps workflows (ArgoCD/Flux), and enterprise container orchestration. Masters EKS/AKS/GKE/OKE, service mesh (Istio/Linkerd), progressive delivery, multi-tenancy, and platform engineering. Handles security, observability, cost optimization, and developer experience. Use PROACTIVELY for K8s architecture, GitOps implementation, or cloud-native platform design.
model: opus
---
@@ -176,7 +176,7 @@ Provide complete deployment configuration and automation scripts.
</Task>
<Task>
subagent_type: kubernetes-architect
subagent_type: kubernetes-operations-kubernetes-architect
prompt: |
Design Kubernetes infrastructure for ML workloads from: {phase3.mlops-engineer.output}
@@ -206,10 +206,10 @@ Provide Kubernetes manifests and Helm charts for entire ML platform.
## Phase 4: Monitoring & Continuous Improvement
<Task>
subagent_type: observability-engineer
subagent_type: observability-monitoring-observability-engineer
prompt: |
Implement comprehensive monitoring for ML system deployed in: {phase3.mlops-engineer.output}
Using Kubernetes infrastructure: {phase3.kubernetes-architect.output}
Using Kubernetes infrastructure: {phase3.kubernetes-operations-kubernetes-architect.output}
Monitoring framework:
@@ -1,5 +1,5 @@
---
name: backend-architect
name: multi-platform-apps-backend-architect
description: Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems. Masters REST/GraphQL/gRPC APIs, event-driven architectures, service mesh patterns, and modern backend frameworks. Handles service boundary definition, inter-service communication, resilience patterns, and observability. Use PROACTIVELY when creating new backend services or APIs.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: frontend-developer
name: multi-platform-apps-frontend-developer
description: Build React components, implement responsive layouts, and handle client-side state management. Masters React 19, Next.js 15, and modern frontend architecture. Optimizes performance and ensures accessibility. Use PROACTIVELY when creating UI components or fixing frontend issues.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: mobile-developer
name: multi-platform-apps-mobile-developer
description: Develop React Native, Flutter, or native mobile apps with modern architecture patterns. Masters cross-platform development, native integrations, offline sync, and app store optimization. Use PROACTIVELY for mobile features, cross-platform code, or app optimization.
model: inherit
---
@@ -72,7 +72,7 @@ Use the Task tool to launch the backend architect:
```
Task:
subagent_type: "backend-architect"
subagent_type: "multi-platform-apps-backend-architect"
description: "Design API contract for $FEATURE"
prompt: |
Design the API contract for feature: $FEATURE.
@@ -223,7 +223,7 @@ Launch platform implementations in parallel using multiple Task tool calls. Only
```
Task:
subagent_type: "frontend-developer"
subagent_type: "multi-platform-apps-frontend-developer"
description: "Implement web version of $FEATURE"
prompt: |
Implement web version of feature: $FEATURE.
@@ -287,7 +287,7 @@ Save output to `.multi-platform/04b-ios.md`.
```
Task:
subagent_type: "mobile-developer"
subagent_type: "multi-platform-apps-mobile-developer"
description: "Implement Android version of $FEATURE"
prompt: |
Implement Android version of feature: $FEATURE.
@@ -322,7 +322,7 @@ Only if "desktop" is in the platforms list:
```
Task:
subagent_type: "frontend-developer"
subagent_type: "multi-platform-apps-frontend-developer"
description: "Implement desktop version of $FEATURE"
prompt: |
Implement desktop version of feature: $FEATURE using Tauri 2.0 or Electron.
@@ -1,5 +1,5 @@
---
name: database-optimizer
name: observability-monitoring-database-optimizer
description: Expert database optimizer specializing in modern performance tuning, query optimization, and scalable architectures. Masters advanced indexing, N+1 resolution, multi-tier caching, partitioning strategies, and cloud database optimization. Handles complex query analysis, migration strategies, and performance monitoring. Use PROACTIVELY for database optimization, performance issues, or scalability challenges.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: network-engineer
name: observability-monitoring-network-engineer
description: Expert network engineer specializing in modern cloud networking, security architectures, and performance optimization. Masters multi-cloud connectivity, service mesh, zero-trust networking, SSL/TLS, global load balancing, and advanced troubleshooting. Handles CDN optimization, network automation, and compliance. Use PROACTIVELY for network design, connectivity issues, or performance optimization.
model: sonnet
---
@@ -1,5 +1,5 @@
---
name: observability-engineer
name: observability-monitoring-observability-engineer
description: Build production-ready monitoring, logging, and tracing systems. Implements comprehensive observability strategies, SLI/SLO management, and incident response workflows. Use PROACTIVELY for monitoring infrastructure, performance optimization, or production reliability.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: performance-engineer
name: observability-monitoring-performance-engineer
description: Expert performance engineer specializing in modern observability, application optimization, and scalable system performance. Masters OpenTelemetry, distributed tracing, load testing, multi-tier caching, Core Web Vitals, and performance monitoring. Handles end-to-end optimization, real user monitoring, and scalability patterns. Use PROACTIVELY for performance optimization, observability, or scalability challenges.
model: inherit
---
@@ -1,5 +1,5 @@
---
name: performance-engineer
name: performance-testing-review-performance-engineer
description: Expert performance engineer specializing in modern observability, application optimization, and scalable system performance. Masters OpenTelemetry, distributed tracing, load testing, multi-tier caching, Core Web Vitals, and performance monitoring. Handles end-to-end optimization, real user monitoring, and scalability patterns. Use PROACTIVELY for performance optimization, observability, or scalability challenges.
model: inherit
---

Some files were not shown because too many files have changed in this diff Show More