A comprehensive collection of specialized Claude Code agents for software development, designed as expert consultants that provide architectural guidance, decision frameworks, and best practices. Each agent focuses on helping you make informed technology choices and design decisions rather than generating code.
-
Install Claude Code: Follow the official installation guide
-
Clone this repository:
git clone https://github.com/supatest-ai/awesome-claude-code-agents.git cd awesome-claude-code-agents -
Copy agent files: Copy the agent
.mdfiles to your Claude Code agents directory:cp */*.md ~/.config/claude-code/agents/
-
Verify installation: List available agents:
claude-code agents list
Claude Code agents can be invoked in several ways:
- Automatic Invocation: Agents with
PROACTIVELYin their description will be automatically invoked based on context - Manual Invocation: Use
@agent-namein your messages to explicitly invoke an agent - Task-Specific: Agents will be suggested based on the files you're working with and the tasks you're performing
For more details, see the Claude Code documentation.
awesome-claude-code-agents/
├── README.md # This file
├── CONTRIBUTING.md # Contribution guidelines
├── languages/ # Programming language experts
│ ├── python-expert.md
│ ├── javascript-typescript-expert.md
│ ├── java-expert.md
│ ├── go-expert.md
│ ├── csharp-expert.md
│ ├── rust-expert.md
│ ├── ruby-expert.md
│ ├── php-expert.md
│ ├── swift-expert.md
│ └── kotlin-expert.md
├── frameworks/ # Framework specialists
│ ├── react-architect.md
│ ├── vue-specialist.md
│ ├── angular-expert.md
│ ├── django-expert.md
│ └── spring-boot-expert.md
├── development-workflows/ # Development workflow experts
│ └── code-review-master.md
├── architecture/ # System architecture specialists
│ ├── design-patterns-expert.md
│ ├── microservices-architect.md
│ └── clean-architecture-expert.md
├── testing/ # Testing and quality assurance
│ ├── test-automation-specialist.md
│ └── performance-testing-expert.md
├── performance/ # Performance specialists
│ └── performance-optimization-specialist.md
├── data-science/ # Data science and analytics
│ └── python-data-scientist.md
├── llm-engineering/ # LLM engineering and operations
│ ├── prompt-engineering-specialist.md
│ ├── rag-architecture-expert.md
│ ├── llmops-engineer.md
│ ├── multi-agent-systems-architect.md
│ ├── llm-finetuning-expert.md
│ └── llm-observability-specialist.md
├── ai-ml/ # AI and machine learning
│ └── machine-learning-engineer.md
├── devops/ # DevOps and infrastructure
│ ├── aws-cloud-architect.md
│ ├── docker-specialist.md
│ ├── kubernetes-expert.md
│ └── terraform-infrastructure-expert.md
├── industries/ # Industry domain experts
│ ├── fintech-security-expert.md
│ └── healthcare-hipaa-expert.md
├── templates/ # Agent templates for custom agents
│ ├── basic-agent-template.md
│ └── advanced-agent-template.md
└── docs/ # Additional documentation
├── agent-development-guide.md
├── best-practices.md
└── examples/
Our agents function as specialized architectural consultants rather than code generators. They help you:
- Make Technology Decisions: When to use React vs Vue, PostgreSQL vs MongoDB
- Choose Architecture Patterns: Microservices vs monolith, CQRS vs traditional CRUD
- Optimize Performance: Caching strategies, database tuning, scaling approaches
- Navigate Ecosystems: Library selection, version management, best practices
- Solve Design Problems: Code organization, testing strategies, deployment patterns
- Decision Frameworks: Clear when/why/how guidance for technology choices
- Architectural Focus: System design and structural decisions over syntax
- Production-Ready: Enterprise-grade patterns and real-world considerations
- Ecosystem Navigation: Modern tooling and library selection guidance
- Best Practices: Security, performance, and maintainability built-in
Ecosystem guides for programming languages focusing on framework selection, performance optimization, and architectural decisions.
- Python Expert - Ecosystem guidance for Python 3.8+, framework selection (Django/FastAPI/Flask), and performance optimization
- JavaScript/TypeScript Expert - Modern JS/TS tooling decisions, build system selection, and performance patterns
- Java Expert - Java 17+ ecosystem choices, Spring vs alternatives, JVM optimization, and enterprise patterns
- Go Expert - Go project architecture, library selection, concurrency patterns, and performance optimization
- Haskell Expert - Advanced functional programming, type system features, STM, and performance optimization
- Clojure Expert - Functional programming, immutable data structures, concurrency primitives, and ClojureScript
Architecture specialists for popular frameworks focusing on project structure, state management decisions, and performance optimization.
- React Architect - React 18+ architectural decisions, state management selection, performance optimization, and testing strategies
- Vue Specialist - Vue 3 Composition API architecture, Pinia vs alternatives, performance patterns, and modern tooling
- Angular Expert - Angular 17+ architectural patterns, state management, RxJS optimization, and enterprise scaling
- Django Expert - Django architecture decisions, DRF vs alternatives, async patterns, and production deployment
- Spring Boot Expert - Spring Boot 3+ architectural choices, reactive programming decisions, and microservices patterns
Agents focused on development workflows, code quality, and team collaboration with comprehensive automation and best practices.
- Git Workflow Expert - Advanced Git strategies, branching models (Git Flow, GitHub Flow), merge conflict resolution, and hooks automation
- CI/CD Pipeline Architect - GitHub Actions, GitLab CI, Jenkins pipelines, testing automation, and deployment strategies
- Project Setup Wizard - Multi-language project scaffolding, tooling configuration, and development environment setup
- Code Quality Guardian - Linting, formatting, pre-commit hooks, quality gates, and technical debt management
- Documentation Specialist - README optimization, API docs, architectural decision records, and documentation automation
- Dependency Manager - Package management, security auditing, version updates, and license compliance
- Code Review Master - Comprehensive code review focusing on security, performance, maintainability, and best practices
- Agile Sprint Planner - User story creation, sprint planning, estimation techniques, and backlog management
- Technical Debt Analyst - Technical debt identification, refactoring strategies, and priority assessment
- Test Strategy Architect - Testing pyramid, test planning, coverage analysis, and test automation frameworks
- Security Audit Expert - Security scanning, vulnerability assessment, penetration testing, and secure coding practices
- Performance Profiler - Performance testing, bottleneck identification, load testing, and optimization strategies
- Release Manager - Release planning, changelog generation, version management, and rollback strategies
- Environment Manager - Development, staging, production environments, and infrastructure configuration management
System architecture specialists focusing on pattern selection, design decisions, and scalability strategies.
- Design Patterns Expert - Pattern selection guidance, when to use specific patterns, anti-pattern avoidance, and architectural decisions
- Microservices Architect - Microservices vs monolith decisions, service decomposition strategies, and distributed systems patterns
- Clean Architecture Expert - Architectural boundaries, dependency management, and enterprise application design
Comprehensive testing strategies and quality assurance practices.
- Test Automation Specialist - TDD/BDD practices, testing pyramid, E2E testing, property-based testing, and CI/CD integration
- Performance Testing Expert - Load testing, stress testing, performance monitoring, bottleneck identification, and optimization
Performance specialists focused on optimization and scalability.
- Performance Optimization Specialist - Frontend/backend optimization, database tuning, caching strategies, and monitoring
Infrastructure architecture specialists focusing on deployment strategies, scalability decisions, and operational excellence.
- Docker Specialist - Containerization strategy, optimization patterns, security considerations, and production deployment decisions
- Kubernetes Expert - Orchestration architecture, deployment strategies, scaling patterns, and operational excellence
- AWS Cloud Architect - Service selection framework, architectural patterns, cost optimization, and Well-Architected principles
- Terraform Infrastructure Expert - Infrastructure as Code patterns, state management strategies, and multi-cloud architecture
Specialized agents for Large Language Model engineering, operations, and production systems with focus on modern LLM application development.
- Prompt Engineering Specialist - Advanced prompt design, optimization techniques, few-shot learning, chain-of-thought reasoning, and evaluation frameworks
- RAG Architecture Expert - Retrieval-Augmented Generation systems, vector databases, document processing, and hybrid search strategies
- LLMOps Engineer - Production LLM deployment, model serving, scaling strategies, cost optimization, and operational monitoring
- Multi-Agent Systems Architect - Complex agent orchestration, coordination patterns, collaborative workflows, and distributed AI systems
- LLM Fine-tuning Expert - Parameter-efficient fine-tuning (PEFT), LoRA/QLoRA techniques, dataset preparation, and training optimization
- LLM Observability Specialist - Comprehensive monitoring, performance tracking, cost analysis, quality assessment, and system health for LLM applications
Data science and machine learning specialists for analytics, modeling, and production ML systems.
- Python Data Scientist - Data exploration, statistical analysis, feature engineering, and machine learning workflows
- Machine Learning Engineer - MLOps, model deployment, monitoring, drift detection, and production ML infrastructure
Domain experts for specific industries with specialized knowledge and compliance requirements.
- FinTech Security Expert - Financial services security, PCI DSS compliance, KYC/AML, secure payment processing, and regulatory standards
- Healthcare HIPAA Expert - Healthcare technology, HIPAA compliance, medical data security, HL7 FHIR, and patient privacy
Unlike traditional code-generation agents, our agents are designed as specialized consultants that help you make informed architectural and technology decisions:
Traditional Agents: Our Agents:
"Here's React code" → "When to choose React vs Vue vs Angular"
"FastAPI example" → "Django vs FastAPI vs Flask decision matrix"
"Docker config" → "Containerization strategy and patterns"
"AWS Lambda code" → "Serverless vs container deployment decisions"
Based on analysis of successful Claude Code agent repositories, our agents follow proven patterns:
- 300-800 lines: Focused, actionable content (vs 2000+ line tutorials)
- 80/20 Guidance/Code: Decision frameworks over implementations
- Production-Ready: Enterprise patterns and real-world considerations
- Model-Optimized: Sonnet for complex decisions, Haiku for simple tasks
Each agent acts as a domain expert consultant providing:
- Technology Selection: When/why to choose specific tools and frameworks
- Architecture Patterns: System design and structural decisions
- Performance Optimization: Scaling strategies and bottleneck identification
- Best Practices: Security, maintainability, and operational excellence
- Ecosystem Navigation: Modern tooling and version management
Each agent in this collection follows these design principles:
- Single Responsibility: Each agent has a clear, focused area of expertise
- Deep Knowledge: Comprehensive understanding of their domain with modern best practices
- Practical Examples: Production-ready code examples and real-world scenarios
- Current Technologies: Up-to-date with latest versions and features
- Security First: Security considerations and best practices built-in
- Performance Oriented: Optimization patterns and performance considerations
- Clear Instructions: Step-by-step guidance and usage examples
- Code Samples: Extensive, well-commented code examples
- Testing Strategies: Comprehensive testing approaches and examples
- Error Handling: Robust error handling and edge case management
- Scalability: Patterns that work at scale
- Maintainability: Clean, readable, and maintainable code practices
All agents follow the Claude Code subagent format with YAML frontmatter:
---
name: agent-name
description: Brief description with PROACTIVELY keyword for auto-invocation
tools: Read, Write, Edit, Bash, Grep, Glob, MultiEdit
---- name: Unique identifier for the agent (kebab-case)
- description: Clear description of agent capabilities and when to use it
- tools: List of Claude Code tools the agent can access
- Use
PROACTIVELYin description for agents that should be auto-invoked - Be specific about when and how the agent should be used
- Include the most relevant tools for the agent's domain
We welcome contributions from the community! See our Contributing Guidelines for details on:
- Adding new agents
- Improving existing agents
- Reporting issues
- Suggesting enhancements
- Fork the repository
- Create a new agent using our templates
- Follow our best practices guide
- Submit a pull request
- Claude Code Documentation - Official Claude Code documentation
- Agent Development Guide - Detailed guide for creating custom agents
- Best Practices - Best practices for agent development
- Examples - Example use cases and implementations
This project is licensed under the MIT License - see the LICENSE file for details.
This project builds upon the excellent work of the open-source community. Special thanks to:
- The Claude Code team at Anthropic
- Contributors to popular frameworks and libraries referenced in our agents
- The broader developer community for sharing knowledge and best practices
If you find this collection helpful, please consider:
- ⭐ Starring the repository
- 🐛 Reporting issues or bugs
- 💡 Suggesting new agents or improvements
- 🤝 Contributing to the project
- 📢 Sharing with other developers
Built with ❤️ for the developer community