mirror of
https://github.com/VoltAgent/awesome-claude-code-subagents.git
synced 2025-10-27 15:44:33 +03:00
Revise README.md for clarity and comprehensiveness, expanding descriptions of subagents, categories, and usage instructions.
This commit is contained in:
203
README.md
203
README.md
@@ -1,38 +1,201 @@
|
||||
# Awesome Claude Subagents 🤖
|
||||
# Awesome Claude Code Subagents 🤖
|
||||
|
||||
A curated collection of production-ready Claude Code subagents for various development tasks.
|
||||
The most comprehensive reference repository for production-ready Claude Code subagents. This collection features battle-tested subagent definitions following best practices and industry standards, continuously updated and maintained by the [VoltAgent](https://github.com/voltagent) open-source AI agent framework maintainers.
|
||||
|
||||
## 🎯 What is this?
|
||||
|
||||
This repository serves as the definitive collection of Claude Code subagents - specialized AI agents designed for specific development tasks. Each subagent is:
|
||||
|
||||
- **Production-ready**: Tested in real-world scenarios
|
||||
- **Best practices compliant**: Following industry standards and patterns
|
||||
- **MCP Tool integrated**: Leveraging Model Context Protocol tools
|
||||
- **Continuously maintained**: Regular updates with new capabilities
|
||||
- **Community-driven**: Open to contributions and improvements
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
1. Browse categories to find the subagent you need
|
||||
2. Copy the subagent definition
|
||||
3. Use with Claude Code or integrate into your workflow
|
||||
4. Customize based on your project requirements
|
||||
|
||||
## 📚 Categories
|
||||
|
||||
- **[Core Development](categories/01-core-development/)** - Backend, Frontend, API development
|
||||
- **[Language Specialists](categories/02-language-specialists/)** - Language-specific experts
|
||||
- **[Infrastructure](categories/03-infrastructure/)** - DevOps, Cloud, Deployment
|
||||
- **[Quality & Security](categories/04-quality-security/)** - Testing, Security, Code Review
|
||||
- **[Data & AI](categories/05-data-ai/)** - Data Engineering, ML, AI
|
||||
- **[Developer Experience](categories/06-developer-experience/)** - Tooling, Refactoring
|
||||
- **[Specialized Domains](categories/07-specialized-domains/)** - Payment, Blockchain, IoT
|
||||
- **[Business & Product](categories/08-business-product/)** - PM, Business Analysis
|
||||
- **[Meta & Orchestration](categories/09-meta-orchestration/)** - Agent Coordination
|
||||
- **[Research & Analysis](categories/10-research-analysis/)** - Research, Search
|
||||
### [01. Core Development](categories/01-core-development/)
|
||||
Essential development subagents for everyday coding tasks.
|
||||
|
||||
## ⭐ Popular Subagents
|
||||
- [**frontend-developer**](categories/01-core-development/frontend-developer.md) - UI/UX specialist for React, Vue, and Angular
|
||||
- [**backend-developer**](categories/01-core-development/backend-developer.md) - Server-side expert for scalable APIs
|
||||
- [**fullstack-developer**](categories/01-core-development/fullstack-developer.md) - End-to-end feature development
|
||||
- [**mobile-developer**](categories/01-core-development/mobile-developer.md) - Cross-platform mobile specialist
|
||||
- [**electron-pro**](categories/01-core-development/electron-pro.md) - Desktop application expert
|
||||
- [**api-designer**](categories/01-core-development/api-designer.md) - REST and GraphQL API architect
|
||||
- [**graphql-architect**](categories/01-core-development/graphql-architect.md) - GraphQL schema and federation expert
|
||||
- [**microservices-architect**](categories/01-core-development/microservices-architect.md) - Distributed systems designer
|
||||
- [**websocket-engineer**](categories/01-core-development/websocket-engineer.md) - Real-time communication specialist
|
||||
|
||||
1. [Backend Developer](categories/01-core-development/backend-developer.md)
|
||||
2. [Frontend Developer](categories/01-core-development/frontend-developer.md)
|
||||
3. [Agent Organizer](categories/09-meta-orchestration/agent-organizer.md)
|
||||
4. [Code Reviewer](categories/04-quality-security/code-reviewer.md)
|
||||
5. [Data Engineer](categories/05-data-ai/data-engineer.md)
|
||||
### [02. Language Specialists](categories/02-language-specialists/)
|
||||
Language-specific experts with deep framework knowledge.
|
||||
|
||||
- **python-expert** - Python ecosystem master
|
||||
- **javascript-ninja** - JavaScript/TypeScript guru
|
||||
- **rust-specialist** - Systems programming expert
|
||||
- **go-engineer** - Go concurrency specialist
|
||||
- **java-architect** - Enterprise Java expert
|
||||
|
||||
### [03. Infrastructure](categories/03-infrastructure/)
|
||||
DevOps, cloud, and deployment specialists.
|
||||
|
||||
- **devops-engineer** - CI/CD and automation expert
|
||||
- **cloud-architect** - AWS/GCP/Azure specialist
|
||||
- **kubernetes-expert** - Container orchestration master
|
||||
- **terraform-specialist** - Infrastructure as Code expert
|
||||
- **monitoring-engineer** - Observability specialist
|
||||
|
||||
### [04. Quality & Security](categories/04-quality-security/)
|
||||
Testing, security, and code quality experts.
|
||||
|
||||
- **qa-expert** - Test automation specialist
|
||||
- **security-auditor** - Security vulnerability expert
|
||||
- **code-reviewer** - Code quality guardian
|
||||
- **performance-engineer** - Performance optimization expert
|
||||
- **accessibility-specialist** - A11y compliance expert
|
||||
|
||||
### [05. Data & AI](categories/05-data-ai/)
|
||||
Data engineering, ML, and AI specialists.
|
||||
|
||||
- **data-engineer** - Data pipeline architect
|
||||
- **ml-engineer** - Machine learning specialist
|
||||
- **ai-researcher** - AI/LLM integration expert
|
||||
- **data-scientist** - Analytics and insights expert
|
||||
- **database-optimizer** - Database performance specialist
|
||||
|
||||
### [06. Developer Experience](categories/06-developer-experience/)
|
||||
Tooling and developer productivity experts.
|
||||
|
||||
- **refactoring-expert** - Code modernization specialist
|
||||
- **documentation-writer** - Technical documentation expert
|
||||
- **cli-developer** - Command-line tool creator
|
||||
- **dx-engineer** - Developer experience optimizer
|
||||
- **build-tool-expert** - Build system specialist
|
||||
|
||||
### [07. Specialized Domains](categories/07-specialized-domains/)
|
||||
Domain-specific technology experts.
|
||||
|
||||
- **payment-integration** - Payment systems expert
|
||||
- **blockchain-developer** - Web3 and crypto specialist
|
||||
- **iot-engineer** - IoT systems developer
|
||||
- **game-developer** - Game development expert
|
||||
- **ar-vr-developer** - AR/VR specialist
|
||||
|
||||
### [08. Business & Product](categories/08-business-product/)
|
||||
Product management and business analysis.
|
||||
|
||||
- **product-manager** - Product strategy expert
|
||||
- **business-analyst** - Requirements specialist
|
||||
- **ux-researcher** - User research expert
|
||||
- **growth-engineer** - Growth optimization specialist
|
||||
- **analytics-engineer** - Business metrics expert
|
||||
|
||||
### [09. Meta & Orchestration](categories/09-meta-orchestration/)
|
||||
Agent coordination and meta-programming.
|
||||
|
||||
- **agent-organizer** - Multi-agent coordinator
|
||||
- **context-manager** - Context optimization expert
|
||||
- **task-planner** - Complex task orchestrator
|
||||
- **workflow-designer** - Process automation expert
|
||||
- **agent-developer** - Subagent creation specialist
|
||||
|
||||
### [10. Research & Analysis](categories/10-research-analysis/)
|
||||
Research, search, and analysis specialists.
|
||||
|
||||
- **code-searcher** - Codebase exploration expert
|
||||
- **bug-hunter** - Bug detection specialist
|
||||
- **dependency-analyzer** - Dependency management expert
|
||||
- **tech-researcher** - Technology research specialist
|
||||
- **legacy-modernizer** - Legacy code expert
|
||||
|
||||
## ⭐ Featured Subagents
|
||||
|
||||
1. [Backend Developer](categories/01-core-development/backend-developer.md) - Scalable API development
|
||||
2. [Frontend Developer](categories/01-core-development/frontend-developer.md) - Modern UI engineering
|
||||
3. [Fullstack Developer](categories/01-core-development/fullstack-developer.md) - End-to-end features
|
||||
4. [GraphQL Architect](categories/01-core-development/graphql-architect.md) - GraphQL federation expert
|
||||
5. [Microservices Architect](categories/01-core-development/microservices-architect.md) - Distributed systems
|
||||
|
||||
## 🛠️ How to Use Subagents
|
||||
|
||||
### With Claude Code
|
||||
1. Create a `.claude/subagents/` directory in your project
|
||||
2. Copy the subagent definition file
|
||||
3. Claude Code will automatically recognize and use the subagent
|
||||
|
||||
### With VoltAgent Framework
|
||||
```bash
|
||||
# Install VoltAgent CLI
|
||||
npm install -g @voltagent/cli
|
||||
|
||||
# Add a subagent
|
||||
voltagent add backend-developer
|
||||
|
||||
# Use in your workflow
|
||||
voltagent run backend-developer "Create a REST API"
|
||||
```
|
||||
|
||||
## 📖 Subagent Structure
|
||||
|
||||
Each subagent follows a standardized template:
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: subagent-name
|
||||
description: Brief description of capabilities
|
||||
tools: List of MCP tools used
|
||||
---
|
||||
|
||||
Role definition and expertise...
|
||||
|
||||
## MCP Tool Integration
|
||||
Tool descriptions and usage patterns...
|
||||
|
||||
## Communication Protocol
|
||||
Inter-agent communication specifications...
|
||||
|
||||
## Implementation Workflow
|
||||
Structured development phases...
|
||||
```
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
|
||||
We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
|
||||
|
||||
- Submit new subagents via PR
|
||||
- Improve existing definitions
|
||||
- Add new MCP tool integrations
|
||||
- Share usage examples
|
||||
- Report issues and bugs
|
||||
|
||||
## 👥 Maintainers
|
||||
|
||||
This repository is maintained by the [VoltAgent](https://github.com/voltagent) team:
|
||||
|
||||
- Core maintainers of the VoltAgent open-source AI agent framework
|
||||
- Active contributors to the Claude Code ecosystem
|
||||
- Committed to best practices and production readiness
|
||||
|
||||
## 📄 License
|
||||
|
||||
MIT License - see [LICENSE](LICENSE)
|
||||
MIT License - see [LICENSE](LICENSE)
|
||||
|
||||
## 🔗 Related Resources
|
||||
|
||||
- [VoltAgent Framework](https://github.com/voltagent/voltagent)
|
||||
- [Claude Code Documentation](https://docs.anthropic.com/claude-code)
|
||||
- [MCP Tool Registry](https://github.com/modelcontextprotocol/tools)
|
||||
- [Community Discord](https://discord.gg/voltagent)
|
||||
|
||||
---
|
||||
|
||||
<p align="center">
|
||||
Made with ❤️ by the VoltAgent Community
|
||||
</p>
|
||||
Reference in New Issue
Block a user