Files
agents/README.md
Seth Hobson fd5d73f8af Add 5 new specialized subagents and update README
- Add architect-reviewer for code architecture reviews
- Add context-manager for managing context across agents
- Add dx-optimizer for developer experience improvements
- Add incident-responder for production incident handling
- Add prompt-engineer for LLM prompt optimization
- Add .gitignore file
- Update README.md with new subagents and correct count (28 total)
2025-07-24 22:28:03 -04:00

97 lines
4.5 KiB
Markdown

# Claude Code Subagents Collection
A comprehensive collection of specialized AI subagents for [Claude Code](https://docs.anthropic.com/en/docs/claude-code), designed to enhance development workflows with domain-specific expertise.
## Overview
This repository contains 28 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
- **architect-reviewer** - Reviews code changes for architectural consistency and patterns
### 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
- **incident-responder** - Handles production incidents with urgency and precision
- **dx-optimizer** - Developer Experience specialist that improves tooling, setup, and workflows
### 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
- **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
- **legacy-modernizer** - Refactor legacy codebases and implement gradual modernization
- **context-manager** - Manages context across multiple agents and long-running tasks
## 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:
```markdown
---
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
- [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)
- [Subagents Documentation](https://docs.anthropic.com/en/docs/claude-code/sub-agents)
- [Claude Code GitHub](https://github.com/anthropics/claude-code)