awesome-claude-code-subagents Documentation

A collection of 100+ specialized Claude Code subagents covering a wide range of development use cases

RAW Doc

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 instead — that's the supported way to surface your work here.

Installation

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 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.

You ship products with AI, but every launch still dies quietly because nobody posts about it. EveryFeed 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 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.

[03. Infrastructure](categories/03-infrastructure/)

Plugin: voltagent-infra

DevOps, cloud, and deployment specialists.

[04. Quality & Security](categories/04-quality-security/)

Plugin: voltagent-qa-sec

Testing, security, and code quality experts.

[05. Data & AI](categories/05-data-ai/)

Plugin: voltagent-data-ai

Data engineering, ML, and AI specialists.

[06. Developer Experience](categories/06-developer-experience/)

Plugin: voltagent-dev-exp

Tooling and developer productivity experts.

[07. Specialized Domains](categories/07-specialized-domains/)

Plugin: voltagent-domains

Domain-specific technology experts.

[08. Business & Product](categories/08-business-product/)

Plugin: voltagent-biz

Product management and business analysis.

[09. Meta & Orchestration](categories/09-meta-orchestration/)

Plugin: voltagent-meta

Agent coordination and meta-programming.

[10. Research & Analysis](categories/10-research-analysis/)

Plugin: voltagent-research

Research, search, and analysis specialists.

🤖 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:

text
> 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 <query> Find agents by name, description, or category
/subagent-catalog:fetch <name> 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 for guidelines.

  • Submit new subagents via PR
  • Improve existing definitions
  • Report issues and bugs

Contributor ♥️ Thanks

📄 License

MIT License - see 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 and we'll address it promptly.


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 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 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

[**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
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 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 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!