Claude Code Subagents Collection
A comprehensive collection of 33 specialized AI subagents for Claude Code, designed to enhance development workflows with domain-specific expertise and intelligent automation.
🚀 Overview
This repository contains a curated set of specialized subagents that extend Claude Code's capabilities across the entire software development lifecycle. Each subagent is an expert in a specific domain, automatically invoked based on context analysis or explicitly called when specialized expertise is needed.
Key Features
- 🤖 Intelligent Auto-Delegation: Claude Code automatically selects optimal agents based on task context
- 🔧 Domain Expertise: Each agent specializes in specific technologies, patterns, and best practices
- 🔄 Multi-Agent Orchestration: Seamless coordination between agents for complex workflows
- 📊 Quality Assurance: Built-in review and validation patterns across all domains
- ⚡ Performance Optimized: Agents designed for efficient task completion and resource utilization
Available Subagents
Agents are now organized into logical categories for easier navigation:
Frontend & UI Specialists
- frontend-developer - Build React components, implement responsive layouts, and handle client-side state management
- ui-designer - Creative UI design focused on user-friendly interfaces
- ux-designer - User experience design and interaction optimization
- react-pro - Expert React development with hooks, performance optimization, and best practices
- nextjs-pro - Next.js specialist for SSR, SSG, and full-stack React applications
Backend & Architecture
- backend-architect - Design RESTful APIs, microservice boundaries, and database schemas
- full-stack-developer - End-to-end web application development from UI to database with seamless integration
Language Specialists
- python-pro - Write idiomatic Python code with advanced features and optimizations
- golang-pro - Write idiomatic Go code with goroutines, channels, and interfaces
- typescript-pro - Advanced TypeScript development with type safety and modern patterns
Platform & Mobile
- mobile-developer - Develop React Native or Flutter apps with native integrations
- electron-pro - Electron desktop application development and cross-platform solutions
Developer Experience
- dx-optimizer - Developer Experience specialist that improves tooling, setup, and workflows
- legacy-modernizer - Refactor legacy codebases and implement gradual modernization
- code-reviewer - Expert code review for quality, security, and maintainability
- architect-reviewer - Reviews code changes for architectural consistency and design patterns
- qa-expert - Comprehensive QA processes and testing strategies for quality assurance
- test-automator - Create comprehensive test suites with unit, integration, and e2e tests
- debugger - Debugging specialist for errors, test failures, and unexpected behavior
Data Engineering & Analytics
- data-engineer - Build ETL pipelines, data warehouses, and streaming architectures
- data-scientist - Data analysis expert for SQL queries, BigQuery operations, and data insights
- database-optimizer - Optimize SQL queries, design efficient indexes, and handle database migrations
- postgres-pro - PostgreSQL database expert for advanced queries and optimizations
- graphql-architect - Design GraphQL schemas, resolvers, and federation patterns
AI & Machine Learning
- ai-engineer - Build LLM applications, RAG systems, and prompt pipelines
- ml-engineer - Implement ML pipelines, model serving, and feature engineering
- prompt-engineer - Optimizes prompts for LLMs and AI systems
- api-documenter - Create OpenAPI/Swagger specs and write developer documentation
- documentation-expert - Professional technical writing and comprehensive documentation systems
- product-manager - Strategic product management with roadmap planning and stakeholder alignment
🎭 Meta-Orchestration
- agent-organizer - Master orchestrator for complex, multi-agent tasks. Analyzes project requirements, assembles optimal agent teams, and manages collaborative workflows for comprehensive project execution.
Key Capabilities:
- Intelligent Project Analysis: Technology stack detection, architecture pattern recognition, and requirement extraction
- Strategic Team Assembly: Selects optimal 1-3 agent teams based on project needs and complexity
- Workflow Orchestration: Manages multi-phase collaboration with quality gates and validation checkpoints
- Efficiency Optimization: Focused teams for common tasks (bug fixes, features, documentation) with comprehensive orchestration for complex projects
When to Use: Complex multi-step projects, cross-domain tasks, architecture decisions, comprehensive analysis, or any scenario requiring coordinated expertise from multiple specialized agents.
📦 Installation
Quick Setup
Manual Installation (Recommend)
Alternatively, you can manually copy individual agent files:
# Prevent replacing documents from other providers
mkdir ~/.claude/agents/lst97
# Copy specific agents to your Claude agents directory
cp /path/to/agents/*.md ~/.claude/agents/lst97
Verification
To verify agents are loaded correctly:
# List all available agents
ls ~/.claude/agents/lst97/*.md
# Check Claude Code recognizes the agents (run in Claude Code)
# "List all available subagents"
Quick Installation
These subagents are automatically available when placed in the ~/.claude/agents/ directory. Claude Code will automatically detect and load them on startup. This will enable the CLAUDE.md to be available in global scope, may also conflict with other repository.
# Clone the repository to your Claude agents directory
# Documents are base on the scaffold from https://github.com/wshobson/agents.git
cd ~/.claude
git clone https://github.com/lst97/claude-code-sub-agents.git
# Or if the directory already exists, pull the latest updates
cd ~/.claude
git pull origin main
🔧 MCP Server Configuration (Required for Full Performance)
To enable optimal performance with specialized MCP (Model Context Protocol) servers that enhance agent capabilities, add the following configuration to your global Claude settings file (~/.claude.json):
"mcpServers": {
"sequential-thinking": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sequential-thinking"
],
"env": {}
},
"context7": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@upstash/context7-mcp"
],
"env": {}
},
"magic": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@21st-dev/magic@latest",
"API_KEY=\"api-key\"" // API key is required
],
"env": {}
},
"playwright": {
"type": "stdio",
"command": "npx",
"args": [
"@playwright/mcp@latest"
],
"env": {}
},
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/your/allowed/path" // please add your path here
]
},
"puppeteer": {
"command": "npx",
"args": [
"-y",
"puppeteer-mcp-server"
],
"env": {}
}
}
MCP Server Benefits:
- sequential-thinking: Enhanced multi-step reasoning and complex analysis
- context7: Access to up-to-date documentation and framework patterns
- magic: Advanced UI component generation and design system integration
- playwright: Cross-browser testing and E2E automation capabilities
Note: These MCP servers significantly enhance agent capabilities but are not strictly required for basic functionality.
🎭 Advanced: Agent-Organizer Auto-Dispatch Setup
For complex projects requiring multi-agent coordination, you can enable the dispatch protocol in your project root directory (not globally):
# Copy CLAUDE.md to your PROJECT root directory (recommended)
cp /path/to/agents/CLAUDE.md /path/to/your/project/CLAUDE.md
⚠️ Project-Scope Recommendation:
- ✅ Project-Specific: Place CLAUDE.md in individual project roots for targeted orchestration
- ❌ Global Scope: Avoid placing in
~/.claude/CLAUDE.md to prevent over-orchestration of simple tasks
- 🎯 Selective Usage: Enable only for projects requiring comprehensive multi-agent workflows
Trade-offs to Consider:
- Quality vs Speed: Multi-agent workflows provide expert results but take longer
- Token Efficiency: 2-5x token usage for comprehensive analysis and implementation
- Complexity Matching: Best for complex projects, may over-engineer simple tasks
🔧 Usage
Automatic Invocation (Recommended)
Claude Code intelligently analyzes your request and automatically delegates to the most appropriate subagent(s) based on:
- Context Analysis: Keywords, file types, and project structure
- Task Classification: Development, debugging, optimization, etc.
- Domain Expertise: Matching requirements to specialist knowledge
- Workflow Patterns: Common multi-agent coordination scenarios
Example: "Implement user authentication with secure password handling" → Automatically uses: backend-architect → security-auditor → test-automator
Explicit Invocation
For specific expertise or when you want control over agent selection: