An open API service indexing awesome lists of open source software.

https://github.com/vijaythecoder/awesome-claude-agents

An orchestrated sub agent dev team powered by claude code
https://github.com/vijaythecoder/awesome-claude-agents

List: awesome-claude-agents

Last synced: 2 months ago
JSON representation

An orchestrated sub agent dev team powered by claude code

Awesome Lists containing this project

README

          

# Awesome Claude Agents - AI Development Team 🚀

**Supercharge Claude Code with a team of specialized AI agents** that work together to build complete features, debug complex issues, and handle any technology stack with expert-level knowledge.

## 🎯 The Problem & Solution

While Claude Code is powerful, complex projects need specialized expertise. Generic AI responses often miss best practices, leading to suboptimal code.

**Our solution:** A team of specialized AI agents that work together, each with deep expertise in their domain. Just like a real development team, but available 24/7.

## 💡 See The Difference

```
You: "Build user management"

Without Agent Team:
Claude: *Generic authentication implementation*

With Agent Team:
├── Tech Lead: "I'll coordinate this complex feature for your project"
├── Project Analyst: "Detected Django + React stack, assembling specialists"
├── Backend Expert: "Implementing authentication with Django patterns"
├── API Architect: "Designing RESTful resources with validation"
├── Frontend Dev: "Building React components with modern patterns"
└── Database Expert: "Optimizing queries and relationships"

Result: Production-ready implementation tailored to your stack
```

## ⚠️ Important Notice

**This project is experimental and token-intensive.** I'm actively testing these agents with Claude Max subscription ($200/month) - expect high token consumption during complex workflows. Use with caution and monitor your usage.

## 🚀 Quick Start (2 Minutes)

### 1. Install the Agents
```bash
git clone https://github.com/vijaythecoder/awesome-claude-agents.git
cp -r awesome-claude-agents/agents ~/.claude/
```

### 2. Configure for Your Project
Navigate to your project directory and run:

```bash
claude "Use team-configurator to set up my AI development team"
```

### 3. Start Building
```bash
claude "Build a complete user authentication system"
```

Your AI team will automatically use the right specialists for your tech stack!

## 🎯 How Auto-Configuration Works

The team-configurator agent is your AI team setup expert. When invoked, it:

1. **Checks Existing Setup** - Looks for CLAUDE.md and preserves your customizations
2. **Analyzes Your Stack** - Uses project-analyst to detect frameworks and patterns
3. **Scans Available Agents** - Discovers all agents in ~/.claude/agents/
4. **Creates Smart Mappings** - Routes tasks to the perfect specialist
5. **Updates CLAUDE.md** - Saves configuration without removing existing content

### Three-Phase Orchestration

Your Tech Lead coordinates work through:
- **Research Phase** - Multiple specialists gather information in parallel
- **Planning Phase** - Creates tasks with TodoWrite, identifying dependencies
- **Execution Phase** - Agents work together, sharing context efficiently

Example output for a Django + React project:
```markdown
✅ Project Optimization Complete!

Detected Stack:
- Backend: Django 4.2 (Python)
- Frontend: React 18 with TypeScript
- Database: PostgreSQL

Configured Specialists:
- API: @django-api-developer
- Backend: @django-backend-expert
- Frontend: @react-component-architect
- Database: @django-orm-expert

Your AI development team is ready!
```

## 👥 Meet Your AI Development Team

### 🎭 Orchestrators (3 agents)
- **[Tech Lead Orchestrator](agents/orchestrators/tech-lead-orchestrator.md)** - Coordinates complex projects through three-phase workflow
- **[Project Analyst](agents/orchestrators/project-analyst.md)** - Detects your tech stack and enables smart routing
- **[Team Configurator](agents/orchestrators/team-configurator.md)** - Sets up your perfect AI development team automatically

### 💼 Framework Specialists (15 agents)
- **Laravel** - Backend Expert, API Architect, Eloquent Expert
- **Django** - Backend Expert, API Developer, ORM Expert
- **Rails** - Backend Expert, API Developer, ActiveRecord Expert
- **React** - Component Architect, State Manager, Next.js Expert
- **Vue** - Component Architect, State Manager, Nuxt Expert

### 🌐 Universal Experts (4 agents)
- **[Backend Developer](agents/universal/backend-developer.md)** - Polyglot programmer for any backend
- **[Frontend Developer](agents/universal/frontend-developer.md)** - Modern UI for any framework
- **[API Architect](agents/universal/api-architect.md)** - RESTful and GraphQL design
- **[Tailwind CSS Expert](agents/universal/tailwind-css-expert.md)** - Pixel-perfect responsive designs

### 🔧 Core Team (4 agents)
- **[Code Archaeologist](agents/core/code-archaeologist.md)** - Explores and documents any codebase
- **[Code Reviewer](agents/core/code-reviewer.md)** - Ensures quality and best practices
- **[Performance Optimizer](agents/core/performance-optimizer.md)** - Makes everything blazing fast
- **[Documentation Specialist](agents/core/documentation-specialist.md)** - Creates clear, comprehensive documentation

**Total: 26 specialized agents** working together to build your projects!

[Browse all agents →](agents/)

## 🎬 Real-World Examples

### E-commerce Shopping Cart
```
You: "Add a shopping cart to my online store where users can add products,
update quantities, and see the total price with tax calculation"

Tech Lead orchestrates:
→ Research:
• Project Analyst detects Laravel + Vue.js stack
• Code Archaeologist examines existing product/user models
• API Architect reviews current endpoint patterns

→ Planning: Creates tasks for cart schema, API endpoints, UI components

→ Execution:
• Laravel Backend Expert creates Cart model and relationships
• Laravel API Architect builds RESTful cart endpoints
• Vue Component Architect implements reactive cart sidebar
• Backend Developer integrates tax calculation API

Result: Working cart with persistent storage, guest checkout support,
and automatic tax calculation based on user location
```

### User Authentication System
```
You: "I need users to sign up with email verification, login with remember me
option, and reset forgotten passwords"

Tech Lead orchestrates:
→ Research:
• Project Analyst identifies Django + React setup
• Code Reviewer checks security requirements
• Django Backend Expert reviews existing User model

→ Planning: User model extension, JWT tokens, email templates, auth forms

→ Execution:
• Django Backend Expert implements registration with email verification
• Django API Developer creates secure auth endpoints
• React Component Architect builds responsive login/signup forms
• Performance Optimizer adds rate limiting and caching

Result: Complete auth system with JWT tokens, secure password hashing,
email verification, and forgot password flow
```

### Analytics Dashboard
```
You: "Show me daily active users, revenue trends for last 30 days, and
top-selling products in a dashboard"

Tech Lead orchestrates:
→ Research:
• Project Analyst detects Rails + React with PostgreSQL
• Performance Optimizer profiles current query performance
• Rails Backend Expert identifies data sources

→ Planning: Aggregation queries, caching strategy, chart components

→ Execution:
• Rails ActiveRecord Expert writes optimized analytics queries
• Performance Optimizer implements Redis caching layer
• React Component Architect builds interactive Chart.js visualizations
• Rails API Developer creates efficient data endpoints

Result: Real-time dashboard with sub-second load times, export functionality,
and mobile-responsive design
```

## 🔥 Why Teams Beat Solo AI

- **Specialized Expertise**: Each agent masters their domain with deep, current knowledge
- **Real Collaboration**: Agents coordinate seamlessly, sharing context and handing off tasks
- **Tailored Solutions**: Get code that matches your exact stack and follows its best practices
- **Parallel Execution**: Multiple specialists work simultaneously for faster delivery

## 📈 The Impact

- **Ship Faster** - Complete features in minutes, not days
- **Better Code Quality** - Every line follows best practices
- **Learn As You Code** - See how experts approach problems
- **Scale Confidently** - Architecture designed for growth

## 📚 Learn More

- [How Agent Teams Collaborate](docs/agent-team.md) - See the magic behind team coordination
- [Creating Custom Agents](docs/creating-agents.md) - Build specialists for your needs
- [Architecture Guide](docs/architecture.md) - Technical deep dive
- [Best Practices](docs/best-practices.md) - Get the most from your AI team

## 💬 Join The Community

- ⭐ **Star this repo** to show support
- 🐛 [Report issues](https://github.com/vijaythecoder/awesome-claude-agents/issues)
- 💡 [Share ideas](https://github.com/vijaythecoder/awesome-claude-agents/discussions)
- 🎉 [Success stories](https://github.com/vijaythecoder/awesome-claude-agents/discussions/categories/show-and-tell)

## 📄 License

MIT License - Use freely in your projects!

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=vijaythecoder/awesome-claude-agents&type=Date)](https://www.star-history.com/#vijaythecoder/awesome-claude-agents&Date)
---


Transform Claude Code into an AI development team that ships production-ready features

Simple setup. Powerful results. Just describe and build.


GitHub
Documentation
Community