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:

🏗️ Development

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

☁️ Infrastructure

• cloud-architect - Design AWS/Azure/GCP infrastructure and optimize cloud costs
• deployment-engineer - Configure CI/CD pipelines, Docker containers, and cloud deployments
• devops-incident-responder - Debug production issues, analyze logs, and fix deployment failures
• incident-responder - Handles production incidents with urgency and precision
• performance-engineer - Profile applications, optimize bottlenecks, and implement caching strategies

🔍 Quality & Testing

• 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 & AI

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

🛡️ Security

• security-auditor - Review code for vulnerabilities and ensure OWASP compliance

🎯 Specialization

• api-documenter - Create OpenAPI/Swagger specs and write developer documentation
• documentation-expert - Professional technical writing and comprehensive documentation systems

💼 Business

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