🌐 Language
Claude Code Subagents Collection
A comprehensive collection of specialized AI subagents for Claude Code, designed to enhance development workflows with domain-specific expertise.
Overview
This repository contains 76 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.
Available Subagents
Development & Architecture
- 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
- ui-visual-validator - Verify whether UI modifications have achieved their intended goals through rigorous screenshot analysis
- 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
Language Specialists
- 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
Infrastructure & Operations
- 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
Quality & Security
- 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 & AI
- 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
Specialized Domains
- 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
Documentation
- 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 & Marketing
- 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 Optimization
- 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
Model Assignments
All 76 subagents are configured with specific Claude models based on task complexity:
🚀 Haiku (Fast & Cost-Effective) - 15 agents
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
⚡ Sonnet (Balanced Performance) - 45 agents
Model:sonnetDevelopment & 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 wireframesui-visual-validator- Rigorous UI validation through screenshot analysisbackend-architect- API design and microservicesmobile-developer- React Native/Flutter appssql-pro- Complex SQL optimizationgraphql-architect- GraphQL schemas and resolvers
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
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
🧠 Opus (Maximum Capability) - 15 agents
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
Installation
These subagents are automatically available when placed in the ~/.claude/agents/ directory.
cd ~/.claude
git clone https://github.com/wshobson/agents.gitUsage
Automatic Invocation
Claude Code will automatically delegate to the appropriate subagent based on the task context and the subagent's description.Explicit Invocation
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"Usage Examples
Single Agent Tasks
# 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"Multi-Agent Workflows
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
Advanced Workflows with Slash Commands
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 analyticsProduction incident response (5+ subagents)
/incident-response Database connection pool exhaustedML infrastructure setup (6+ subagents)
/ml-pipeline Create recommendation engine with A/B testingSecurity-focused implementation (7+ subagents)
/security-hardening Implement OAuth2 with zero-trust architectureSubagent Format
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
Model Configuration
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
haiku- Fast and cost-effective for simple taskssonnet- Balanced performance for most development workopus- Most capable for complex analysis and critical tasks
Agent Orchestration Patterns
Claude Code automatically coordinates agents using these common patterns:
Sequential Workflows
User Request → Agent A → Agent B → Agent C → ResultExample: "Build a new API feature"
backend-architect → frontend-developer → test-automator → security-auditor
Parallel Execution
User Request → Agent A + Agent B (simultaneously) → Merge ResultsExample: "Optimize application performance"
performance-engineer + database-optimizer → Combined recommendations
Conditional Branching
User Request → Analysis → Route to appropriate specialistExample: "Fix this bug"
debugger (analyzes) → Routes to: backend-architect OR frontend-developer OR devops-troubleshooter
Review & Validation
Primary Agent → Review Agent → Final ResultExample: "Implement payment processing"
payment-integration → security-auditor → Validated implementation
When to Use Which Agent
🏗️ Planning & Architecture
- 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
🔧 Implementation & Development
- 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
🛠️ Operations & Maintenance
- 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
📊 Analysis & Optimization
- 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
🧪 Quality Assurance
- 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
📚 Documentation
- 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 & Strategy
- 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
Best Practices
🎯 Task Delegation
- 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
🔄 Multi-Agent Workflows
- 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
🎛️ Explicit Control
- 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"
📈 Optimization
- 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
Contributing
To add a new subagent:
- Create a new
.mdfile 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
Troubleshooting
Common Issues
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)
- Provide more context about your tech stack and requirements
- Use explicit invocation if you need a specific agent
- This is normal - different specialists may have different priorities
- Ask for clarification: "Reconcile the recommendations from security-auditor and performance-engineer"
- Provide background information in your request
- Reference previous conversations or established patterns
Getting Help
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
License
This project is licensed under the MIT License - see the LICENSE file for details.