Files
agents/README.md
2025-07-24 19:29:24 -04:00

4.1 KiB

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

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
  • mobile-developer - Develop React Native or Flutter apps with native integrations
  • graphql-architect - Design GraphQL schemas, resolvers, and federation

Language Specialists

  • python-pro - Write idiomatic Python code with advanced features and optimizations
  • golang-pro - Write idiomatic Go code with goroutines, channels, and interfaces

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
  • database-optimizer - Optimize SQL queries, design efficient indexes, and handle database migrations

Quality & Security

  • code-reviewer - Expert code review for quality, security, and maintainability
  • 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

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

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
  • legacy-modernizer - Refactor legacy codebases and implement gradual modernization

Installation

These subagents are automatically available when placed in ~/.claude/agents/ directory.

Usage

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"

Subagent Format

Each subagent follows this structure:

---
name: subagent-name
description: When this subagent should be invoked
tools: tool1, tool2  # Optional - defaults to all tools
---

System prompt defining the subagent's role and capabilities

Best Practices

  1. Let Claude Code delegate automatically - The main agent knows when to use each subagent
  2. Use explicit invocation for specific needs - When you want a particular expert's perspective
  3. Combine multiple subagents - Complex tasks may benefit from multiple specialists

Contributing

To add a new subagent:

  1. Create a new .md file following the format above
  2. Use lowercase, hyphen-separated names
  3. Write clear descriptions for when the subagent should be used
  4. Include specific instructions in the system prompt

Learn More