📁 Repository Structure

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/

🎯 Agent Philosophy

🧠 Guidance-First Approach

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

📏 Agent Design Principles

• 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

🎯 Agent Categories

🔤 Languages

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

🏗️ Frameworks

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

🔄 Development Workflows

Agents focused on development workflows, code quality, and team collaboration with comprehensive automation and best practices.

Development Workflow

• 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

Team Collaboration

• 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

Testing & Quality

• 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 & Deployment

• Release Manager - Release planning, changelog generation, version management, and rollback strategies
• Environment Manager - Development, staging, production environments, and infrastructure configuration management

🏛️ Architecture

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 Exp