## File: README.md # Awesome Claude Code Subagents This repository serves as the definitive collection of Claude Code subagents, specialized AI assistants designed for specific development tasks. > **A note on contributions:** We don't accept PRs whose primary purpose is to promote a product, company, or personal project. Subagents must be genuinely useful to Claude Code users and stay vendor-neutral in their content. If you'd like to get your project in front of this community, you can [sponsor the repo](#sponsors) instead β€” that's the supported way to surface your work here. ## Installation ### As Claude Code Plugin (Recommended) ```bash claude plugin marketplace add VoltAgent/awesome-claude-code-subagents claude plugin install ``` Examples: ```bash claude plugin install voltagent-lang # Language specialists claude plugin install voltagent-infra # Infrastructure & DevOps ``` See [Categories](#-categories) below for all available plugins. > **Note**: The `voltagent-meta` orchestration agents work best when other categories installed. ### Option 1: Manual Installation 1. Clone this repository 2. Copy desired agent files to: - `~/.claude/agents/` for global access - `.claude/agents/` for project-specific use 3. Customize based on your project requirements ### Option 2: Interactive Installer ```bash git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git cd awesome-claude-code-subagents ./install-agents.sh ``` This interactive script lets you browse categories, select agents, and install/uninstall them with a single command. ### Option 3: Standalone Installer (no clone required) ```bash curl -sO https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/install-agents.sh chmod +x install-agents.sh ./install-agents.sh ``` Downloads agents directly from GitHub without cloning the repository. Requires `curl`. ### Option 4: Agent Installer (use Claude Code to install agents) ```bash curl -s https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/09-meta-orchestration/agent-installer.md -o ~/.claude/agents/agent-installer.md ``` Then in Claude Code: "Use the agent-installer to show me available categories" or "Find PHP agents and install php-pro globally". ## πŸ“š Categories ### [01. Core Development](categories/01-core-development/) **Plugin:** `voltagent-core-dev` Essential development subagents for everyday coding tasks. - [**api-designer**](categories/01-core-development/api-designer.md) - REST and GraphQL API architect - [**backend-developer**](categories/01-core-development/backend-developer.md) - Server-side expert for scalable APIs - [**design-bridge**](categories/01-core-development/design-bridge.md) - Design-to-agent translator - [**electron-pro**](categories/01-core-development/electron-pro.md) - Desktop application expert - [**frontend-developer**](categories/01-core-development/frontend-developer.md) - UI/UX specialist for React, Vue, and Angular - [**fullstack-developer**](categories/01-core-development/fullstack-developer.md) - End-to-end feature development - [**graphql-architect**](categories/01-core-development/graphql-architect.md) - GraphQL schema and federation expert - [**microservices-architect**](categories/01-core-development/microservices-architect.md) - Distributed systems designer - [**mobile-developer**](categories/01-core-development/mobile-developer.md) - Cross-platform mobile specialist - [**ui-designer**](categories/01-core-development/ui-designer.md) - Visual design and interaction specialist - [**websocket-engineer**](categories/01-core-development/websocket-engineer.md) - Real-time communication specialist You ship products with AI, but every launch still dies quietly because nobody posts about it. [EveryFeed](https://everyfeed.ai/) plugs your AI assistant into a social workspace that drafts, schedules, and publishes across 35+ channels β€” no agency, no marketing hire. Stop building from a blank page. [LaunchKit](https://launchkit.getdesign.md/) gives your AI coding assistant a complete, working product to start from β€” websites, startups, and web apps that are clickable on day one. ### [02. Language Specialists](categories/02-language-specialists/) **Plugin:** `voltagent-lang` Language-specific experts with deep framework knowledge. - [**typescript-pro**](categories/02-language-specialists/typescript-pro.md) - TypeScript specialist - [**sql-pro**](categories/02-language-specialists/sql-pro.md) - Database query expert - [**swift-expert**](categories/02-language-specialists/swift-expert.md) - iOS and macOS specialist - [**vue-expert**](categories/02-language-specialists/vue-expert.md) - Vue 3 Composition API expert - [**angular-architect**](categories/02-language-specialists/angular-architect.md) - Angular 15+ enterprise patterns expert - [**cpp-pro**](categories/02-language-specialists/cpp-pro.md) - C++ performance expert - [**csharp-developer**](categories/02-language-specialists/csharp-developer.md) - .NET ecosystem specialist - [**django-developer**](categories/02-language-specialists/django-developer.md) - Django 4+ web development expert - [**dotnet-core-expert**](categories/02-language-specialists/dotnet-core-expert.md) - .NET 8 cross-platform specialist - [**dotnet-framework-4.8-expert**](categories/02-language-specialists/dotnet-framework-4.8-expert.md) - .NET Framework legacy enterprise specialist - [**elixir-expert**](categories/02-language-specialists/elixir-expert.md) - Elixir and OTP fault-tolerant systems expert - [**expo-react-native-expert**](categories/02-language-specialists/expo-react-native-expert.md) - Expo and React Native mobile development expert - [**fastapi-developer**](categories/02-language-specialists/fastapi-developer.md) - Modern async Python API framework expert - [**flutter-expert**](categories/02-language-specialists/flutter-expert.md) - Flutter 3+ cross-platform mobile expert - [**golang-pro**](categories/02-language-specialists/golang-pro.md) - Go concurrency specialist - [**java-architect**](categories/02-language-specialists/java-architect.md) - Enterprise Java expert - [**javascript-pro**](categories/02-language-specialists/javascript-pro.md) - JavaScript development expert - [**powershell-5.1-expert**](categories/02-language-specialists/powershell-5.1-expert.md) - Windows PowerShell 5.1 and full .NET Framework automation specialist - [**powershell-7-expert**](categories/02-language-specialists/powershell-7-expert.md) - Cross-platform PowerShell 7+ automation and modern .NET specialist - [**kotlin-specialist**](categories/02-language-specialists/kotlin-specialist.md) - Modern JVM language expert - [**laravel-specialist**](categories/02-language-specialists/laravel-specialist.md) - Laravel 10+ PHP framework expert - [**nextjs-developer**](categories/02-language-specialists/nextjs-developer.md) - Next.js 14+ full-stack specialist - [**node-specialist**](categories/02-language-specialists/node-specialist.md) - Node.js specialist - [**php-pro**](categories/02-language-specialists/php-pro.md) - PHP web development expert - [**python-pro**](categories/02-language-specialists/python-pro.md) - Python ecosystem master - [**rails-expert**](categories/02-language-specialists/rails-expert.md) - Rails 8.1 rapid development expert - [**react-specialist**](categories/02-language-specialists/react-specialist.md) - React 18+ modern patterns expert - [**rust-engineer**](categories/02-language-specialists/rust-engineer.md) - Systems programming expert - [**spring-boot-engineer**](categories/02-language-specialists/spring-boot-engineer.md) - Spring Boot 3+ microservices expert - [**symfony-specialist**](categories/02-language-specialists/symfony-specialist.md) - Symfony 6+/7+/8+ PHP framework and Doctrine ORM expert ### [03. Infrastructure](categories/03-infrastructure/) **Plugin:** `voltagent-infra` DevOps, cloud, and deployment specialists. - [**azure-infra-engineer**](categories/03-infrastructure/azure-infra-engineer.md) - Azure infrastructure and Az PowerShell automation expert - [**cloud-architect**](categories/03-infrastructure/cloud-architect.md) - AWS/GCP/Azure specialist - [**database-administrator**](categories/03-infrastructure/database-administrator.md) - Database management expert - [**docker-expert**](categories/03-infrastructure/docker-expert.md) - Docker containerization and optimization expert - [**deployment-engineer**](categories/03-infrastructure/deployment-engineer.md) - Deployment automation specialist - [**devops-engineer**](categories/03-infrastructure/devops-engineer.md) - CI/CD and automation expert - [**devops-incident-responder**](categories/03-infrastructure/devops-incident-responder.md) - DevOps incident management - [**incident-responder**](categories/03-infrastructure/incident-responder.md) - System incident response expert - [**kubernetes-specialist**](categories/03-infrastructure/kubernetes-specialist.md) - Container orchestration master - [**network-engineer**](categories/03-infrastructure/network-engineer.md) - Network infrastructure specialist - [**platform-engineer**](categories/03-infrastructure/platform-engineer.md) - Platform architecture expert - [**security-engineer**](categories/03-infrastructure/security-engineer.md) - Infrastructure security specialist - [**sre-engineer**](categories/03-infrastructure/sre-engineer.md) - Site reliability engineering expert - [**terraform-engineer**](categories/03-infrastructure/terraform-engineer.md) - Infrastructure as Code expert - [**terragrunt-expert**](categories/03-infrastructure/terragrunt-expert.md) - Terragrunt orchestration and DRY IaC specialist - [**windows-infra-admin**](categories/03-infrastructure/windows-infra-admin.md) - Active Directory, DNS, DHCP, and GPO automation specialist ### [04. Quality & Security](categories/04-quality-security/) **Plugin:** `voltagent-qa-sec` Testing, security, and code quality experts. - [**accessibility-tester**](categories/04-quality-security/accessibility-tester.md) - A11y compliance expert - [**ad-security-reviewer**](categories/04-quality-security/ad-security-reviewer.md) - Active Directory security and GPO audit specialist - [**ai-writing-auditor**](categories/04-quality-security/ai-writing-auditor.md) - AI writing pattern detector and rewriter - [**architect-reviewer**](categories/04-quality-security/architect-reviewer.md) - Architecture review specialist - [**chaos-engineer**](categories/04-quality-security/chaos-engineer.md) - System resilience testing expert - [**code-reviewer**](categories/04-quality-security/code-reviewer.md) - Code quality guardian - [**compliance-auditor**](categories/04-quality-security/compliance-auditor.md) - Regulatory compliance expert - [**debugger**](categories/04-quality-security/debugger.md) - Advanced debugging specialist - [**gdpr-ccpa-compliance**](categories/04-quality-security/gdpr-ccpa-compliance.md) - GDPR and CCPA privacy compliance specialist - [**error-detective**](categories/04-quality-security/error-detective.md) - Error analysis and resolution expert - [**penetration-tester**](categories/04-quality-security/penetration-tester.md) - Ethical hacking specialist - [**performance-engineer**](categories/04-quality-security/performance-engineer.md) - Performance optimization expert - [**powershell-security-hardening**](categories/04-quality-security/powershell-security-hardening.md) - PowerShell security hardening and compliance specialist - [**qa-expert**](categories/04-quality-security/qa-expert.md) - Test automation specialist - [**security-auditor**](categories/04-quality-security/security-auditor.md) - Security vulnerability expert - [**test-automator**](categories/04-quality-security/test-automator.md) - Test automation framework expert - [**ui-ux-tester**](categories/04-quality-security/ui-ux-tester.md) - Exhaustive documented-flow UI tester ### [05. Data & AI](categories/05-data-ai/) **Plugin:** `voltagent-data-ai` Data engineering, ML, and AI specialists. - [**ai-engineer**](categories/05-data-ai/ai-engineer.md) - AI system design and deployment expert - [**data-analyst**](categories/05-data-ai/data-analyst.md) - Data insights and visualization specialist - [**data-engineer**](categories/05-data-ai/data-engineer.md) - Data pipeline architect - [**data-scientist**](categories/05-data-ai/data-scientist.md) - Analytics and insights expert - [**database-optimizer**](categories/05-data-ai/database-optimizer.md) - Database performance specialist - [**llm-architect**](categories/05-data-ai/llm-architect.md) - Large language model architect - [**machine-learning-engineer**](categories/05-data-ai/machine-learning-engineer.md) - Machine learning systems expert - [**ml-engineer**](categories/05-data-ai/ml-engineer.md) - Machine learning specialist - [**mlops-engineer**](categories/05-data-ai/mlops-engineer.md) - MLOps and model deployment expert - [**nlp-engineer**](categories/05-data-ai/nlp-engineer.md) - Natural language processing expert - [**postgres-pro**](categories/05-data-ai/postgres-pro.md) - PostgreSQL database expert - [**prompt-engineer**](categories/05-data-ai/prompt-engineer.md) - Prompt optimization specialist - [**reinforcement-learning-engineer**](categories/05-data-ai/reinforcement-learning-engineer.md) - Reinforcement learning and agent training expert ### [06. Developer Experience](categories/06-developer-experience/) **Plugin:** `voltagent-dev-exp` Tooling and developer productivity experts. - [**build-engineer**](categories/06-developer-experience/build-engineer.md) - Build system specialist - [**cli-developer**](categories/06-developer-experience/cli-developer.md) - Command-line tool creator - [**dependency-manager**](categories/06-developer-experience/dependency-manager.md) - Package and dependency specialist - [**docs-drift-editor**](categories/06-developer-experience/docs-drift-editor.md) - Documentation-drift editor for isolated-worktree fixes - [**documentation-engineer**](categories/06-developer-experience/documentation-engineer.md) - Technical documentation expert - [**dx-optimizer**](categories/06-developer-experience/dx-optimizer.md) - Developer experience optimization specialist - [**git-workflow-manager**](categories/06-developer-experience/git-workflow-manager.md) - Git workflow and branching expert - [**legacy-modernizer**](categories/06-developer-experience/legacy-modernizer.md) - Legacy code modernization specialist - [**mcp-developer**](categories/06-developer-experience/mcp-developer.md) - Model Context Protocol specialist - [**powershell-ui-architect**](categories/06-developer-experience/powershell-ui-architect.md) - PowerShell UI/UX specialist for WinForms, WPF, Metro frameworks, and TUIs - [**powershell-module-architect**](categories/06-developer-experience/powershell-module-architect.md) - PowerShell module and profile architecture specialist - [**readme-generator**](categories/06-developer-experience/readme-generator.md) - Repository README generation specialist - [**refactoring-specialist**](categories/06-developer-experience/refactoring-specialist.md) - Code refactoring expert - [**slack-expert**](categories/06-developer-experience/slack-expert.md) - Slack platform and @slack/bolt specialist - [**tooling-engineer**](categories/06-developer-experience/tooling-engineer.md) - Developer tooling specialist - [**visual-asset-generator**](categories/06-developer-experience/visual-asset-generator.md) - Visual asset generation specialist using prompt-to-asset MCP across 30+ image models ### [07. Specialized Domains](categories/07-specialized-domains/) **Plugin:** `voltagent-domains` Domain-specific technology experts. - [**api-documenter**](categories/07-specialized-domains/api-documenter.md) - API documentation specialist - [**blockchain-developer**](categories/07-specialized-domains/blockchain-developer.md) - Web3 and crypto specialist - [**email-deliverability-engineer**](categories/07-specialized-domains/email-deliverability-engineer.md) - Email deliverability specialist - [**embedded-systems**](categories/07-specialized-domains/embedded-systems.md) - Embedded and real-time systems expert - [**fintech-engineer**](categories/07-specialized-domains/fintech-engineer.md) - Financial technology specialist - [**game-developer**](categories/07-specialized-domains/game-developer.md) - Game development expert - [**healthcare-admin**](categories/07-specialized-domains/healthcare-admin.md) - Healthcare administration specialist with 51 sub-agents covering revenue cycle, compliance, quality, clinical ops, health IT, and payer relations - [**hipaa-compliance**](categories/07-specialized-domains/hipaa-compliance.md) - HIPAA compliance specialist for healthcare SaaS vendors - [**iot-engineer**](categories/07-specialized-domains/iot-engineer.md) - IoT systems developer - [**m365-admin**](categories/07-specialized-domains/m365-admin.md) - Microsoft 365, Exchange Online, Teams, and SharePoint administration specialist - [**mobile-app-developer**](categories/07-specialized-domains/mobile-app-developer.md) - Mobile application specialist - [**payment-integration**](categories/07-specialized-domains/payment-integration.md) - Payment systems expert - [**quant-analyst**](categories/07-specialized-domains/quant-analyst.md) - Quantitative analysis specialist - [**risk-manager**](categories/07-specialized-domains/risk-manager.md) - Risk assessment and management expert - [**seo-specialist**](categories/07-specialized-domains/seo-specialist.md) - Search engine optimization expert - [**x-api-integration**](categories/07-specialized-domains/x-api-integration.md) - X/Twitter API integration specialist ### [08. Business & Product](categories/08-business-product/) **Plugin:** `voltagent-biz` Product management and business analysis. - [**assumption-mapping**](categories/08-business-product/assumption-mapping.md) - Product assumption risk and validation specialist - [**backlog-grooming**](categories/08-business-product/backlog-grooming.md) - Agile backlog refinement specialist - [**business-analyst**](categories/08-business-product/business-analyst.md) - Requirements specialist - [**content-marketer**](categories/08-business-product/content-marketer.md) - Content marketing specialist - [**customer-success-manager**](categories/08-business-product/customer-success-manager.md) - Customer success expert - [**growth-loops**](categories/08-business-product/growth-loops.md) - Growth loop and PLG mechanics specialist - [**landing-page-copywriter**](categories/08-business-product/landing-page-copywriter.md) - Conversion copywriting specialist - [**legal-advisor**](categories/08-business-product/legal-advisor.md) - Legal and compliance specialist - [**license-engineer**](categories/08-business-product/license-engineer.md) - Software licensing and compliance systems specialist - [**product-manager**](categories/08-business-product/product-manager.md) - Product strategy expert - [**project-manager**](categories/08-business-product/project-manager.md) - Project management specialist - [**sales-engineer**](categories/08-business-product/sales-engineer.md) - Technical sales expert - [**scrum-master**](categories/08-business-product/scrum-master.md) - Agile methodology expert - [**technical-writer**](categories/08-business-product/technical-writer.md) - Technical documentation specialist - [**ux-researcher**](categories/08-business-product/ux-researcher.md) - User research expert - [**wordpress-master**](categories/08-business-product/wordpress-master.md) - WordPress development and optimization expert - [**content-quality-editor**](categories/08-business-product/content-quality-editor.md) - AI content quality specialist using unslop to strip AI writing patterns before publishing ### [09. Meta & Orchestration](categories/09-meta-orchestration/) **Plugin:** `voltagent-meta` Agent coordination and meta-programming. - [**airis-mcp-gateway**](https://github.com/agiletec-inc/airis-mcp-gateway) - Docker-based MCP multiplexer that aggregates 60+ tools behind 7 meta-tools, reducing context token usage by 97%. One command to start, auto-enables servers on demand - [**moai-adk**](https://github.com/modu-ai/moai-adk) - SPEC-first Agentic Development Kit orchestrating 24 specialized agents with enforced Planβ†’Runβ†’Sync workflow, TRUST 5 quality gates, 52 domain-specific skills, and 16-language project support - [**agent-installer**](categories/09-meta-orchestration/agent-installer.md) - Browse and install agents from this repository via GitHub - [**agent-organizer**](categories/09-meta-orchestration/agent-organizer.md) - Multi-agent coordinator - [**codebase-orchestrator**](categories/09-meta-orchestration/codebase-orchestrator.md) - Safe refactor governance orchestrator - [**context-manager**](categories/09-meta-orchestration/context-manager.md) - Context optimization expert - [**error-coordinator**](categories/09-meta-orchestration/error-coordinator.md) - Error handling and recovery specialist - [**it-ops-orchestrator**](categories/09-meta-orchestration/it-ops-orchestrator.md) - IT operations workflow orchestration specialist - [**knowledge-synthesizer**](categories/09-meta-orchestration/knowledge-synthesizer.md) - Knowledge aggregation expert - [**multi-agent-coordinator**](categories/09-meta-orchestration/multi-agent-coordinator.md) - Advanced multi-agent orchestration - [**performance-monitor**](categories/09-meta-orchestration/performance-monitor.md) - Agent performance optimization - [**pied-piper**](https://github.com/sathish316/pied-piper/) - Orchestrate Team of AI Subagents for repetitive SDLC workflows - [**task-distributor**](categories/09-meta-orchestration/task-distributor.md) - Task allocation specialist - [**taskade**](https://github.com/taskade/mcp) - AI-powered workspace with autonomous agents, real-time collaboration, and workflow automation with MCP integration - [**workflow-orchestrator**](categories/09-meta-orchestration/workflow-orchestrator.md) - Complex workflow automation ### [10. Research & Analysis](categories/10-research-analysis/) **Plugin:** `voltagent-research` Research, search, and analysis specialists. - [**ab-test-analysis**](categories/10-research-analysis/ab-test-analysis.md) - A/B test analysis and ship/no-ship decision specialist - [**cohort-analysis**](categories/10-research-analysis/cohort-analysis.md) - User cohort retention and behavioral analysis specialist - [**first-principles-thinking**](categories/10-research-analysis/first-principles-thinking.md) - First principles problem-solving specialist - [**research-analyst**](categories/10-research-analysis/research-analyst.md) - Comprehensive research specialist - [**search-specialist**](categories/10-research-analysis/search-specialist.md) - Advanced information retrieval expert - [**trend-analyst**](categories/10-research-analysis/trend-analyst.md) - Emerging trends and forecasting expert - [**competitive-analyst**](categories/10-research-analysis/competitive-analyst.md) - Competitive intelligence specialist - [**market-researcher**](categories/10-research-analysis/market-researcher.md) - Market analysis and consumer insights - [**project-idea-validator**](categories/10-research-analysis/project-idea-validator.md) - Brutal go/no-go product idea validator - [**data-researcher**](categories/10-research-analysis/data-researcher.md) - Data discovery and analysis expert - [**scientific-literature-researcher**](categories/10-research-analysis/scientific-literature-researcher.md) - Scientific paper search and evidence synthesis via [BGPT MCP](https://github.com/connerlambden/bgpt-mcp) ## πŸ€– Understanding Subagents Subagents are specialized AI assistants that enhance Claude Code's capabilities by providing task-specific expertise. They act as dedicated helpers that Claude Code can call upon when encountering particular types of work. ### What Makes Subagents Special? **Independent Context Windows** Every subagent operates within its own isolated context space, preventing cross-contamination between different tasks and maintaining clarity in the primary conversation thread. **Domain-Specific Intelligence** Subagents come equipped with carefully crafted instructions tailored to their area of expertise, resulting in superior performance on specialized tasks. **Shared Across Projects** After creating a subagent, you can utilize it throughout various projects and distribute it among team members to ensure consistent development practices. **Granular Tool Permissions** You can configure each subagent with specific tool access rights, enabling fine-grained control over which capabilities are available for different task types. ### Core Advantages - **Memory Efficiency**: Isolated contexts prevent the main conversation from becoming cluttered with task-specific details - **Enhanced Accuracy**: Specialized prompts and configurations lead to better results in specific domains - **Workflow Consistency**: Team-wide subagent sharing ensures uniform approaches to common tasks - **Security Control**: Tool access can be restricted based on subagent type and purpose ### Getting Started with Subagents **1. Access the Subagent Manager** ```bash /agents ``` **2. Create Your Subagent** - Choose between project-specific or global subagents - Let Claude generate an initial version, then refine it to your needs - Provide detailed descriptions of the subagent's purpose and activation triggers - Configure tool access (leave empty to inherit all available tools) - Customize the system prompt using the built-in editor (press `e`) **3. Deploy and Utilize** Your subagent becomes immediately available. Claude Code will automatically engage it when suitable, or you can explicitly request its help: ``` > Have the code-reviewer subagent analyze my latest commits ``` ### Subagent Storage Locations | Type | Path | Availability | Precedence | |------|------|--------------|------------| | Project Subagents | `.claude/agents/` | Current project only | Higher | | Global Subagents | `~/.claude/agents/` | All projects | Lower | Note: When naming conflicts occur, project-specific subagents override global ones. ## πŸ“– Subagent Structure Each subagent follows a standardized template: ```yaml --- name: subagent-name tools: Read, Write, Edit, Bash, Glob, Grep model: sonnet --- You are a [role description and expertise areas]... [Agent-specific checklists, patterns, and guidelines]... ## Communication Protocol Inter-agent communication specifications... ## Development Workflow Structured implementation phases... ``` ### Tool Assignment Philosophy ### Smart Model Routing Each subagent includes a `model` field that automatically routes it to the right Claude model β€” balancing quality and cost: | Model | When It's Used | Examples | |-------|----------------|----------| | `opus` | Deep reasoning β€” architecture reviews, security audits, financial logic | `security-auditor`, `architect-reviewer`, `fintech-engineer` | | `sonnet` | Everyday coding β€” writing, debugging, refactoring | `python-pro`, `backend-developer`, `devops-engineer` | | `haiku` | Quick tasks β€” docs, search, dependency checks | `documentation-engineer`, `seo-specialist`, `build-engineer` | You can override any agent's model by editing the `model` field in its frontmatter. Set `model: inherit` to use whatever model your main conversation is using. ### Tool Assignment Philosophy Each subagent's `tools` field specifies Claude Code built-in tools, optimized for their role: - **Read-only agents** (reviewers, auditors): `Read, Grep, Glob` - analyze without modifying - **Research agents** (analysts, researchers): `Read, Grep, Glob, WebFetch, WebSearch` - gather information - **Code writers** (developers, engineers): `Read, Write, Edit, Bash, Glob, Grep` - create and execute - **Documentation agents** (writers, documenters): `Read, Write, Edit, Glob, Grep, WebFetch, WebSearch` - document with research Each agent has minimal necessary permissions. You can extend agents by adding MCP servers or external tools to the `tools` field. ## 🧰 Tools ### [subagent-catalog](tools/subagent-catalog/) Claude Code skill for browsing and fetching subagents from this catalog. | Command | Description | |---------|-------------| | `/subagent-catalog:search ` | Find agents by name, description, or category | | `/subagent-catalog:fetch ` | Get full agent definition | | `/subagent-catalog:list` | Browse all categories | | `/subagent-catalog:invalidate` | Refresh cache | **Installation:** ```bash cp -r tools/subagent-catalog ~/.claude/commands/ ``` ## 🀝 Contributing We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. - Submit new subagents via PR - Improve existing definitions - Report issues and bugs ## Contributor β™₯️ Thanks ## πŸ“„ License MIT License - see [LICENSE](LICENSE) This repository is a curated collection of subagent definitions contributed by both the maintainers and the community. All subagents are provided "as is" without warranty. We do not audit or guarantee the security or correctness of any subagent. Review before use, the maintainers accept no liability for any issues arising from their use. If you find an issue with a listed subagent or want your contribution removed, please [open an issue](https://github.com/VoltAgent/awesome-claude-code-subagents/issues) and we'll address it promptly. [codex-badge]: https://img.shields.io/github/stars/VoltAgent/awesome-codex-subagents?style=classic&label=Codex%20Subagents&color=000000&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0yMi4yODIgOS44MjFhNS45ODUgNS45ODUgMCAwIDAtLjUxNi00LjkxIDYuMDQ2IDYuMDQ2IDAgMCAwLTYuNTEtMi45QTYuMDY1IDYuMDY1IDAgMCAwIDQuOTgxIDQuMThhNS45ODUgNS45ODUgMCAwIDAtMy45OTggMi45IDYuMDQ2IDYuMDQ2IDAgMCAwIC43NDMgNy4wOTcgNS45OCA1Ljk4IDAgMCAwIC41MSA0LjkxMSA2LjA1MSA2LjA1MSAwIDAgMCA2LjUxNSAyLjlBNS45ODUgNS45ODUgMCAwIDAgMTMuMjYgMjRhNi4wNTYgNi4wNTYgMCAwIDAgNS43NzItNC4yMDYgNS45OSA1Ljk5IDAgMCAwIDMuOTk3LTIuOSA2LjA1NiA2LjA1NiAwIDAgMC0uNzQ3LTcuMDczek0xMy4yNiAyMi40M2E0LjQ3NiA0LjQ3NiAwIDAgMS0yLjg3Ni0xLjA0bC4xNDEtLjA4MSA0Ljc3OS0yLjc1OGEuNzk1Ljc5NSAwIDAgMCAuMzkyLS42ODF2LTYuNzM3bDIuMDIgMS4xNjhhLjA3MS4wNzEgMCAwIDEgLjAzOC4wNTJ2NS41ODNhNC41MDQgNC41MDQgMCAwIDEtNC40OTQgNC40OTR6TTMuNiAxOC4zMDRhNC40NyA0LjQ3IDAgMCAxLS41MzUtMy4wMTRsLjE0Mi4wODUgNC43ODMgMi43NTlhLjc3MS43NzEgMCAwIDAgLjc4IDBsNS44NDMtMy4zNjl2Mi4zMzJhLjA4LjA4IDAgMCAxLS4wMzMuMDYyTDkuNzQgMTkuOTVhNC41IDQuNSAwIDAgMS02LjE0LTEuNjQ2ek0yLjM0IDcuODk2YTQuNDg1IDQuNDg1IDAgMCAxIDIuMzY2LTEuOTczVjExLjZhLjc2Ni43NjYgMCAwIDAgLjM4OC42NzZsNS44MTUgMy4zNTUtMi4wMiAxLjE2OGEuMDc2LjA3NiAwIDAgMS0uMDcxIDBsLTQuODMtMi43ODZBNC41MDQgNC41MDQgMCAwIDEgMi4zNCA3Ljg3MnptMTYuNTk3IDMuODU1bC01LjgzMy0zLjM4N0wxNS4xMTkgNy4yYS4wNzYuMDc2IDAgMCAxIC4wNzEgMGw0LjgzIDIuNzkxYTQuNDk0IDQuNDk0IDAgMCAxLS42NzYgOC4xMDV2LTUuNjc4YS43OS43OSAwIDAgMC0uNDA3LS42Njd6bTIuMDEtMy4wMjNsLS4xNDEtLjA4NS00Ljc3NC0yLjc4MmEuNzc2Ljc3NiAwIDAgMC0uNzg1IDBMOS40MDkgOS4yM1Y2Ljg5N2EuMDY2LjA2NiAwIDAgMSAuMDI4LS4wNjFsNC44My0yLjc4N2E0LjUgNC41IDAgMCAxIDYuNjggNC42NnptLTEyLjY0IDQuMTM1bC0yLjAyLTEuMTY0YS4wOC4wOCAwIDAgMS0uMDM4LS4wNTdWNi4wNzVhNC41IDQuNSAwIDAgMSA3LjM3NS0zLjQ1M2wtLjE0Mi4wOEw4LjcwNCA1LjQ2YS43OTUuNzk1IDAgMCAwLS4zOTMuNjgxem0xLjA5Ny0yLjM2NWwyLjYwMi0xLjUgMi42MDcgMS41djIuOTk5bC0yLjU5NyAxLjUtMi42MDctMS41eiIvPjwvc3ZnPg== [codex-link]: https://github.com/VoltAgent/awesome-codex-subagents --- ## File: categories/10-research-analysis/README.md # Research & Analysis Subagents Research & Analysis subagents are your investigative powerhouses, specializing in finding, analyzing, and synthesizing information from diverse sources. These experts excel at deep research, competitive intelligence, market analysis, and trend identification. They transform raw information into actionable insights, helping you make informed decisions based on comprehensive analysis and data-driven research. ## When to Use Research & Analysis Subagents Use these subagents when you need to: - **Conduct comprehensive research** on any topic - **Find specific information** across multiple sources - **Analyze market dynamics** and opportunities - **Track competitive intelligence** systematically - **Identify emerging trends** before others - **Gather and analyze data** for insights - **Synthesize complex information** into clear findings - **Make data-driven decisions** with confidence ## Available Subagents ### [**ab-test-analysis**](ab-test-analysis.md) - A/B test analysis and ship/no-ship decision specialist Statistical analysis expert interpreting A/B test results, p-values, confidence intervals, and effect sizes. Makes principled ship/no-ship decisions using a structured framework and catches common analysis errors like peeking, multiple comparisons, and Simpson's Paradox. **Use when:** Analyzing A/B or experiment results, interpreting p-values, making ship or no-ship decisions, evaluating statistical vs. practical significance, or validating test integrity. ### [**cohort-analysis**](cohort-analysis.md) - User cohort retention and behavioral analysis specialist Retention analysis expert understanding how user groups behave over time. Diagnoses retention curve shapes, identifies activation metrics (the "Aha Moment"), and tracks whether product improvements are actually moving retention numbers. **Use when:** Analyzing user retention, diagnosing where the retention curve drops, finding activation behaviors, comparing cohort performance over time, or assessing product-market fit signals. ### [**first-principles-thinking**](first-principles-thinking.md) - First principles problem-solving specialist Strategic thinking specialist breaking complex problems down to irreducible truths and rebuilding solutions from scratch. Applies the 5-step first principles method and 5D structured problem-solving framework to cut through assumptions. **Use when:** Challenging why things are done a certain way, rethinking a product or process from scratch, solving a recurring problem that conventional approaches haven't fixed, or pressure-testing assumptions before committing to a solution. ### [**research-analyst**](research-analyst.md) - Comprehensive research specialist Research expert conducting thorough investigations across domains. Masters research methodologies, source validation, and insight synthesis. Delivers comprehensive research reports on any topic. **Use when:** Conducting deep research, investigating complex topics, validating information, creating research reports, or synthesizing multiple sources. ### [**search-specialist**](search-specialist.md) - Advanced information retrieval expert Search optimization expert finding needles in information haystacks. Masters advanced search techniques, query optimization, and source discovery. Locates hard-to-find information efficiently. **Use when:** Finding specific information, optimizing search queries, discovering new sources, conducting systematic searches, or retrieving obscure data. ### [**trend-analyst**](trend-analyst.md) - Emerging trends and forecasting expert Trend identification specialist spotting patterns before they become obvious. Expert in trend analysis, future forecasting, and weak signal detection. Helps organizations stay ahead of change. **Use when:** Identifying emerging trends, forecasting future developments, analyzing pattern changes, monitoring industry evolution, or planning strategic responses. ### [**competitive-analyst**](competitive-analyst.md) - Competitive intelligence specialist Competitive intelligence expert analyzing competitor strategies and market positioning. Masters competitive benchmarking, SWOT analysis, and strategic recommendations. Provides actionable competitive insights. **Use when:** Analyzing competitors, benchmarking performance, identifying competitive advantages, monitoring competitor moves, or developing competitive strategies. ### [**market-researcher**](market-researcher.md) - Market analysis and consumer insights Market analysis specialist understanding market dynamics and consumer behavior. Expert in market sizing, segmentation, and opportunity identification. Reveals market opportunities and risks. **Use when:** Analyzing market opportunities, understanding consumer behavior, sizing markets, identifying segments, or evaluating market entry strategies. ### [**project-idea-validator**](project-idea-validator.md) - Brutal go or no-go idea validator Adversarial product idea specialist pressure-testing concepts against competitors, demand signals, and adoption friction. Focuses on killing weak ideas early and sharpening strong ones into evidence-backed MVPs. **Use when:** Stress-testing a startup or product idea, checking whether differentiation is real, finding hidden competitors, deciding whether to pivot, or getting a clear go/no-go recommendation before building. ### [**data-researcher**](data-researcher.md) - Data discovery and analysis expert Data investigation specialist extracting insights from complex datasets. Masters data mining, statistical analysis, and pattern recognition. Transforms raw data into meaningful findings. **Use when:** Analyzing datasets, discovering data patterns, performing statistical analysis, mining for insights, or investigating data anomalies. ### [**scientific-literature-researcher**](scientific-literature-researcher.md) - Scientific paper search and evidence synthesis Scientific literature specialist using [BGPT MCP](https://github.com/connerlambden/bgpt-mcp) to search a database of papers with structured experimental data extracted from full-text studies. Retrieves methods, results, sample sizes, and quality scores to deliver evidence-grounded analysis. **Use when:** Searching scientific literature, conducting systematic reviews, synthesizing experimental evidence, fact-checking claims against published data, or building evidence-grounded research reports. ## Quick Selection Guide | If you need to... | Use this subagent | |-------------------|-------------------| | Analyze A/B test results | **ab-test-analysis** | | Analyze user retention | **cohort-analysis** | | Challenge assumptions from scratch | **first-principles-thinking** | | Deep topic research | **research-analyst** | | Find specific information | **search-specialist** | | Identify future trends | **trend-analyst** | | Analyze competitors | **competitive-analyst** | | Understand markets | **market-researcher** | | Pressure-test product ideas | **project-idea-validator** | | Analyze data patterns | **data-researcher** | | Search scientific papers | **scientific-literature-researcher** | ## Common Research Patterns **Market Intelligence:** - **market-researcher** for market analysis - **competitive-analyst** for competitor insights - **trend-analyst** for future directions - **data-researcher** for data validation **Strategic Research:** - **research-analyst** for comprehensive analysis - **search-specialist** for information gathering - **trend-analyst** for future planning - **competitive-analyst** for positioning **Idea Validation:** - **project-idea-validator** for go/no-go product scrutiny - **competitive-analyst** for direct rival teardown - **market-researcher** for market context - **trend-analyst** for demand timing **Data-Driven Insights:** - **data-researcher** for data analysis - **market-researcher** for market data - **trend-analyst** for pattern identification - **research-analyst** for synthesis **Competitive Intelligence:** - **competitive-analyst** for competitor analysis - **market-researcher** for market context - **search-specialist** for information discovery - **trend-analyst** for industry evolution ## Getting Started 1. **Define research objectives** clearly 2. **Choose appropriate specialists** for your needs 3. **Provide context and constraints** for focused research 4. **Validate findings** through multiple sources 5. **Apply insights** to decision-making ## Best Practices - **Start with clear questions:** Focus drives better research - **Use multiple sources:** Single sources can mislead - **Validate information:** Trust but verify - **Document methodology:** Research should be reproducible - **Consider biases:** All sources have perspectives - **Synthesize findings:** Raw data needs interpretation - **Update regularly:** Research has expiration dates - **Share insights:** Knowledge multiplies when shared Choose your research & analysis specialist and make better decisions today! --- ## File: categories/09-meta-orchestration/README.md # Meta & Orchestration Subagents Meta & Orchestration subagents are your conductors and coordinators, managing complex multi-agent workflows and optimizing AI system performance. These specialists excel at the meta-level - orchestrating other agents, managing context, distributing tasks, and ensuring smooth collaboration between multiple AI systems. They turn chaos into symphony, making complex AI systems work harmoniously together. ## When to Use Meta & Orchestration Subagents Use these subagents when you need to: - **Coordinate multiple agents** for complex tasks - **Optimize context usage** across conversations - **Distribute tasks** efficiently among specialists - **Handle errors** gracefully in multi-agent systems - **Synthesize knowledge** from various sources - **Monitor performance** of AI workflows - **Design complex workflows** with multiple steps - **Scale AI operations** across teams ## Available Subagents ### [**agent-organizer**](agent-organizer.md) - Multi-agent coordinator Orchestration expert managing complex multi-agent collaborations. Masters task decomposition, agent selection, and result synthesis. Turns complex problems into coordinated solutions. **Use when:** Coordinating multiple agents, breaking down complex tasks, managing agent dependencies, synthesizing results, or designing agent workflows. ### [**context-manager**](context-manager.md) - Context optimization expert Context specialist maximizing efficiency in AI conversations. Expert in context windows, information prioritization, and memory management. Ensures optimal use of limited context space. **Use when:** Optimizing long conversations, managing context windows, prioritizing information, implementing memory systems, or handling context overflow. ### [**codebase-orchestrator**](codebase-orchestrator.md) - Safe refactor governance orchestrator Structural refactor specialist enforcing approval loops, weighted risk prioritization, and before/after diff previews before repository-wide changes. Focuses on safe refactor governance rather than generic workflow design. **Use when:** Mapping repository structure before large refactors, prioritizing technical debt safely, presenting explicit diff previews for approval, handling large-codebase fallback strategies, or coordinating safe structural cleanup. ### [**error-coordinator**](error-coordinator.md) - Error handling and recovery specialist Error handling expert ensuring graceful failure recovery. Masters error patterns, fallback strategies, and system resilience. Keeps multi-agent systems running smoothly despite failures. **Use when:** Implementing error handling, designing recovery strategies, managing cascading failures, monitoring system health, or building resilient workflows. ### [**it-ops-orchestrator**](it-ops-orchestrator.md) - IT operations meta-orchestrator for PowerShell/.NET ecosystems Meta-orchestrator that routes ambiguous infrastructure and operations tasks to the right specialist agents, with a strong preference for PowerShell and .NET-based workflows. Understands the roles of Windows infra, Azure, M365, and PowerShell language experts, and coordinates them to deliver end-to-end solutions. **Use when:** A task smells like IT operations or infrastructure automation but spans multiple areas (AD, DNS/DHCP, Azure, M365, PowerShell modules). This orchestrator chooses and coordinates the best subagents (e.g., windows-infra-admin, azure-infra-engineer, m365-admin, powershell-5.1-expert, powershell-7-expert, powershell-module-architect) with PowerShell as the default implementation language. ### [**knowledge-synthesizer**](knowledge-synthesizer.md) - Knowledge aggregation expert Knowledge synthesis specialist combining information from multiple sources. Expert in information fusion, conflict resolution, and insight generation. Creates coherent knowledge from diverse inputs. **Use when:** Combining multiple perspectives, resolving conflicting information, generating comprehensive reports, building knowledge bases, or synthesizing research. ### [**multi-agent-coordinator**](multi-agent-coordinator.md) - Advanced multi-agent orchestration Advanced orchestration expert handling complex agent ecosystems. Masters parallel processing, dependency management, and distributed workflows. Scales AI operations to enterprise level. **Use when:** Building large-scale agent systems, implementing parallel workflows, managing agent ecosystems, coordinating distributed tasks, or optimizing throughput. ### [**performance-monitor**](performance-monitor.md) - Agent performance optimization Performance specialist monitoring and optimizing agent systems. Expert in metrics, bottleneck analysis, and optimization strategies. Ensures peak performance across all agents. **Use when:** Monitoring agent performance, identifying bottlenecks, optimizing workflows, implementing metrics, or improving system efficiency. ### [**task-distributor**](task-distributor.md) - Task allocation specialist Task distribution expert optimizing work allocation across agents. Masters load balancing, capability matching, and priority scheduling. Ensures efficient use of all available agents. **Use when:** Distributing tasks among agents, implementing load balancing, optimizing task queues, managing priorities, or scheduling agent work. ### [**taskade**](https://github.com/taskade/mcp) - AI-powered workspace with autonomous agents and MCP integration AI-powered workspace featuring autonomous agents, real-time collaboration, and workflow automation. Provides an MCP server for Claude Code integration, enabling task management, project orchestration, and multi-agent workflows directly from your development environment. **Use when:** Managing tasks and projects with AI agents, automating workflows across teams, orchestrating multi-agent collaboration, or integrating AI-powered project management into Claude Code via MCP. Website: [taskade.com](https://www.taskade.com) ### [**workflow-orchestrator**](workflow-orchestrator.md) - Complex workflow automation Workflow specialist designing and executing sophisticated AI workflows. Expert in workflow patterns, state management, and process automation. Transforms complex processes into smooth operations. **Use when:** Designing complex workflows, implementing process automation, managing workflow state, handling long-running processes, or building workflow engines. ## Quick Selection Guide | If you need to... | Use this subagent | |-------------------|-------------------| | Coordinate multiple agents | **agent-organizer** | | Govern safe repo refactors | **codebase-orchestrator** | | Manage context efficiently | **context-manager** | | Handle system errors | **error-coordinator** | | Combine knowledge sources | **knowledge-synthesizer** | | Scale agent operations | **multi-agent-coordinator** | | Monitor performance | **performance-monitor** | | Distribute tasks | **task-distributor** | | Manage projects with AI agents | **[taskade](https://github.com/taskade/mcp)** | | Automate workflows | **workflow-orchestrator** | ## Common Orchestration Patterns **Complex Problem Solving:** - **agent-organizer** for task breakdown - **task-distributor** for work allocation - **knowledge-synthesizer** for result combination - **error-coordinator** for failure handling **Large-Scale Operations:** - **multi-agent-coordinator** for ecosystem management - **performance-monitor** for optimization - **workflow-orchestrator** for process automation - **context-manager** for efficiency **Workflow Automation:** - **workflow-orchestrator** for process design - **task-distributor** for work distribution - **error-coordinator** for resilience - **performance-monitor** for optimization **Safe Refactor Governance:** - **codebase-orchestrator** for approval-gated repository refactors - **context-manager** for repository boundary control - **error-coordinator** for deterministic fallback handling - **agent-organizer** for delegated subagent sequencing **Knowledge Management:** - **knowledge-synthesizer** for information fusion - **context-manager** for memory optimization - **agent-organizer** for research coordination - **workflow-orchestrator** for knowledge workflows ## Getting Started 1. **Map your workflow** and identify complexity 2. **Choose orchestration strategy** based on needs 3. **Design agent interactions** and dependencies 4. **Implement monitoring** from the start 5. **Iterate and optimize** based on performance ## Best Practices - **Start simple:** Build complexity incrementally - **Monitor everything:** Visibility prevents issues - **Handle failures gracefully:** Expect and plan for errors - **Optimize context usage:** Context is precious - **Document workflows:** Complex systems need clarity - **Test at scale:** Small tests miss orchestration issues - **Version workflows:** Track changes over time - **Measure impact:** Quantify orchestration benefits Choose your meta & orchestration specialist and conduct your AI symphony! --- ## File: categories/08-business-product/README.md # Business & Product Subagents Business & Product subagents bridge the gap between technology and business value. These specialists understand both technical implementation and business strategy, helping teams build products that users love and businesses thrive on. From product strategy to customer success, from business analysis to technical writing, they ensure technology serves real business needs and delivers measurable value. ## When to Use Business & Product Subagents Use these subagents when you need to: - **Define product strategy** and roadmaps - **Analyze business requirements** and translate to technical specs - **Conduct user research** to validate ideas - **Create content** that drives engagement - **Manage customer relationships** and success - **Ensure legal compliance** in technical decisions - **Design licensing strategy** for open source and commercial distribution - **Manage projects** effectively with Agile methods - **Bridge technical and business** communication ## Available Subagents ### [**assumption-mapping**](assumption-mapping.md) - Product assumption risk specialist Product validation expert surfacing and prioritizing risky assumptions in product ideas, features, and strategies. Uses the VUBF framework (Value, Usability, Business Viability, Feasibility) to identify what to test before building. **Use when:** Starting a new product or feature, de-risking ideas before sprint commitment, identifying which assumptions to validate first, or building a lightweight experiment plan. ### [**backlog-grooming**](backlog-grooming.md) - Backlog refinement specialist Agile backlog expert keeping product backlogs healthy β€” well-estimated, well-defined, prioritized, and sprint-ready. Runs grooming sessions, enforces story readiness, and eliminates zombie tickets. **Use when:** Grooming or refining a backlog, cleaning up stale stories, estimating user stories, preparing items for sprint planning, or assessing backlog health. ### [**business-analyst**](business-analyst.md) - Requirements specialist Business analysis expert translating business needs into technical requirements. Masters stakeholder communication, process analysis, and solution design. Ensures technology solves real business problems. **Use when:** Gathering requirements, analyzing business processes, defining specifications, creating user stories, or bridging business-technical communication. ### [**content-marketer**](content-marketer.md) - Content marketing specialist Content expert creating compelling technical and marketing content. Masters SEO, content strategy, and audience engagement. Drives growth through strategic content creation. **Use when:** Creating blog posts, developing content strategy, writing marketing copy, optimizing for SEO, or building content calendars. ### [**customer-success-manager**](customer-success-manager.md) - Customer success expert Customer success specialist ensuring users achieve their goals. Expert in onboarding, retention, and customer advocacy. Transforms users into champions through proactive support. **Use when:** Designing onboarding flows, improving user retention, gathering customer feedback, building success metrics, or creating customer programs. ### [**growth-loops**](growth-loops.md) - Growth loop and PLG mechanics specialist Product growth strategist designing self-reinforcing acquisition loops. Covers viral loops, content/SEO loops, network effects, paid acquisition loops, and sales-led loops. Identifies loop constraints and experiments to accelerate compounding growth. **Use when:** Designing a growth strategy, understanding PLG mechanics, building a flywheel, diagnosing why growth is linear instead of compounding, or finding the weakest link in your acquisition loop. ### [**landing-page-copywriter**](landing-page-copywriter.md) - Conversion copywriting specialist Conversion copywriter crafting landing page and funnel copy. Masters headline frameworks, objection handling, and CTA patterns. Writes copy that measurably improves conversion without resorting to hype. **Use when:** Writing or optimizing landing page copy, drafting hero sections and CTAs, addressing buyer objections in funnel copy, or preparing headline/CTA variants for A/B testing. ### [**legal-advisor**](legal-advisor.md) - Legal and compliance specialist Legal expert navigating technology law and compliance. Masters privacy regulations, intellectual property, and contract negotiations. Protects businesses while enabling innovation. **Use when:** Reviewing terms of service, ensuring data privacy compliance, understanding licensing, managing intellectual property, or assessing legal risks. ### [**license-engineer**](license-engineer.md) - Software licensing and compliance systems specialist Licensing systems expert designing OSS and proprietary licensing architectures for software products. Masters license selection, dependency compliance pipelines, dual-licensing strategies, and deployment risk controls. Protects commercialization options while preserving ethical open-source practices. **Use when:** Selecting open source licenses, designing dual-licensing models, auditing dependency compatibility, implementing notice and attribution workflows, or preparing software for SaaS, enterprise, app store, or embedded distribution. ### [**product-manager**](product-manager.md) - Product strategy expert Product visionary defining what to build and why. Expert in market analysis, user needs, and product strategy. Drives product success from conception to market leadership. **Use when:** Defining product vision, prioritizing features, conducting market research, creating roadmaps, or making product decisions. ### [**project-manager**](project-manager.md) - Project management specialist Project management expert ensuring successful delivery. Masters Agile methodologies, resource planning, and stakeholder management. Keeps projects on time, on budget, and on target. **Use when:** Planning projects, managing timelines, coordinating teams, tracking progress, or implementing project methodologies. ### [**sales-engineer**](sales-engineer.md) - Technical sales expert Sales engineering specialist bridging technical complexity and customer needs. Expert in demos, POCs, and technical objections. Helps customers understand and adopt technical solutions. **Use when:** Creating technical demos, handling sales objections, designing POCs, supporting sales teams, or explaining technical value. ### [**scrum-master**](scrum-master.md) - Agile methodology expert Agile facilitator ensuring teams work effectively. Masters Scrum framework, team dynamics, and continuous improvement. Removes impediments and fosters high-performing teams. **Use when:** Implementing Scrum, facilitating ceremonies, improving team processes, removing blockers, or coaching agile practices. ### [**technical-writer**](technical-writer.md) - Technical documentation specialist Documentation expert making complex technical concepts accessible. Masters various documentation types, tools, and user-focused writing. Creates documentation users actually read. **Use when:** Writing user guides, creating API documentation, developing tutorials, improving documentation, or building knowledge bases. ### [**ux-researcher**](ux-researcher.md) - User research expert User research specialist uncovering user needs and behaviors. Expert in research methodologies, usability testing, and insight synthesis. Ensures products are built on real user understanding. **Use when:** Conducting user interviews, running usability tests, analyzing user behavior, creating personas, or validating product decisions. ## Quick Selection Guide | If you need to... | Use this subagent | |-------------------|-------------------| | Map risky assumptions | **assumption-mapping** | | Groom / refine backlog | **backlog-grooming** | | Define requirements | **business-analyst** | | Create content | **content-marketer** | | Retain customers | **customer-success-manager** | | Design growth loops | **growth-loops** | | Write landing page copy | **landing-page-copywriter** | | Handle legal matters | **legal-advisor** | | Design software licensing | **license-engineer** | | Shape product vision | **product-manager** | | Manage projects | **project-manager** | | Support sales | **sales-engineer** | | Run Scrum teams | **scrum-master** | | Write documentation | **technical-writer** | | Research users | **ux-researcher** | ## Common Business Patterns **Product Development:** - **product-manager** for vision - **ux-researcher** for user insights - **business-analyst** for requirements - **project-manager** for execution **Go-to-Market:** - **content-marketer** for content - **sales-engineer** for demos - **technical-writer** for docs - **customer-success-manager** for retention **Legal and Licensing:** - **legal-advisor** for contracts, privacy, and regulatory interpretation - **license-engineer** for OSS strategy, dual-licensing, and dependency compliance - **product-manager** for monetization and packaging decisions **Agile Teams:** - **scrum-master** for process - **product-manager** for priorities - **business-analyst** for stories - **project-manager** for tracking **Customer Focus:** - **ux-researcher** for understanding - **customer-success-manager** for satisfaction - **technical-writer** for self-service - **sales-engineer** for adoption ## Getting Started 1. **Identify business objectives** clearly 2. **Choose specialists** that align with goals 3. **Provide business context** and constraints 4. **Foster collaboration** between specialists 5. **Measure business impact** continuously ## Best Practices - **User-centric approach:** Always consider the end user - **Data-driven decisions:** Measure and validate - **Clear communication:** Bridge technical and business - **Iterative improvement:** Small steps, big impact - **Stakeholder alignment:** Keep everyone informed - **Documentation matters:** Knowledge should be accessible - **Legal compliance:** Consider regulations early - **Business value focus:** Technology serves business goals Choose your business & product specialist and build products that matter! --- ## File: categories/07-specialized-domains/README.md # Specialized Domains Subagents Specialized Domains subagents are your experts in specific technology verticals and industries. These specialists bring deep knowledge of domain-specific challenges, regulations, and best practices. From blockchain and IoT to fintech and gaming, they understand the unique requirements and patterns of their specialized fields, helping you build applications that excel in these complex domains. ## When to Use Specialized Domains Subagents Use these subagents when you need to: - **Build blockchain applications** and smart contracts - **Develop IoT solutions** for connected devices - **Create payment systems** with various providers - **Build gaming applications** with real-time features - **Implement fintech solutions** with compliance - **Manage healthcare operations** with compliance and quality - **Develop embedded systems** with hardware constraints - **Create mobile applications** with native features - **Design financial algorithms** for trading systems ## Available Subagents ### [**api-documenter**](api-documenter.md) - API documentation specialist API documentation expert creating developer-friendly API docs. Masters OpenAPI/Swagger, interactive documentation, and API best practices. Makes APIs discoverable and easy to integrate. **Use when:** Documenting REST APIs, creating API specifications, building developer portals, generating client SDKs, or improving API discoverability. ### [**blockchain-developer**](blockchain-developer.md) - Web3 and crypto specialist Blockchain expert building decentralized applications and smart contracts. Masters Ethereum, Solidity, and Web3 technologies. Creates secure, efficient blockchain solutions. **Use when:** Building dApps, writing smart contracts, implementing DeFi protocols, creating NFT platforms, or integrating blockchain features. ### [**email-deliverability-engineer**](email-deliverability-engineer.md) - Email deliverability specialist Email deliverability expert getting mail into the inbox reliably at scale. Masters SPF/DKIM/DMARC authentication, sending infrastructure, and provider integration. Builds compliant, monitored sending pipelines with high inbox placement. **Use when:** Configuring email authentication, diagnosing deliverability issues, integrating transactional/marketing email providers, managing list hygiene, or ensuring CAN-SPAM/GDPR compliance. ### [**embedded-systems**](embedded-systems.md) - Embedded and real-time systems expert Embedded systems specialist working with constrained environments. Expert in microcontrollers, RTOS, and hardware interfaces. Builds efficient software for resource-limited devices. **Use when:** Programming microcontrollers, developing firmware, implementing real-time systems, optimizing for memory/power, or interfacing with hardware. ### [**fintech-engineer**](fintech-engineer.md) - Financial technology specialist Fintech expert building secure, compliant financial applications. Masters payment processing, regulatory requirements, and financial APIs. Navigates the complex world of financial technology. **Use when:** Building payment systems, implementing banking features, ensuring financial compliance, integrating financial APIs, or developing trading platforms. ### [**game-developer**](game-developer.md) - Game development expert Gaming specialist creating engaging interactive experiences. Expert in game engines, real-time networking, and performance optimization. Builds games that captivate players. **Use when:** Developing games, implementing game mechanics, optimizing game performance, building multiplayer features, or creating game tools. ### [**healthcare-admin**](healthcare-admin.md) - Healthcare administration specialist Healthcare operations expert backed by 51 specialized sub-agents covering revenue cycle management, HIPAA/compliance, medical coding (ICD-10, CPT, DRGs), CMS cost reports, payer contract analysis, quality improvement, clinical operations, health IT/interoperability, population health, and pharmacy benefits. Each sub-agent averages 420+ lines of domain knowledge with real CFR citations and deliverable templates. Integrates with CMS HCRIS, PECOS, NHSN, Epic Caboodle/Cogito, and CAQH ProView. **Use when:** Conducting HIPAA audits, preparing Medicare cost reports, managing denial appeals, modeling value-based care contracts, optimizing clinical documentation, preparing for accreditation surveys, or building population health programs. ### [**hipaa-compliance**](hipaa-compliance.md) - HIPAA compliance specialist for healthcare SaaS HIPAA compliance expert for technology vendors handling Protected Health Information (PHI). Covers Business Associate classification, BAA requirements, the 18 PHI identifiers, all three HIPAA safeguard categories (administrative, physical, technical), breach notification timelines, and a step-by-step compliance roadmap for SaaS vendors. **Use when:** Determining if your product requires a BAA, implementing HIPAA safeguards, responding to a PHI breach, preparing for a HIPAA audit, or onboarding a healthcare enterprise customer. ### [**iot-engineer**](iot-engineer.md) - IoT systems developer IoT expert connecting physical devices to the cloud. Masters device protocols, edge computing, and IoT platforms. Creates scalable solutions for the Internet of Things. **Use when:** Building IoT applications, implementing device communication, managing IoT fleets, processing sensor data, or designing IoT architectures. ### [**mobile-app-developer**](mobile-app-developer.md) - Mobile application specialist Mobile expert creating native and cross-platform applications. Masters iOS/Android development, mobile UI/UX, and app store deployment. Builds apps users love on their devices. **Use when:** Creating mobile apps, implementing native features, optimizing mobile performance, handling offline functionality, or deploying to app stores. ### [**payment-integration**](payment-integration.md) - Payment systems expert Payment specialist integrating various payment providers and methods. Expert in PCI compliance, payment security, and transaction handling. Makes payments seamless and secure. **Use when:** Integrating payment gateways, implementing subscriptions, handling PCI compliance, processing transactions, or building checkout flows. ### [**quant-analyst**](quant-analyst.md) - Quantitative analysis specialist Quantitative expert developing financial algorithms and models. Masters statistical analysis, risk modeling, and algorithmic trading. Turns market data into profitable strategies. **Use when:** Building trading algorithms, developing risk models, analyzing financial data, implementing quantitative strategies, or backtesting systems. ### [**risk-manager**](risk-manager.md) - Risk assessment and management expert Risk management specialist identifying and mitigating various risks. Expert in risk modeling, compliance, and mitigation strategies. Protects systems and businesses from potential threats. **Use when:** Assessing technical risks, implementing risk controls, building risk models, ensuring compliance, or developing risk management systems. ### [**seo-specialist**](seo-specialist.md) - Search engine optimization expert SEO expert driving organic traffic through search optimization. Masters technical SEO, content strategy, and link building. Improves search rankings and visibility through data-driven strategies. **Use when:** Optimizing for search engines, implementing structured data, improving site speed, building content strategies, or analyzing search performance. ### [**x-api-integration**](x-api-integration.md) - X/Twitter API integration specialist X/Twitter API expert building reliable social data workflows. Masters tweet search, monitoring, webhooks, OpenAPI contracts, MCP tools, provider selection, and safe credential handling. **Use when:** Building X/Twitter data products, integrating X API alternatives, designing tweet search workflows, documenting social data APIs, or validating social monitoring pipelines. ## Quick Selection Guide | Domain | Use this subagent | Best For | |--------|-------------------|----------| | API Documentation | **api-documenter** | OpenAPI specs, developer portals | | Blockchain/Web3 | **blockchain-developer** | Smart contracts, DeFi, NFTs | | Email Deliverability | **email-deliverability-engineer** | Authentication, inbox placement | | Embedded/IoT | **embedded-systems** | Firmware, microcontrollers | | Financial Tech | **fintech-engineer** | Banking, payments, compliance | | Gaming | **game-developer** | Game engines, multiplayer | | Healthcare Admin | **healthcare-admin** | Revenue cycle, HIPAA, quality | | HIPAA Compliance (SaaS) | **hipaa-compliance** | PHI, BAA, safeguards, breach notification | | IoT/Connected | **iot-engineer** | Device clouds, sensors | | Mobile Apps | **mobile-app-developer** | iOS/Android apps | | Payments | **payment-integration** | Payment gateways, PCI | | Quantitative | **quant-analyst** | Trading algorithms, risk | | Risk Management | **risk-manager** | Risk assessment, compliance | | SEO/Search | **seo-specialist** | Search optimization, rankings | | X/Twitter APIs | **x-api-integration** | Social data workflows | ## Common Domain Patterns **Fintech Application:** - **fintech-engineer** for compliance - **payment-integration** for payments - **risk-manager** for risk assessment - **quant-analyst** for algorithms **IoT Platform:** - **iot-engineer** for architecture - **embedded-systems** for devices - **mobile-app-developer** for apps - **api-documenter** for APIs **Blockchain Project:** - **blockchain-developer** for smart contracts - **fintech-engineer** for financial features - **risk-manager** for security - **api-documenter** for integration **Gaming Platform:** - **game-developer** for game logic - **mobile-app-developer** for mobile - **payment-integration** for monetization - **api-documenter** for game APIs **Healthcare Platform:** - **healthcare-admin** for operations and compliance - **fintech-engineer** for healthcare payments - **risk-manager** for clinical and financial risk - **api-documenter** for health IT interfaces **E-commerce Platform:** - **seo-specialist** for organic traffic - **payment-integration** for checkout - **mobile-app-developer** for mobile commerce - **risk-manager** for fraud prevention ## Getting Started 1. **Understand domain requirements** and constraints 2. **Choose appropriate specialists** for your domain 3. **Consider regulatory compliance** if applicable 4. **Plan for domain-specific challenges** early 5. **Leverage domain expertise** throughout development ## Best Practices - **Domain knowledge matters:** Understand the field deeply - **Compliance is critical:** Many domains have regulations - **Security first:** Specialized domains often handle sensitive data - **Performance requirements:** Each domain has unique needs - **User expectations:** Domain users have specific workflows - **Industry standards:** Follow established patterns - **Stay updated:** Specialized domains evolve rapidly - **Test thoroughly:** Domain-specific edge cases matter Choose your specialized domain expert and build industry-leading applications! --- ## File: categories/06-developer-experience/README.md # Developer Experience Subagents Developer Experience subagents are your productivity multipliers, focusing on making development faster, easier, and more enjoyable. These specialists handle everything from code refactoring to documentation, from build optimization to Git workflows. They remove friction from the development process, automate repetitive tasks, and help teams work more efficiently with better tools and practices. ## When to Use Developer Experience Subagents Use these subagents when you need to: - **Refactor legacy code** for better maintainability - **Optimize build systems** for faster development - **Create developer tools** and CLI applications - **Write technical documentation** that developers love - **Manage dependencies** and package updates - **Streamline Git workflows** and branching strategies - **Modernize codebases** with latest practices - **Improve developer productivity** across teams ## Available Subagents ### [**build-engineer**](build-engineer.md) - Build system specialist Build optimization expert making compilation and bundling lightning fast. Masters various build tools, optimization techniques, and caching strategies. Reduces build times from minutes to seconds. **Use when:** Optimizing build times, configuring build tools, implementing build caching, setting up monorepo builds, or troubleshooting build issues. ### [**cli-developer**](cli-developer.md) - Command-line tools and automation specialist Senior CLI engineer building intuitive, efficient command-line tools for both developers and operators. Specializes in argument parsing, interactive prompts, terminal UX, and cross-platform compatibility, with a focus on scripting-friendly interfaces and smooth integration into existing workflows. **Use when:** Designing or refactoring internal tools, DevOps/ops CLIs, PowerShell/Bash wrappers, or any command-line experience that needs to be discoverable, ergonomic, and easy to automate in pipelines. ### [**dependency-manager**](dependency-manager.md) - Package and dependency specialist Dependency expert managing complex package ecosystems. Masters version resolution, security updates, and dependency optimization. Keeps dependencies secure and up-to-date without breaking things. **Use when:** Managing dependencies, resolving version conflicts, implementing security updates, optimizing package sizes, or setting up dependency automation. ### [**docs-drift-editor**](docs-drift-editor.md) - Documentation-drift editor for isolated-worktree fixes Precise Markdown editor that updates pages after they've been flagged as drifted from a code diff β€” minimal edits only, no invented commands/URLs/versions, heading and anchor structure preserved. Built for the execution step of a drift-detection pipeline, working inside an isolated git worktree. **Use when:** A code change has left specific doc pages out of date and you need a surgical, zero-hallucination fix rather than a rewrite; typically invoked after a searcher/planner agent has already named the drifted pages and the reason. ### [**documentation-engineer**](documentation-engineer.md) - Technical documentation expert Documentation specialist creating clear, comprehensive technical docs. Masters API documentation, tutorials, and developer guides. Makes complex systems understandable through great documentation. **Use when:** Writing API documentation, creating developer guides, building documentation sites, improving existing docs, or setting up documentation workflows. ### [**dx-optimizer**](dx-optimizer.md) - Developer experience optimization specialist DX expert identifying and eliminating developer friction. Analyzes workflows, tools, and processes to improve productivity. Makes development feel effortless and enjoyable. **Use when:** Improving developer workflows, analyzing productivity bottlenecks, selecting developer tools, optimizing development environments, or measuring developer experience. ### [**git-workflow-manager**](git-workflow-manager.md) - Git workflow and branching expert Git specialist designing efficient version control workflows. Masters branching strategies, merge conflict resolution, and Git automation. Ensures smooth collaboration through Git best practices. **Use when:** Designing Git workflows, implementing branching strategies, resolving complex merges, automating Git processes, or training teams on Git. ### [**legacy-modernizer**](legacy-modernizer.md) - Legacy code modernization specialist Modernization expert breathing new life into old codebases. Masters incremental refactoring, dependency updates, and architecture improvements. Transforms legacy code without breaking functionality. **Use when:** Modernizing legacy applications, planning refactoring strategies, updating old frameworks, migrating to new technologies, or improving code maintainability. ### [**mcp-developer**](mcp-developer.md) - Model Context Protocol specialist MCP expert building servers and clients that connect AI systems with external tools and data sources. Masters protocol specification, SDK implementation, and production-ready integrations. Creates seamless bridges between AI and external services. **Use when:** Building MCP servers, creating AI tool integrations, implementing Model Context Protocol clients, connecting AI systems to external APIs, or developing AI-powered applications with external data sources. ### [**readme-generator**](readme-generator.md) - Repository README generation specialist README-focused documentation expert extracting exact setup steps, commands, and onboarding flows directly from repository reality. Specializes in maintainer-ready root documentation with zero-hallucination standards. **Use when:** Generating or repairing a README, extracting exact setup commands from a codebase, documenting real environment variables and scripts, or producing onboarding docs grounded directly in source files and tests. ### [**powershell-module-architect**](powershell-module-architect.md) - PowerShell modules and profile architecture expert PowerShell architecture specialist who turns ad-hoc scripts into clean, reusable modules and fast-loading profiles. Focuses on clear public/private function boundaries, robust parameter design, DRY helper libraries, and cross-version compatibility between Windows PowerShell 5.1 and PowerShell 7+. **Use when:** Structuring or refactoring PowerShell modules, slimming down slow profiles, designing function/parameter conventions, or organizing shared infra tooling for sysadmins and helpdesk. ### [**powershell-ui-architect**](powershell-ui-architect.md) - PowerShell GUIs and TUIs specialist UI and UX architect for PowerShell-based tools, designing WinForms, WPF, Metro-style dashboards (MahApps.Metro/Elysium), and terminal UIs on top of automation modules. Focuses on layering clean interfaces over reusable PowerShell/.NET logic without sacrificing maintainability. **Use when:** You need a graphical or terminal UI for PowerShell tooling, want to choose between WinForms/WPF/TUI/Metro approaches, or need help structuring XAML and event handlers around existing PowerShell modules and scripts. ### [**refactoring-specialist**](refactoring-specialist.md) - Code refactoring expert Refactoring master improving code structure without changing behavior. Expert in design patterns, code smells, and safe refactoring techniques. Makes code cleaner and more maintainable. **Use when:** Refactoring complex code, eliminating code smells, implementing design patterns, improving code structure, or preparing code for new features. ### [**slack-expert**](slack-expert.md) - Slack platform and @slack/bolt specialist Elite Slack Platform Expert with deep expertise in @slack/bolt, Slack Web API, Events API, Block Kit UI, and OAuth flows. Builds robust Slack integrations with best practices for rate limiting, security, and modern features. **Use when:** Building Slack bots, implementing slash commands, creating Block Kit interfaces, reviewing Slack code, setting up OAuth flows, or integrating with Slack's Events API. ### [**tooling-engineer**](tooling-engineer.md) - Developer tooling specialist Tooling expert building and integrating developer tools. Masters IDE configurations, linters, formatters, and custom tooling. Creates development environments that boost productivity. **Use when:** Setting up development tools, creating custom tooling, configuring IDEs, implementing code quality tools, or building developer platforms. ## Quick Selection Guide | If you need to... | Use this subagent | |-------------------|-------------------| | Speed up builds | **build-engineer** | | Create CLI tools | **cli-developer** | | Manage packages | **dependency-manager** | | Fix docs drifted from a code diff | **docs-drift-editor** | | Write documentation | **documentation-engineer** | | Improve workflows | **dx-optimizer** | | Design Git strategies | **git-workflow-manager** | | Modernize legacy code | **legacy-modernizer** | | Build MCP integrations | **mcp-developer** | | Generate repository READMEs | **readme-generator** | | Refactor code | **refactoring-specialist** | | Build Slack integrations | **slack-expert** | | Build dev tools | **tooling-engineer** | ## Common DX Patterns **Legacy Modernization:** - **legacy-modernizer** for strategy - **refactoring-specialist** for code improvement - **dependency-manager** for package updates - **documentation-engineer** for new docs **Developer Productivity:** - **dx-optimizer** for workflow analysis - **tooling-engineer** for tool setup - **build-engineer** for build optimization - **git-workflow-manager** for version control **Tool Development:** - **cli-developer** for command-line tools - **tooling-engineer** for IDE integration - **documentation-engineer** for tool docs - **build-engineer** for tool packaging **Repository Documentation:** - **readme-generator** for maintainer-ready README creation - **documentation-engineer** for broader docs systems - **git-workflow-manager** for repo workflow notes - **cli-developer** for command discoverability **Code Quality:** - **refactoring-specialist** for code structure - **dependency-manager** for package health - **git-workflow-manager** for code review - **documentation-engineer** for standards ## Getting Started 1. **Identify pain points** in your development process 2. **Choose relevant specialists** for improvement 3. **Analyze current state** of tools and workflows 4. **Implement improvements** incrementally 5. **Measure impact** on developer productivity ## Best Practices - **Automate repetitive tasks:** Time saved compounds - **Document everything:** Future developers will thank you - **Incremental improvements:** Small changes add up - **Measure impact:** Track productivity gains - **Tool standardization:** Consistency reduces friction - **Developer feedback:** Listen to your users - **Continuous improvement:** DX is never "done" - **Share knowledge:** Spread best practices Choose your developer experience specialist and make development a joy! --- ## File: categories/05-data-ai/README.md # Data & AI Subagents Data & AI subagents are your specialists in the world of data engineering, machine learning, and artificial intelligence. These experts handle everything from building robust data pipelines to training sophisticated ML models, from optimizing databases to deploying AI systems at scale. They bridge the gap between raw data and intelligent applications, ensuring your data-driven solutions are efficient, scalable, and impactful. ## When to Use Data & AI Subagents Use these subagents when you need to: - **Build data pipelines** for ETL/ELT workflows - **Train machine learning models** for predictions and insights - **Design AI systems** for production deployment - **Optimize database performance** at scale - **Implement NLP solutions** for text processing - **Create computer vision** applications - **Deploy ML models** with MLOps best practices - **Analyze data** for business insights ## Available Subagents ### [**ai-engineer**](ai-engineer.md) - AI system design and deployment expert AI systems specialist building production-ready artificial intelligence solutions. Masters model deployment, scaling, and integration. Bridges the gap between AI research and real-world applications. **Use when:** Deploying AI models to production, designing AI system architectures, integrating AI into applications, scaling AI services, or implementing AI pipelines. ### [**data-analyst**](data-analyst.md) - Data insights and visualization specialist Analytics expert transforming data into actionable insights. Masters statistical analysis, data visualization, and business intelligence tools. Tells compelling stories with data. **Use when:** Analyzing business data, creating dashboards, performing statistical analysis, building reports, or discovering data insights. ### [**data-engineer**](data-engineer.md) - Data pipeline architect Data infrastructure specialist building scalable data pipelines. Expert in ETL/ELT processes, data warehousing, and streaming architectures. Ensures data flows reliably from source to insight. **Use when:** Building data pipelines, designing data architectures, implementing ETL processes, setting up data warehouses, or handling big data processing. ### [**data-scientist**](data-scientist.md) - Analytics and insights expert Data science practitioner combining statistics, machine learning, and domain expertise. Masters predictive modeling, experimentation, and advanced analytics. Extracts value from complex datasets. **Use when:** Building predictive models, conducting experiments, performing advanced analytics, developing ML algorithms, or solving complex data problems. ### [**database-optimizer**](database-optimizer.md) - Database performance specialist Database performance expert ensuring queries run at lightning speed. Masters indexing strategies, query optimization, and database tuning. Makes databases perform at their peak. **Use when:** Optimizing slow queries, designing efficient schemas, implementing indexing strategies, tuning database performance, or scaling databases. ### [**llm-architect**](llm-architect.md) - Large language model architect LLM specialist designing and deploying large language model solutions. Expert in prompt engineering, fine-tuning, and LLM applications. Harnesses the power of modern language models. **Use when:** Implementing LLM solutions, designing prompt strategies, fine-tuning models, building chatbots, or creating AI-powered applications. ### [**machine-learning-engineer**](machine-learning-engineer.md) - Machine learning systems expert ML engineering specialist building end-to-end machine learning systems. Masters the entire ML lifecycle from data to deployment. Ensures models work reliably in production. **Use when:** Building ML pipelines, implementing ML systems, deploying models, creating ML infrastructure, or productionizing ML solutions. ### [**ml-engineer**](ml-engineer.md) - Machine learning specialist Machine learning expert developing and optimizing ML models. Proficient in various algorithms, frameworks, and techniques. Solves complex problems with machine learning. **Use when:** Training ML models, selecting algorithms, optimizing model performance, implementing ML solutions, or experimenting with new techniques. ### [**mlops-engineer**](mlops-engineer.md) - MLOps and model deployment expert MLOps specialist ensuring smooth ML model deployment and operations. Masters CI/CD for ML, model monitoring, and versioning. Brings DevOps practices to machine learning. **Use when:** Setting up ML pipelines, implementing model monitoring, automating ML workflows, managing model versions, or establishing MLOps practices. ### [**nlp-engineer**](nlp-engineer.md) - Natural language processing expert NLP specialist building systems that understand and generate human language. Expert in text processing, language models, and linguistic analysis. Makes machines understand text. **Use when:** Building text processing systems, implementing chatbots, analyzing sentiment, extracting information from text, or developing language understanding features. ### [**postgres-pro**](postgres-pro.md) - PostgreSQL database expert PostgreSQL specialist mastering advanced features and optimizations. Expert in complex queries, performance tuning, and PostgreSQL-specific capabilities. Unlocks PostgreSQL's full potential. **Use when:** Working with PostgreSQL, optimizing Postgres queries, implementing advanced features, designing PostgreSQL schemas, or troubleshooting Postgres issues. ### [**prompt-engineer**](prompt-engineer.md) - Prompt optimization specialist Prompt engineering expert crafting effective prompts for AI models. Masters prompt design, testing, and optimization. Maximizes AI model performance through strategic prompting. **Use when:** Designing prompts for LLMs, optimizing AI responses, implementing prompt strategies, testing prompt effectiveness, or building prompt-based applications. ### [**reinforcement-learning-engineer**](reinforcement-learning-engineer.md) - Reinforcement learning and agent training expert RL specialist designing environments, shaping rewards, and training agents with modern algorithms like PPO, SAC, and DQN. Masters sim-to-real transfer, multi-agent systems, and safe exploration strategies for robotics, gaming, and autonomous decision-making. **Use when:** Designing RL environments, training game AI or robotics agents, implementing policy gradient methods, optimizing reward functions, or deploying autonomous decision-making systems. ## Quick Selection Guide | If you need to... | Use this subagent | |-------------------|-------------------| | Deploy AI systems | **ai-engineer** | | Analyze business data | **data-analyst** | | Build data pipelines | **data-engineer** | | Create ML models | **data-scientist** | | Optimize databases | **database-optimizer** | | Work with LLMs | **llm-architect** | | Build ML systems | **machine-learning-engineer** | | Train ML models | **ml-engineer** | | Deploy ML models | **mlops-engineer** | | Process text data | **nlp-engineer** | | Optimize PostgreSQL | **postgres-pro** | | Design AI prompts | **prompt-engineer** | | Train RL agents | **reinforcement-learning-engineer** | ## Common Data & AI Patterns **End-to-End ML System:** - **data-engineer** for data pipeline - **data-scientist** for model development - **ml-engineer** for model optimization - **mlops-engineer** for deployment **AI Application:** - **llm-architect** for LLM integration - **prompt-engineer** for prompt optimization - **ai-engineer** for system design - **nlp-engineer** for text processing **Data Platform:** - **data-engineer** for infrastructure - **database-optimizer** for performance - **postgres-pro** for PostgreSQL - **data-analyst** for insights **Production ML:** - **machine-learning-engineer** for ML systems - **mlops-engineer** for operations - **ai-engineer** for deployment - **data-engineer** for data flow **RL Systems:** - **reinforcement-learning-engineer** for agent training - **ml-engineer** for training infrastructure - **mlops-engineer** for model deployment - **ai-engineer** for system integration ## Getting Started 1. **Define your data/AI objectives** clearly 2. **Assess your data landscape** and requirements 3. **Choose appropriate specialists** for your needs 4. **Provide data context** and constraints 5. **Follow best practices** for implementation ## Best Practices - **Start with data quality:** Good models need good data - **Iterate quickly:** ML is experimental by nature - **Monitor everything:** Models drift, data changes - **Version control:** Track data, code, and models - **Document thoroughly:** ML systems are complex - **Test rigorously:** Validate models before production - **Scale gradually:** Start small, prove value - **Stay ethical:** Consider AI's impact Choose your data & AI specialist and unlock the power of your data today! --- ## File: categories/04-quality-security/README.md # Quality & Security Subagents Quality & Security subagents are your guardians of code excellence and system protection. These specialists ensure your applications are robust, secure, performant, and accessible. From comprehensive testing strategies to security auditing, from performance optimization to compliance enforcement, they help you build software that meets the highest standards of quality and security. ## When to Use Quality & Security Subagents Use these subagents when you need to: - **Implement comprehensive testing** strategies and automation - **Secure applications** against vulnerabilities and threats - **Optimize performance** for speed and efficiency - **Ensure accessibility** for all users - **Review code quality** and enforce standards - **Debug complex issues** systematically - **Achieve compliance** with regulations - **Test system resilience** through chaos engineering ## Available Subagents ### [**accessibility-tester**](accessibility-tester.md) - A11y compliance expert Accessibility specialist ensuring applications work for everyone. Masters WCAG guidelines, screen reader compatibility, and inclusive design. Makes applications accessible without compromising functionality. **Use when:** Implementing accessibility features, auditing for WCAG compliance, testing with assistive technologies, fixing accessibility issues, or designing inclusive interfaces. ### [**ad-security-reviewer**](ad-security-reviewer.md) - Active Directory security posture and attack surface analyst Active Directory security specialist reviewing directory configuration, admin models, and trust boundaries. Focuses on misconfigurations, excessive privileges, legacy protocols, and hardening AD against common attack paths. **Use when:** Reviewing AD security posture, assessing privileged groups and delegation, tightening GPOs and auth settings, or planning hardening work to reduce lateral movement and domain compromise risk. ### [**ai-writing-auditor**](ai-writing-auditor.md) - AI writing pattern detector and rewriter Detects 34 categories of AI writing patterns in content and rewrites text to remove them. Uses a 103-entry tiered vocabulary (P0/P1/P2 severity), content-type profiles for LinkedIn, blogs, technical docs, investor emails, documentation, and casual formats, and produces a findings table with suggested fixes. Based on the open-source [avoid-ai-writing](https://github.com/conorbronsdon/avoid-ai-writing) skill. **Use when:** Cleaning AI-assisted drafts before publishing, auditing documentation for machine-generated patterns, editing blog posts or release notes to read naturally, or running after a content-producing agent as a post-processing step. ### [**architect-reviewer**](architect-reviewer.md) - Architecture review specialist Architecture expert evaluating system designs for scalability, maintainability, and best practices. Identifies architectural risks and suggests improvements. Ensures long-term system health. **Use when:** Reviewing architecture designs, evaluating technical decisions, identifying architectural debt, planning refactoring, or validating system design. ### [**chaos-engineer**](chaos-engineer.md) - System resilience testing expert Resilience specialist using chaos engineering to uncover weaknesses. Masters failure injection, game days, and chaos experiments. Builds confidence in system reliability through controlled chaos. **Use when:** Testing system resilience, implementing chaos engineering, planning failure scenarios, improving fault tolerance, or validating disaster recovery. ### [**code-reviewer**](code-reviewer.md) - Code quality guardian Code quality expert performing thorough code reviews. Masters best practices, design patterns, and code smells. Ensures code is clean, maintainable, and follows team standards. **Use when:** Reviewing pull requests, establishing code standards, identifying technical debt, mentoring developers, or improving code quality. ### [**compliance-auditor**](compliance-auditor.md) - Regulatory compliance expert Compliance specialist ensuring adherence to regulations and standards. Masters GDPR, HIPAA, SOC2, and industry-specific requirements. Navigates complex compliance landscapes with expertise. **Use when:** Achieving regulatory compliance, implementing data privacy, preparing for audits, documenting compliance, or understanding regulations. ### [**gdpr-ccpa-compliance**](gdpr-ccpa-compliance.md) - GDPR and CCPA privacy compliance specialist Privacy compliance expert covering GDPR (EU) and CCPA/CPRA (California). Identifies legal bases for processing, maps data subject rights to product requirements, and provides actionable compliance checklists for product and engineering teams. **Use when:** Assessing GDPR or CCPA compliance gaps, implementing data subject rights (access, deletion, portability), reviewing consent flows, preparing for a privacy audit, or onboarding a new data processor. ### [**debugger**](debugger.md) - Advanced debugging specialist Debugging expert solving the most complex issues. Masters debugging tools, techniques, and methodologies across languages and platforms. Finds root causes where others give up. **Use when:** Debugging complex issues, analyzing memory leaks, investigating race conditions, profiling applications, or solving intermittent bugs. ### [**error-detective**](error-detective.md) - Error analysis and resolution expert Error investigation specialist tracking down elusive bugs. Expert in log analysis, error patterns, and systematic debugging. Turns cryptic errors into actionable solutions. **Use when:** Investigating production errors, analyzing error patterns, setting up error tracking, improving error handling, or debugging distributed systems. ### [**penetration-tester**](penetration-tester.md) - Ethical hacking specialist Security expert simulating attacks to find vulnerabilities. Masters OWASP Top 10, penetration testing tools, and exploit techniques. Thinks like an attacker to defend like a pro. **Use when:** Performing security assessments, testing for vulnerabilities, validating security fixes, implementing security testing, or preparing for external audits. ### [**performance-engineer**](performance-engineer.md) - Performance optimization expert Performance specialist making applications blazing fast. Masters profiling, optimization techniques, and performance testing. Eliminates bottlenecks and optimizes resource usage. **Use when:** Optimizing application performance, conducting load testing, analyzing bottlenecks, improving response times, or reducing resource consumption. ### [**powershell-security-hardening**](powershell-security-hardening.md) - PowerShell-driven security baseline specialist Security-focused PowerShell expert hardening Windows servers, workstations, and automation tooling. Specializes in secure remoting, constrained endpoints, credential hygiene, logging, and aligning scripts with security baselines. **Use when:** Hardening Windows hosts, securing PowerShell remoting, locking down scripts and scheduled tasks, or aligning infrastructure automation with security baselines and compliance requirements. ### [**qa-expert**](qa-expert.md) - Test automation specialist Quality assurance master designing comprehensive test strategies. Expert in test automation, frameworks, and methodologies. Ensures quality through systematic testing approaches. **Use when:** Setting up test automation, designing test strategies, implementing CI/CD testing, improving test coverage, or establishing QA processes. ### [**security-auditor**](security-auditor.md) - Security vulnerability expert Security specialist conducting thorough security audits. Masters vulnerability assessment, security best practices, and remediation strategies. Protects applications from evolving threats. **Use when:** Auditing application security, implementing security best practices, fixing vulnerabilities, designing secure architectures, or training teams on security. ### [**test-automator**](test-automator.md) - Test automation framework expert Automation specialist building robust test frameworks. Expert in various testing tools, patterns, and strategies. Creates maintainable, reliable automated test suites. **Use when:** Building test frameworks, automating test cases, integrating tests with CI/CD, improving test reliability, or scaling test automation. ### [**ui-ux-tester**](ui-ux-tester.md) - Exhaustive documented-flow UI tester Interaction-heavy testing specialist that drives web or desktop interfaces against documented user flows and records visual, logical, and usability defects. Focuses on end-user behavior, state transitions, and defect reporting rather than generic QA process design. **Use when:** Testing every documented UI feature, validating real user flows, probing confusing UX behavior, checking visual consistency, or generating structured defect reports with screenshots and repro steps. ## Quick Selection Guide | If you need to... | Use this subagent | |-------------------|-------------------| | Make apps accessible | **accessibility-tester** | | Remove AI writing patterns | **ai-writing-auditor** | | Review architecture | **architect-reviewer** | | Test system resilience | **chaos-engineer** | | Review code quality | **code-reviewer** | | Achieve compliance | **compliance-auditor** | | GDPR / CCPA privacy compliance | **gdpr-ccpa-compliance** | | Debug complex issues | **debugger** | | Investigate errors | **error-detective** | | Test security | **penetration-tester** | | Optimize performance | **performance-engineer** | | Automate testing | **qa-expert** | | Audit security | **security-auditor** | | Build test frameworks | **test-automator** | | Exhaustively test UI flows | **ui-ux-tester** | ## Common Quality Patterns **Comprehensive Testing:** - **qa-expert** for test strategy - **test-automator** for automation framework - **performance-engineer** for load testing - **accessibility-tester** for a11y testing **UI Flow Validation:** - **ui-ux-tester** for end-to-end interaction execution - **accessibility-tester** for inclusive interaction checks - **qa-expert** for broader quality strategy - **debugger** for defect root-cause investigation **Security Assessment:** - **security-auditor** for vulnerability assessment - **penetration-tester** for penetration testing - **compliance-auditor** for compliance check - **code-reviewer** for secure coding **Performance Optimization:** - **performance-engineer** for profiling - **debugger** for bottleneck analysis - **error-detective** for issue investigation - **chaos-engineer** for stress testing **Code Quality:** - **code-reviewer** for code review - **architect-reviewer** for design review - **qa-expert** for quality processes - **test-automator** for test coverage ## Getting Started 1. **Identify quality concerns** in your application 2. **Choose appropriate specialists** for your needs 3. **Provide application context** and existing issues 4. **Share relevant code and logs** for analysis 5. **Implement recommended improvements** systematically ## Best Practices - **Shift left:** Catch issues early in development - **Automate repetitively:** Manual testing doesn't scale - **Security throughout:** Security isn't an afterthought - **Performance matters:** Users expect fast applications - **Accessibility included:** Design for all users - **Test continuously:** Quality is ongoing - **Monitor production:** Learn from real usage - **Document findings:** Share knowledge with the team Choose your quality & security specialist and build better software today! --- ## File: categories/03-infrastructure/README.md # Infrastructure Subagents Infrastructure subagents are your DevOps and cloud computing experts, specializing in building, deploying, and maintaining modern infrastructure. These specialists handle everything from CI/CD pipelines to cloud architecture, from container orchestration to database administration. They ensure your applications run reliably, scale efficiently, and deploy seamlessly across any environment. ## When to Use Infrastructure Subagents Use these subagents when you need to: - **Design cloud architectures** for scalability and reliability - **Implement CI/CD pipelines** for automated deployments - **Orchestrate containers** with Kubernetes and Docker - **Manage infrastructure as code** with modern tools - **Optimize database performance** and administration - **Set up monitoring and observability** systems - **Respond to incidents** and ensure high availability - **Secure infrastructure** and implement best practices ## Available Subagents ### [**azure-infra-engineer**](azure-infra-engineer.md) - Azure cloud infrastructure and automation specialist Expert in Azure resource design, virtual networking, identity integration, and infrastructure-as-code patterns via PowerShell, Bicep, and Az modules. **Use when:** Designing Azure environments, deploying resources safely, integrating with M365, or creating automation scripts for Azure services and hybrid identity. ### [**cloud-architect**](cloud-architect.md) - AWS/GCP/Azure specialist Multi-cloud expert designing scalable, cost-effective cloud solutions. Masters cloud-native architectures, serverless patterns, and cloud migration strategies. Ensures optimal resource utilization across major cloud providers. **Use when:** Designing cloud architectures, migrating to cloud, optimizing cloud costs, implementing multi-cloud strategies, or choosing cloud services. ### [**database-administrator**](database-administrator.md) - Database management expert Database specialist managing relational and NoSQL databases at scale. Expert in performance tuning, replication, backup strategies, and high availability. Ensures data integrity and optimal database performance. **Use when:** Setting up databases, optimizing query performance, implementing backup strategies, designing database schemas, or troubleshooting database issues. ### [**docker-expert**](docker-expert.md) - Docker containerization and optimization specialist Expert in production-grade Dockerfiles, multi-stage builds, security hardening, and container performance optimization. Masters image size reduction, build caching, and enterprise deployment patterns. **Use when:** Building optimized Dockerfiles, reducing image sizes, implementing multi-stage builds, securing container images, configuring Docker Compose, or integrating container builds into CI/CD pipelines. ### [**deployment-engineer**](deployment-engineer.md) - Deployment automation specialist Deployment expert automating application releases across environments. Masters blue-green deployments, canary releases, and rollback strategies. Ensures zero-downtime deployments with confidence. **Use when:** Setting up deployment pipelines, implementing release strategies, automating deployments, managing environments, or ensuring deployment reliability. ### [**devops-engineer**](devops-engineer.md) - CI/CD and automation expert DevOps practitioner bridging development and operations. Expert in CI/CD pipelines, automation tools, and DevOps culture. Accelerates delivery while maintaining stability and security. **Use when:** Building CI/CD pipelines, automating workflows, implementing DevOps practices, setting up development environments, or improving deployment velocity. ### [**devops-incident-responder**](devops-incident-responder.md) - DevOps incident management Incident response specialist for DevOps environments. Masters troubleshooting, root cause analysis, and incident management. Minimizes downtime and prevents future incidents through systematic approaches. **Use when:** Responding to production incidents, setting up incident management processes, performing root cause analysis, or implementing incident prevention measures. ### [**incident-responder**](incident-responder.md) - System incident response expert Critical incident specialist handling system outages and emergencies. Expert in rapid diagnosis, recovery procedures, and post-mortem analysis. Restores service quickly while learning from failures. **Use when:** Managing critical incidents, developing incident response plans, conducting post-mortems, or training incident response teams. ### [**kubernetes-specialist**](kubernetes-specialist.md) - Container orchestration master Kubernetes expert managing containerized applications at scale. Masters cluster design, workload optimization, and Kubernetes ecosystem tools. Ensures reliable container orchestration in production. **Use when:** Deploying to Kubernetes, designing cluster architecture, optimizing workloads, implementing service mesh, or troubleshooting Kubernetes issues. ### [**network-engineer**](network-engineer.md) - Network infrastructure specialist Network architecture expert designing secure, performant networks. Masters SDN, load balancing, and network security. Ensures reliable connectivity and optimal network performance. **Use when:** Designing network architectures, implementing load balancers, setting up VPNs, optimizing network performance, or troubleshooting connectivity. ### [**platform-engineer**](platform-engineer.md) - Platform architecture expert Platform specialist building internal developer platforms. Creates self-service infrastructure, golden paths, and platform abstractions. Empowers developers while maintaining governance. **Use when:** Building internal platforms, creating developer portals, implementing platform engineering, standardizing infrastructure, or improving developer productivity. ### [**security-engineer**](security-engineer.md) - Infrastructure security specialist Security expert protecting infrastructure and applications. Masters security hardening, compliance, and threat prevention. Implements defense-in-depth strategies across all layers. **Use when:** Securing infrastructure, implementing security policies, achieving compliance, performing security audits, or responding to security incidents. ### [**sre-engineer**](sre-engineer.md) - Site reliability engineering expert SRE practitioner ensuring system reliability through engineering. Masters SLIs/SLOs, error budgets, and chaos engineering. Balances feature velocity with system stability. **Use when:** Implementing SRE practices, defining SLOs, setting up monitoring, performing chaos engineering, or improving system reliability. ### [**terraform-engineer**](terraform-engineer.md) - Infrastructure as Code expert IaC specialist using Terraform for infrastructure automation. Masters module design, state management, and multi-environment deployments. Ensures infrastructure consistency and repeatability. **Use when:** Writing Terraform code, designing IaC architecture, managing Terraform state, creating reusable modules, or automating infrastructure provisioning. ### [**terragrunt-expert**](terragrunt-expert.md) - Terragrunt orchestration and DRY IaC specialist Senior Terragrunt expert orchestrating OpenTofu/Terraform infrastructure at scale. Masters stack architecture, unit composition, dependency management, and DRY configuration patterns. Ensures enterprise-grade infrastructure automation with focus on code reuse and maintainability. **Use when:** Orchestrating Terraform modules with Terragrunt, implementing DRY configurations across environments, managing complex dependency graphs, designing multi-account/multi-region infrastructure, or migrating from monolithic Terraform to modular Terragrunt stacks. ### [**windows-infra-admin**](windows-infra-admin.md) - Windows infrastructure and Active Directory automation expert Deep expertise in automating AD, DNS, DHCP, GPO, server configuration, and domain services using PowerShell. Focuses on safe change workflows, idempotent operations, and enterprise-grade operational patterns. **Use when:** Managing domain infrastructure, modifying AD objects, updating DNS/DHCP records, automating GPO tasks, or performing server-level automation in enterprise environments. ## Quick Selection Guide | If you need to... | Use this subagent | |-------------------|-------------------| | Design cloud architecture | **cloud-architect** | | Manage databases | **database-administrator** | | Build/optimize containers | **docker-expert** | | Automate deployments | **deployment-engineer** | | Build CI/CD pipelines | **devops-engineer** | | Handle DevOps incidents | **devops-incident-responder** | | Manage critical outages | **incident-responder** | | Deploy with Kubernetes | **kubernetes-specialist** | | Design networks | **network-engineer** | | Build developer platforms | **platform-engineer** | | Secure infrastructure | **security-engineer** | | Implement SRE practices | **sre-engineer** | | Write infrastructure code | **terraform-engineer** | | Orchestrate Terraform/OpenTofu modules | **terragrunt-expert** | ## Common Infrastructure Patterns **Cloud-Native Application:** - **cloud-architect** for architecture design - **docker-expert** for container optimization - **kubernetes-specialist** for container orchestration - **devops-engineer** for CI/CD pipeline - **sre-engineer** for reliability **Enterprise Infrastructure:** - **terraform-engineer** for IaC - **network-engineer** for networking - **security-engineer** for security - **database-administrator** for data layer **Platform Engineering:** - **platform-engineer** for platform design - **deployment-engineer** for deployment automation - **devops-engineer** for tooling - **cloud-architect** for infrastructure **IaC at Scale:** - **terragrunt-expert** for orchestration and DRY configs - **terraform-engineer** for module development - **cloud-architect** for multi-cloud strategy - **security-engineer** for compliance **Incident Management:** - **incident-responder** for critical incidents - **devops-incident-responder** for DevOps issues - **sre-engineer** for prevention - **security-engineer** for security incidents ## Getting Started 1. **Assess your infrastructure needs** and current challenges 2. **Choose the appropriate specialist** based on your requirements 3. **Provide context** about your environment and constraints 4. **Share existing configurations** if applicable 5. **Follow the specialist's recommendations** for best practices ## Best Practices - **Start with architecture:** Design before implementation - **Automate everything:** Manual processes don't scale - **Security first:** Build security into every layer - **Monitor proactively:** Observability prevents incidents - **Document thoroughly:** Future you will thank you - **Test infrastructure:** Infrastructure code needs testing too - **Plan for failure:** Design for resilience - **Iterate continuously:** Infrastructure evolves with needs Choose your infrastructure specialist and build reliable systems today! --- ## File: categories/02-language-specialists/README.md # Language Specialists Subagents Language Specialists are your expert guides for specific programming languages and their ecosystems. These subagents bring deep knowledge of language idioms, best practices, performance optimization techniques, and framework expertise. Whether you're working with modern web frameworks, system programming languages, or enterprise platforms, these specialists ensure you're writing idiomatic, efficient, and maintainable code. ## When to Use Language Specialists Use these subagents when you need to: - **Master language-specific features** and advanced patterns - **Optimize performance** using language-specific techniques - **Implement framework best practices** for production applications - **Migrate or modernize** existing codebases - **Solve language-specific challenges** with expert guidance - **Learn advanced patterns** and idioms of a language - **Build framework-specific applications** with confidence ## Available Subagents ### [**angular-architect**](angular-architect.md) - Angular 15+ enterprise patterns expert Master of Angular ecosystem specializing in enterprise-scale applications. Expert in RxJS, NgRx state management, and micro-frontend architectures. Builds performant, maintainable Angular applications with advanced patterns. **Use when:** Building enterprise Angular apps, implementing complex state management, optimizing Angular performance, or migrating to latest Angular versions. ### [**cpp-pro**](cpp-pro.md) - C++ performance expert Systems programming specialist with deep knowledge of modern C++ standards, memory management, and performance optimization. Masters template metaprogramming, RAII patterns, and low-level optimizations. **Use when:** Writing high-performance C++ code, implementing system-level software, optimizing memory usage, or working with embedded systems. ### [**csharp-developer**](csharp-developer.md) - .NET ecosystem specialist Expert in C# language features and the entire .NET ecosystem. Proficient in ASP.NET Core, Entity Framework, and cross-platform development. Builds enterprise applications with clean architecture. **Use when:** Developing .NET applications, building ASP.NET Core APIs, implementing Windows applications, or working with Azure services. ### [**django-developer**](django-developer.md) - Django 4+ web development expert Python web framework specialist focusing on Django's batteries-included philosophy. Masters ORM optimization, async views, and Django's security features. Builds scalable web applications rapidly. **Use when:** Creating Django web applications, building REST APIs with DRF, implementing complex database operations, or developing data-driven applications. ### [**dotnet-core-expert**](dotnet-core-expert.md) - .NET 8 cross-platform specialist Modern .NET expert specializing in cross-platform development, minimal APIs, and cloud-native applications. Masters performance optimization with native AOT compilation and microservices patterns. **Use when:** Building cross-platform .NET apps, creating minimal APIs, implementing microservices, or optimizing .NET performance. ### [**dotnet-framework-4.8-expert**](dotnet-framework-4.8-expert.md) - .NET Framework legacy enterprise specialist Expert in maintaining and modernizing .NET Framework 4.8 enterprise applications. Masters Web Forms, WCF services, Windows services, and enterprise integration patterns with focus on stability and backward compatibility. **Use when:** Maintaining legacy .NET Framework apps, modernizing Web Forms applications, working with WCF services, or integrating with Windows enterprise systems. ### [**elixir-expert**](elixir-expert.md) - Elixir and OTP specialist Elixir language expert focusing on fault-tolerant, concurrent systems using OTP patterns. Masters Phoenix, LiveView, and distributed systems on the BEAM VM. Builds highly available applications with "let it crash" philosophy. **Use when:** Building fault-tolerant systems, creating real-time apps with Phoenix LiveView, implementing distributed Elixir clusters, or leveraging OTP patterns for reliability. ### [**expo-react-native-expert**](expo-react-native-expert.md) - Expo and React Native mobile development expert Mobile development specialist building production-ready iOS and Android applications with Expo SDK 52+ and React Native. Expert in Expo Router, native module integration, performant animations with Reanimated, and end-to-end deployment with EAS Build and Submit. **Use when:** Building mobile apps with Expo and React Native, implementing push notifications, setting up EAS builds and OTA updates, optimizing React Native performance, or integrating native features via config plugins. ### [**fastapi-developer**](fastapi-developer.md) - Modern async Python API framework expert FastAPI specialist building high-performance async APIs with automatic OpenAPI documentation. Masters Pydantic v2 validation, dependency injection, and SQLAlchemy 2.0 async patterns. Delivers blazing-fast, type-safe Python APIs. **Use when:** Building async Python APIs, implementing Pydantic v2 data validation, designing dependency injection patterns, deploying ASGI applications, or creating auto-documented RESTful services. ### [**flutter-expert**](flutter-expert.md) - Flutter 3+ cross-platform mobile expert Mobile development specialist creating beautiful, natively compiled applications from a single codebase. Expert in widget composition, state management, and platform-specific implementations. **Use when:** Building cross-platform mobile apps, creating custom Flutter widgets, implementing complex animations, or optimizing Flutter performance. ### [**golang-pro**](golang-pro.md) - Go concurrency specialist Go language expert focusing on concurrent programming, channels, and goroutines. Masters building efficient, scalable backend services and CLI tools with Go's simplicity and performance. **Use when:** Building concurrent systems, creating microservices in Go, developing CLI tools, or implementing high-performance network services. ### [**java-architect**](java-architect.md) - Enterprise Java expert Java ecosystem master with expertise in Spring, Jakarta EE, and enterprise patterns. Specializes in building robust, scalable applications with modern Java features and frameworks. **Use when:** Developing enterprise Java applications, implementing Spring Boot services, designing Java architectures, or modernizing legacy Java code. ### [**javascript-pro**](javascript-pro.md) - JavaScript development expert Modern JavaScript specialist mastering ES6+, async patterns, and the npm ecosystem. Expert in both browser and Node.js environments, building everything from scripts to full applications. **Use when:** Writing modern JavaScript, working with Node.js, implementing async patterns, or optimizing JavaScript performance. ### [**kotlin-specialist**](kotlin-specialist.md) - Modern JVM language expert Kotlin language expert for Android development and JVM applications. Masters coroutines, DSL creation, and Kotlin's expressive features. Builds safe, concise applications. **Use when:** Developing Android apps with Kotlin, building Kotlin backend services, migrating from Java to Kotlin, or creating Kotlin DSLs. ### [**laravel-specialist**](laravel-specialist.md) - Laravel 10+ PHP framework expert PHP framework specialist focusing on Laravel's elegant syntax and powerful features. Masters Eloquent ORM, queue systems, and Laravel's extensive ecosystem. **Use when:** Building Laravel applications, implementing complex queue jobs, creating Laravel packages, or optimizing Eloquent queries. ### [**nextjs-developer**](nextjs-developer.md) - Next.js 14+ full-stack specialist React framework expert specializing in Next.js App Router, server components, and full-stack features. Builds blazing-fast, SEO-friendly web applications. **Use when:** Creating Next.js applications, implementing server-side rendering, building full-stack React apps, or optimizing for Core Web Vitals. ### [**node-specialist**](node-specialist.md) - Node.js specialist Senior Node.js backend developer focusing on the Node runtime, asynchronous patterns, and the vast backend ecosystem. Builds scalable APIs, high-performance microservices, and reliable CLI tools. **Use when:** Building Node.js backend applications, creating fast Express/Fastify APIs, implementing server-side logic, working with streams, or optimizing Node.js performance. ### [**php-pro**](php-pro.md) - PHP web development expert Modern PHP specialist with expertise in PHP 8+ features, Composer ecosystem, and framework-agnostic development. Builds secure, performant PHP applications. **Use when:** Developing PHP applications, modernizing legacy PHP code, implementing PHP APIs, or working with PHP frameworks. ### [**powershell-5.1-expert**](powershell-5.1-expert.md) - Windows PowerShell 5.1 automation specialist Expert in PowerShell 5.1 scripting for Windows infrastructure, RSAT modules, and legacy .NET Framework environments. Ensures compatibility, stability, and safe automation across AD, DNS, DHCP, and GPO. **Use when:** Working with Windows-only automation, legacy modules, on-prem infrastructure, or scripts requiring compatibility with older servers and full .NET Framework. ### [**powershell-7-expert**](powershell-7-expert.md) - Cross-platform PowerShell 7 automation specialist Expert in modern PowerShell 7+, .NET 6/7 APIs, cross-platform scripting, CI/CD integration, and cloud automation using Az and Microsoft Graph. **Use when:** Building modern automation tools, cross-platform scripts, Azure integrations, CI/CD cmdlets, or modernization projects moving off Windows PowerShell. ### [**python-pro**](python-pro.md) - Python ecosystem master Python language expert covering web development, data science, automation, and system scripting. Masters Pythonic code patterns and the vast Python ecosystem. **Use when:** Writing Python applications, building data pipelines, creating automation scripts, or developing Python packages. ### [**rails-expert**](rails-expert.md) - Rails 7.x/8.x rapid development expert Version-aware Ruby on Rails specialist covering Rails 7.x through 8.1 with Ruby 3.2 through 3.4. Automatically detects Rails version from Gemfile.lock and adapts recommendations accordingly β€” Solid Queue or Sidekiq, Kamal or Capistrano, native auth or Devise. Masters Hotwire, Active Record, and convention-driven architecture. **Use when:** Building Rails applications, implementing real-time features with Hotwire, optimizing Active Record queries, or upgrading Rails versions. ### [**react-specialist**](react-specialist.md) - React 18+ modern patterns expert React ecosystem expert mastering hooks, concurrent features, and modern patterns. Builds performant, maintainable React applications with best practices. **Use when:** Developing React applications, implementing complex state management, optimizing React performance, or migrating to modern React patterns. ### [**rust-engineer**](rust-engineer.md) - Systems programming expert Rust language specialist focusing on memory safety, ownership patterns, and zero-cost abstractions. Builds reliable, efficient systems software. **Use when:** Writing systems software in Rust, building performance-critical applications, implementing safe concurrent code, or developing WebAssembly modules. ### [**spring-boot-engineer**](spring-boot-engineer.md) - Spring Boot 3+ microservices expert Spring ecosystem specialist building cloud-native Java applications. Masters reactive programming, Spring Cloud, and microservices patterns. **Use when:** Creating Spring Boot microservices, implementing reactive applications, building cloud-native Java apps, or working with Spring Cloud. ### [**sql-pro**](sql-pro.md) - Database query expert SQL language master optimizing complex queries across different database systems. Expert in query optimization, indexing strategies, and advanced SQL features. **Use when:** Writing complex SQL queries, optimizing database performance, designing database schemas, or troubleshooting query performance. ### [**swift-expert**](swift-expert.md) - iOS and macOS specialist Swift language expert for Apple platform development. Masters SwiftUI, UIKit, and Apple's frameworks. Builds native iOS, macOS, and cross-platform Apple applications. **Use when:** Developing iOS/macOS applications, implementing SwiftUI interfaces, working with Apple frameworks, or optimizing Swift performance. ### [**symfony-specialist**](symfony-specialist.md) - Symfony 6+/7+/8+ PHP framework and Doctrine ORM expert Symfony framework specialist focusing on component-based architecture, Doctrine ORM, and the Symfony ecosystem. Masters API Platform, Messenger component, Security Voters, and Symfony's powerful DI container. Builds robust, maintainable PHP applications at scale. **Use when:** Building Symfony applications, architecting Doctrine entities with complex relationships, implementing async processing with Messenger, designing REST APIs with API Platform, or optimizing Symfony performance. ### [**typescript-pro**](typescript-pro.md) - TypeScript specialist TypeScript expert ensuring type safety in JavaScript applications. Masters advanced type system features, generics, and TypeScript configuration for large-scale applications. **Use when:** Adding TypeScript to projects, implementing complex type definitions, migrating JavaScript to TypeScript, or building type-safe applications. ### [**vue-expert**](vue-expert.md) - Vue 3 Composition API expert Vue.js framework specialist mastering the Composition API, reactivity system, and Vue ecosystem. Builds elegant, reactive web applications with Vue's progressive framework. **Use when:** Creating Vue applications, implementing Composition API patterns, working with Nuxt.js, or optimizing Vue performance. ## Quick Selection Guide | Language/Framework | Subagent | Best For | |-------------------|----------|----------| | Angular | **angular-architect** | Enterprise web apps, complex SPAs | | C++ | **cpp-pro** | Systems programming, performance-critical code | | C#/.NET | **csharp-developer** | Windows apps, enterprise software | | Django | **django-developer** | Python web apps, REST APIs | | FastAPI | **fastapi-developer** | Modern async Python APIs | | .NET Core | **dotnet-core-expert** | Cross-platform .NET, microservices | | .NET Framework | **dotnet-framework-4.8-expert** | Legacy enterprise apps, Windows services | | Elixir | **elixir-expert** | Fault-tolerant systems, Phoenix/LiveView | | Expo/React Native | **expo-react-native-expert** | Expo mobile apps, EAS deployment | | Flutter | **flutter-expert** | Cross-platform mobile apps | | Go | **golang-pro** | Concurrent systems, microservices | | Java | **java-architect** | Enterprise applications | | JavaScript | **javascript-pro** | Web development, Node.js | | Kotlin | **kotlin-specialist** | Android apps, modern JVM | | Laravel | **laravel-specialist** | PHP web applications | | Next.js | **nextjs-developer** | Full-stack React apps | | Node.js | **node-specialist** | Backend services, scripts | | PHP | **php-pro** | Web development, APIs | | Python | **python-pro** | General purpose, data science | | Rails | **rails-expert** | Rapid web development | | React | **react-specialist** | Modern web UIs | | Rust | **rust-engineer** | Systems software, WebAssembly | | Spring Boot | **spring-boot-engineer** | Java microservices | | SQL | **sql-pro** | Database queries, optimization | | Swift | **swift-expert** | iOS/macOS development | | Symfony | **symfony-specialist** | Symfony/Doctrine PHP applications | | TypeScript | **typescript-pro** | Type-safe JavaScript | | Vue | **vue-expert** | Progressive web apps | ## Common Technology Stacks **Modern Web Application:** - **react-specialist** + **typescript-pro** + **nextjs-developer** - **vue-expert** + **typescript-pro** + **laravel-specialist** - **angular-architect** + **spring-boot-engineer** **Mobile Development:** - **expo-react-native-expert** for Expo/React Native cross-platform - **flutter-expert** for Flutter cross-platform - **swift-expert** for iOS native - **kotlin-specialist** for Android native **Enterprise Backend:** - **java-architect** + **spring-boot-engineer** - **csharp-developer** + **dotnet-core-expert** - **python-pro** + **django-developer** - **python-pro** + **fastapi-developer** - **node-specialist** + **typescript-pro** **Systems Programming:** - **rust-engineer** for safety-critical systems - **cpp-pro** for performance-critical applications - **golang-pro** for concurrent systems **Real-time & Distributed:** - **elixir-expert** for fault-tolerant distributed systems - **elixir-expert** + Phoenix LiveView for real-time web apps ## Getting Started 1. **Identify your technology stack** and choose the appropriate specialist 2. **Describe your project context** including existing code and constraints 3. **Specify your goals** (learning, optimization, implementation) 4. **Share relevant code** for context-aware assistance 5. **Follow the specialist's guidance** for best practices ## Best Practices - **Use language idioms:** Each specialist knows the idiomatic way to write code - **Leverage ecosystem tools:** Specialists understand the full ecosystem - **Follow framework conventions:** Each framework has its own best practices - **Consider performance early:** Language-specific optimizations matter - **Think about maintenance:** Write code that future developers will understand Choose your language specialist and write better code today!