A comprehensive collection of specialized AI subagents for Claude Code, designed to enhance development workflows with domain-specific expertise.
This repository contains 75 specialized subagents that extend Claude Code's capabilities. Each subagent is an expert in a specific domain, automatically invoked based on context or explicitly called when needed. All agents are configured with specific Claude models based on task complexity for optimal performance and cost-effectiveness.
- backend-architect - Design RESTful APIs, microservice boundaries, and database schemas
- frontend-developer - Build React components, implement responsive layouts, and handle client-side state management
- ui-ux-designer - Create interface designs, wireframes, and design systems
- mobile-developer - Develop React Native or Flutter apps with native integrations
- graphql-architect - Design GraphQL schemas, resolvers, and federation
- architect-reviewer - Reviews code changes for architectural consistency and patterns
- python-pro - Write idiomatic Python code with advanced features and optimizations
- ruby-pro - Write idiomatic Ruby code with metaprogramming, Rails patterns, gem development, and testing frameworks
- golang-pro - Write idiomatic Go code with goroutines, channels, and interfaces
- rust-pro - Write idiomatic Rust with ownership patterns, lifetimes, and trait implementations
- c-pro - Write efficient C code with proper memory management and system calls
- cpp-pro - Write idiomatic C++ code with modern features, RAII, smart pointers, and STL algorithms
- javascript-pro - Master modern JavaScript with ES6+, async patterns, and Node.js APIs
- typescript-pro - Master TypeScript with advanced types, generics, and strict type safety
- php-pro - Write idiomatic PHP code with modern features and performance optimizations
- java-pro - Master modern Java with streams, concurrency, and JVM optimization
- elixir-pro - Write idiomatic Elixir code with OTP patterns, functional programming, and Phoenix frameworks
- csharp-pro - Write modern C# code with advanced features and .NET optimization
- scala-pro - Master enterprise-grade Scala development with functional programming, distributed systems, and big data processing
- flutter-expert - Master Flutter development with Dart, widgets, and platform integrations
- unity-developer - Build Unity games with optimized scripts and performance tuning
- minecraft-bukkit-pro - Master Minecraft server plugin development with Bukkit, Spigot, and Paper APIs
- ios-developer - Develop native iOS applications with Swift/SwiftUI
- sql-pro - Write complex SQL queries, optimize execution plans, and design normalized schemas
- devops-troubleshooter - Debug production issues, analyze logs, and fix deployment failures
- deployment-engineer - Configure CI/CD pipelines, Docker containers, and cloud deployments
- cloud-architect - Design AWS/Azure/GCP infrastructure and optimize cloud costs
- hybrid-cloud-architect - Design hybrid cloud infrastructure across AWS/Azure/GCP and OpenStack on-premises environments
- kubernetes-architect - Design cloud-native infrastructure with Kubernetes at its core and GitOps principles across AWS/Azure/GCP and hybrid environments.
- database-optimizer - Optimize SQL queries, design efficient indexes, and handle database migrations
- database-admin - Manage database operations, backups, replication, and monitoring
- terraform-specialist - Write advanced Terraform modules, manage state files, and implement IaC best practices
- incident-responder - Handles production incidents with urgency and precision
- network-engineer - Debug network connectivity, configure load balancers, and analyze traffic patterns
- dx-optimizer - Developer Experience specialist that improves tooling, setup, and workflows
- code-reviewer - Expert code review with deep configuration security focus and production reliability
- security-auditor - Review code for vulnerabilities and ensure OWASP compliance
- test-automator - Create comprehensive test suites with unit, integration, and e2e tests
- performance-engineer - Profile applications, optimize bottlenecks, and implement caching strategies
- debugger - Debugging specialist for errors, test failures, and unexpected behavior
- error-detective - Search logs and codebases for error patterns, stack traces, and anomalies
- search-specialist - Expert web researcher using advanced search techniques and synthesis
- data-scientist - Data analysis expert for SQL queries, BigQuery operations, and data insights
- data-engineer - Build ETL pipelines, data warehouses, and streaming architectures
- ai-engineer - Build LLM applications, RAG systems, and prompt pipelines
- ml-engineer - Implement ML pipelines, model serving, and feature engineering
- mlops-engineer - Build ML pipelines, experiment tracking, and model registries
- prompt-engineer - Optimizes prompts for LLMs and AI systems
- api-documenter - Create OpenAPI/Swagger specs and write developer documentation
- payment-integration - Integrate Stripe, PayPal, and payment processors
- quant-analyst - Build financial models, backtest trading strategies, and analyze market data
- risk-manager - Monitor portfolio risk, R-multiples, and position limits
- legacy-modernizer - Refactor legacy codebases and implement gradual modernization
- context-manager - Manages context across multiple agents and long-running tasks
- docs-architect - Creates comprehensive technical documentation from existing codebases
- mermaid-expert - Create Mermaid diagrams for flowcharts, sequences, ERDs, and architectures
- reference-builder - Creates exhaustive technical references and API documentation
- tutorial-engineer - Creates step-by-step tutorials and educational content from code
- business-analyst - Analyze metrics, create reports, and track KPIs
- content-marketer - Write blog posts, social media content, and email newsletters
- hp-pro - Partner for hiring, onboarding/offboarding, PTO and leave, performance, compliant policies, and employee relations.
- sales-automator - Draft cold emails, follow-ups, and proposal templates
- customer-support - Handle support tickets, FAQ responses, and customer emails
- legal-advisor - Draft privacy policies, terms of service, disclaimers, and legal notices
- seo-content-auditor - Analyzes provided content for quality, E-E-A-T signals, and SEO best practices
- seo-meta-optimizer - Creates optimized meta titles, descriptions, and URL suggestions
- seo-keyword-strategist - Analyzes keyword usage, calculates density, suggests semantic variations
- seo-structure-architect - Optimizes content structure, header hierarchy, and schema markup
- seo-snippet-hunter - Formats content for featured snippets and SERP features
- seo-content-refresher - Identifies outdated elements and suggests content updates
- seo-cannibalization-detector - Analyzes multiple pages for keyword overlap and conflicts
- seo-authority-builder - Analyzes content for E-E-A-T signals and trust indicators
- seo-content-writer - Writes SEO-optimized content based on keywords and briefs
- seo-content-planner - Creates content outlines, topic clusters, and calendars
All 75 subagents are configured with specific Claude models based on task complexity:
Model:
haiku
data-scientist
- SQL queries and data analysisapi-documenter
- OpenAPI/Swagger documentationreference-builder
- Exhaustive technical references and API documentationbusiness-analyst
- Metrics and KPI trackingcontent-marketer
- Blog posts and social mediacustomer-support
- Support tickets and FAQssales-automator
- Cold emails and proposalssearch-specialist
- Web research and information gatheringlegal-advisor
- Privacy policies and compliance documentsseo-meta-optimizer
- Meta title and description optimizationseo-keyword-strategist
- Keyword density and semantic analysisseo-structure-architect
- Content structure and schema markupseo-snippet-hunter
- Featured snippet formattingseo-content-refresher
- Content freshness updatesseo-cannibalization-detector
- Keyword overlap detectionseo-content-planner
- Content calendars and outlines
Model:
sonnet
Development & Languages:
python-pro
- Python development with advanced featuresruby-pro
- Ruby development with metaprogramming, Rails patterns, and gem developmentjavascript-pro
- Modern JavaScript and Node.jstypescript-pro
- Advanced TypeScript with type systemsgolang-pro
- Go concurrency and idiomatic patternsrust-pro
- Rust memory safety and systems programmingc-pro
- C programming and embedded systemscpp-pro
- Modern C++ with STL and templatesphp-pro
- Modern PHP with advanced featuresjava-pro
- Modern Java with streams and concurrencyelixir-pro
- Elixir with OTP patterns and Phoenixcsharp-pro
- Modern C# with .NET frameworks and patternsscala-pro
- Enterprise Scala with Apache Pekko, Akka, Spark, and ZIO/Cats Effectflutter-expert
- Flutter development with state management and animationsunity-developer
- Unity game development and optimizationminecraft-bukkit-pro
- Minecraft plugin development with Bukkit/Spigot/Paperios-developer
- Native iOS development with Swift/SwiftUIfrontend-developer
- React components and UIui-ux-designer
- Interface design and wireframesbackend-architect
- API design and microservicesmobile-developer
- React Native/Flutter appssql-pro
- Complex SQL optimizationgraphql-architect
- GraphQL schemas and resolvers
Infrastructure & Operations:
devops-troubleshooter
- Production debuggingdeployment-engineer
- CI/CD pipelinesdatabase-optimizer
- Query optimizationdatabase-admin
- Database operationsterraform-specialist
- Infrastructure as Codenetwork-engineer
- Network configurationdx-optimizer
- Developer experiencedata-engineer
- ETL pipelines
Quality & Support:
test-automator
- Test suite creationcode-reviewer
- Code quality analysisdebugger
- Error investigationerror-detective
- Log analysisml-engineer
- ML model deploymentlegacy-modernizer
- Framework migrationspayment-integration
- Payment processingmermaid-expert
- Mermaid diagrams and visual documentationflutter-expert
- Flutter developmentseo-content-auditor
- Content quality and E-E-A-T analysisseo-authority-builder
- Authority signal optimizationseo-content-writer
- SEO-optimized content creation
Model:
opus
ai-engineer
- LLM applications and RAG systemssecurity-auditor
- Vulnerability analysisperformance-engineer
- Application optimizationincident-responder
- Production incident handlingmlops-engineer
- ML infrastructurearchitect-reviewer
- Architectural consistencycloud-architect
- Cloud infrastructure designprompt-engineer
- LLM prompt optimizationcontext-manager
- Multi-agent coordinationquant-analyst
- Financial modelingrisk-manager
- Portfolio risk managementdocs-architect
- Comprehensive technical documentation from codebasestutorial-engineer
- Step-by-step tutorials and educational content
These subagents are automatically available when placed in
~/.claude/agents/
directory.
cd ~/.claude
git clone https://github.com/wshobson/agents.git
Claude Code will automatically delegate to the appropriate subagent based on the task context and the subagent's description.
Mention the subagent by name in your request:
"Use the code-reviewer to check my recent changes"
"Have the security-auditor scan for vulnerabilities"
"Get the performance-engineer to optimize this bottleneck"
# Code quality and review
"Use code-reviewer to analyze this component for best practices"
"Have code-reviewer scrutinize these configuration changes"
"Have security-auditor check for OWASP compliance issues"
# Development tasks
"Get backend-architect to design a user authentication API"
"Use frontend-developer to create a responsive dashboard layout"
# Infrastructure and operations
"Have devops-troubleshooter analyze these production logs"
"Use cloud-architect to design a scalable AWS architecture"
"Get network-engineer to debug SSL certificate issues"
"Use database-admin to set up backup and replication"
# Data and AI
"Get data-scientist to analyze this customer behavior dataset"
"Use ai-engineer to build a RAG system for document search"
"Have mlops-engineer set up MLflow experiment tracking"
# Business and marketing
"Have business-analyst create investor deck with growth metrics"
"Use content-marketer to write SEO-optimized blog post"
"Get sales-automator to create cold email sequence"
"Have customer-support draft FAQ documentation"
These subagents work together seamlessly, and for more complex orchestrations, you can use the Claude Code Commands collection which provides 52 pre-built slash commands that leverage these subagents in sophisticated workflows.
# Feature development workflow
"Implement user authentication feature"
# Automatically uses: backend-architect → frontend-developer → test-automator → security-auditor
# Performance optimization workflow
"Optimize the checkout process performance"
# Automatically uses: performance-engineer → database-optimizer → frontend-developer
# Production incident workflow
"Debug high memory usage in production"
# Automatically uses: incident-responder → devops-troubleshooter → error-detective → performance-engineer
# Network connectivity workflow
"Fix intermittent API timeouts"
# Automatically uses: network-engineer → devops-troubleshooter → performance-engineer
# Database maintenance workflow
"Set up disaster recovery for production database"
# Automatically uses: database-admin → database-optimizer → incident-responder
# ML pipeline workflow
"Build end-to-end ML pipeline with monitoring"
# Automatically uses: mlops-engineer → ml-engineer → data-engineer → performance-engineer
# Product launch workflow
"Launch new feature with marketing campaign"
# Automatically uses: business-analyst → content-marketer → sales-automator → customer-support
For more sophisticated multi-subagent orchestration, use the companion Commands repository:
# Complex feature development (8+ subagents)
/full-stack-feature Build user dashboard with real-time analytics
# Production incident response (5+ subagents)
/incident-response Database connection pool exhausted
# ML infrastructure setup (6+ subagents)
/ml-pipeline Create recommendation engine with A/B testing
# Security-focused implementation (7+ subagents)
/security-hardening Implement OAuth2 with zero-trust architecture
Each subagent follows this structure:
---
name: subagent-name
description: When this subagent should be invoked
model: haiku # Optional - specify which model to use (haiku/sonnet/opus)
tools: tool1, tool2 # Optional - defaults to all tools
---
System prompt defining the subagent's role and capabilities
As of Claude Code v1.0.64, subagents can specify which Claude model they should use. This allows for cost-effective task delegation based on complexity:
- Low Complexity (Haiku): Simple tasks like basic data analysis, documentation generation, and standard responses
- Medium Complexity (Sonnet): Development tasks, code review, testing, and standard engineering work
- High Complexity (Opus): Critical tasks like security auditing, architecture review, incident response, and AI/ML engineering
Available models (using simplified naming as of Claude Code v1.0.64):
haiku
- Fast and cost-effective for simple taskssonnet
- Balanced performance for most development workopus
- Most capable for complex analysis and critical tasks
If no model is specified, the subagent will use the system's default model.
Claude Code automatically coordinates agents using these common patterns:
User Request → Agent A → Agent B → Agent C → Result
Example: "Build a new API feature"
backend-architect → frontend-developer → test-automator → security-auditor
User Request → Agent A + Agent B (simultaneously) → Merge Results
Example: "Optimize application performance"
performance-engineer + database-optimizer → Combined recommendations
User Request → Analysis → Route to appropriate specialist
Example: "Fix this bug"
debugger (analyzes) → Routes to: backend-architect OR frontend-developer OR devops-troubleshooter
Primary Agent → Review Agent → Final Result
Example: "Implement payment processing"
payment-integration → security-auditor → Validated implementation
- backend-architect: API design, database schemas, system architecture
- frontend-developer: UI/UX planning, component architecture
- ui-ux-designer: Interface design, wireframes, design systems, user research
- cloud-architect: Infrastructure design, scalability planning
- python-pro: Python-specific development tasks
- ruby-pro: Ruby metaprogramming, Rails applications, gem development, RSpec/Minitest testing
- golang-pro: Go-specific development tasks
- rust-pro: Rust-specific development, memory safety, systems programming
- c-pro: C programming, embedded systems, performance-critical code
- javascript-pro: Modern JavaScript, async patterns, Node.js/browser code
- typescript-pro: Advanced TypeScript, generics, type inference, enterprise patterns
- java-pro: Modern Java development, streams, concurrency, Spring Boot
- elixir-pro: Elixir development, OTP patterns, Phoenix frameworks, functional programming
- csharp-pro: Modern C# development, .NET frameworks, enterprise patterns
- scala-pro: Enterprise Scala with functional programming, Apache Pekko/Akka actors, Apache Spark, ZIO/Cats Effect, reactive architectures
- flutter-expert: Flutter development, Dart, state management, animations, cross-platform deployment
- unity-developer: Unity game development, C# scripting, performance optimization
- minecraft-bukkit-pro: Minecraft plugin development, event systems, server-side features
- ios-developer: Native iOS development with Swift/SwiftUI
- sql-pro: Database queries, schema design, query optimization
- mobile-developer: React Native/Flutter development
- devops-troubleshooter: Production issues, deployment problems
- incident-responder: Critical outages requiring immediate response
- database-optimizer: Query performance, indexing strategies
- database-admin: Backup strategies, replication, user management, disaster recovery
- terraform-specialist: Infrastructure as Code, Terraform modules, state management
- network-engineer: Network connectivity, load balancers, SSL/TLS, DNS debugging
- performance-engineer: Application bottlenecks, optimization
- security-auditor: Vulnerability scanning, compliance checks
- data-scientist: Data analysis, insights, reporting
- mlops-engineer: ML infrastructure, experiment tracking, model registries, pipeline automation
- code-reviewer: Code quality, configuration security, production reliability
- test-automator: Test strategy, test suite creation
- debugger: Bug investigation, error resolution
- error-detective: Log analysis, error pattern recognition, root cause analysis
- search-specialist: Deep web research, competitive analysis, fact-checking
- api-documenter: OpenAPI/Swagger specs, API documentation
- docs-architect: Comprehensive technical documentation, architecture guides, system manuals
- reference-builder: Exhaustive API references, configuration guides, parameter documentation
- tutorial-engineer: Step-by-step tutorials, learning paths, educational content
- business-analyst: KPIs, revenue models, growth projections, investor metrics
- risk-manager: Portfolio risk, hedging strategies, R-multiples, position sizing
- content-marketer: SEO content, blog posts, social media, email campaigns
- sales-automator: Cold emails, follow-ups, proposals, lead nurturing
- customer-support: Support tickets, FAQs, help documentation, troubleshooting
- legal-advisor - Draft privacy policies, terms of service, disclaimers, and legal notices
- Let Claude Code delegate automatically - The main agent analyzes context and selects optimal agents
- Be specific about requirements - Include constraints, tech stack, and quality requirements
- Trust agent expertise - Each agent is optimized for their domain
- Start with high-level requests - Let agents coordinate complex multi-step tasks
- Provide context between agents - Ensure agents have necessary background information
- Review integration points - Check how different agents' outputs work together
- Use explicit invocation for specific needs - When you want a particular expert's perspective
- Combine multiple agents strategically - Different specialists can validate each other's work
- Request specific review patterns - "Have security-auditor review backend-architect's API design"
- Monitor agent effectiveness - Learn which agents work best for your use cases
- Iterate on complex tasks - Use agent feedback to refine requirements
- Leverage agent strengths - Match task complexity to agent capabilities
To add a new subagent:
- Create a new
.md
file following the format above
- Use lowercase, hyphen-separated names
- Write clear descriptions for when the subagent should be used
- Include specific instructions in the system prompt
Agent not being invoked automatically:
- Ensure your request clearly indicates the domain (e.g., "performance issue" → performance-engineer)
- Be specific about the task type (e.g., "review code" → code-reviewer)
Unexpected agent selection:
- Provide more context about your tech stack and requirements
- Use explicit invocation if you need a specific agent
Multiple agents producing conflicting advice:
- This is normal - different specialists may have different priorities
- Ask for clarification: "Reconcile the recommendations from security-auditor and performance-engineer"
Agent seems to lack context:
- Provide background information in your request
- Reference previous conversations or established patterns
If agents aren't working as expected:
- Check agent descriptions in their individual files
- Try more specific language in your requests
- Use explicit invocation to test specific agents
- Provide more context about your project and goals
This project is licensed under the MIT License - see the LICENSE file for details.