Agent Registry #

Complete registry of all 35+ specialized AI agents available in ClaudeAutoPM. This page provides descriptions, use cases, and examples for each agent to help you choose the right tool for your task.

🚀 Recent Optimization (v1.2.0) #

Summary of Changes #

• Reduced agent count from 50+ to ~35 (Phase 1 complete)
• Consolidated similar agents into parameterized versions
• Unified coordination rules for better efficiency
• Maintained all functionality through parameters

Key Consolidations #

1. UI Frameworks: 4 agents → 1 react-ui-expert
2. Python Backend: 3 agents → 1 python-backend-expert
3. Docker: 3 agents → 1 docker-containerization-expert
4. E2E Testing: 2 agents → 1 e2e-test-engineer

Core Agents #

agent-manager #

Location: .claude/agents/core/agent-manager.mdPurpose: Agent lifecycle management and creation Use for: Creating new agents, updating documentation, registry maintenance Example:

@agent-manager create a specialized agent for GraphQL development with Apollo Server expertise

file-analyzer #

Location: .claude/agents/core/file-analyzer.mdPurpose: Analyze and summarize large files to reduce context usage Use for: Log analysis, documentation review, test output summarization Example:

@file-analyzer summarize the key errors in this 5000-line installation log

code-analyzer #

Location: .claude/agents/core/code-analyzer.mdPurpose: Code review, bug detection, and logic flow analysis Use for: Pre-commit reviews, security scanning, architecture analysis Example:

@code-analyzer review this authentication module for security vulnerabilities

test-runner #

Location: .claude/agents/core/test-runner.mdPurpose: Test execution and comprehensive result analysis Use for: Running test suites, failure analysis, coverage reports Example:

@test-runner execute all integration tests and analyze any failures

parallel-worker #

Location: .claude/agents/core/parallel-worker.mdPurpose: Coordinate multiple agents working on related tasks Use for: Complex multi-step workflows, parallel task execution Example:

@parallel-worker coordinate testing, building, and deployment tasks

mcp-manager #

Location: .claude/agents/core/mcp-manager.mdPurpose: Manage Model Context Protocol server configurations Use for: MCP server setup, configuration, troubleshooting Example:

@mcp-manager configure Context7 MCP server for documentation indexing

Framework Agents #

react-ui-expert #

Location: .claude/agents/frameworks/react-ui-expert.mdPurpose: React development with modern patterns (consolidated from 4 UI agents) Expertise: React 18+, hooks, state management, component patterns Example:

@react-ui-expert build a data table component with sorting, filtering, and pagination

e2e-test-engineer #

Location: .claude/agents/frameworks/e2e-test-engineer.mdPurpose: End-to-end testing across platforms (consolidated) Expertise: Playwright, Cypress, Selenium, cross-browser testing Example:

@e2e-test-engineer create Playwright tests for the complete checkout workflow

tailwindcss-expert #

Location: .claude/agents/frameworks/tailwindcss-expert.mdPurpose: Tailwind CSS styling and design systems Expertise: Utility-first CSS, responsive design, component styling Example:

@tailwindcss-expert design a responsive dashboard layout with dark mode support

mui-react-expert #

Location: .claude/agents/frameworks/mui-react-expert.mdPurpose: Material-UI React component development Expertise: MUI components, theming, custom components Example:

@mui-react-expert create a Material-UI form with validation and stepper component

antd-react-expert #

Location: .claude/agents/frameworks/antd-react-expert.mdPurpose: Ant Design React development Expertise: Ant Design components, forms, tables, layouts Example:

@antd-react-expert build an admin dashboard with Ant Design Pro components

bootstrap-ui-expert #

Location: .claude/agents/frameworks/bootstrap-ui-expert.mdPurpose: Bootstrap-based UI development Expertise: Bootstrap 5, responsive grids, component styling Example:

@bootstrap-ui-expert create a responsive landing page with Bootstrap components

chakra-ui-expert #

Location: .claude/agents/frameworks/chakra-ui-expert.mdPurpose: Chakra UI component development Expertise: Chakra UI components, theming, accessibility Example:

@chakra-ui-expert build an accessible form system with Chakra UI components

fastapi-backend-engineer #

Location: .claude/agents/frameworks/fastapi-backend-engineer.mdPurpose: FastAPI backend development Expertise: FastAPI, async endpoints, dependency injection, OpenAPI Example:

@fastapi-backend-engineer create a REST API with authentication and database integration

flask-backend-engineer #

Location: .claude/agents/frameworks/flask-backend-engineer.mdPurpose: Flask web application development Expertise: Flask, blueprints, extensions, SQLAlchemy Example:

@flask-backend-engineer build a web application with user authentication and admin panel

playwright-test-engineer #

Location: .claude/agents/frameworks/playwright-test-engineer.mdPurpose: Playwright-specific testing and automation Expertise: Playwright API, page objects, visual testing Example:

@playwright-test-engineer implement visual regression tests for the UI components

playwright-mcp-frontend-tester #

Location: .claude/agents/frameworks/playwright-mcp-frontend-tester.mdPurpose: Frontend testing with Playwright MCP integration Expertise: MCP-enabled testing, automated UI testing Example:

@playwright-mcp-frontend-tester create automated tests for the MCP-enabled frontend

react-frontend-engineer #

Location: .claude/agents/frameworks/react-frontend-engineer.mdPurpose: React application architecture and development Expertise: React patterns, state management, routing, performance Example:

@react-frontend-engineer architect a scalable React application with proper state management

ux-design-expert #

Location: .claude/agents/frameworks/ux-design-expert.mdPurpose: UX design and user experience optimization Expertise: User flows, wireframing, accessibility, design systems Example:

@ux-design-expert design an intuitive user onboarding flow with accessibility considerations

nats-messaging-expert #

Location: .claude/agents/frameworks/nats-messaging-expert.mdPurpose: NATS messaging system integration Expertise: NATS streaming, microservices communication, message patterns Example:

@nats-messaging-expert implement event-driven communication between microservices

Language Specialists #

python-backend-expert #

Location: .claude/agents/languages/python-backend-expert.mdPurpose: Python backend development (consolidated from 3 agents) Expertise: FastAPI, Django, Flask, async programming, testing Example:

@python-backend-expert create a microservice with FastAPI, database integration, and tests

python-backend-engineer #

Location: .claude/agents/languages/python-backend-engineer.mdPurpose: Python backend engineering and architecture Expertise: System design, API development, database integration Example:

@python-backend-engineer design a scalable backend architecture for high-traffic application

nodejs-backend-engineer #

Location: .claude/agents/languages/nodejs-backend-engineer.mdPurpose: Node.js backend development Expertise: Express, NestJS, middleware, real-time features Example:

@nodejs-backend-engineer implement a real-time chat system with WebSocket support

javascript-frontend-engineer #

Location: .claude/agents/languages/javascript-frontend-engineer.mdPurpose: Frontend JavaScript development Expertise: Modern JavaScript, DOM manipulation, module systems Example:

@javascript-frontend-engineer optimize JavaScript performance and implement lazy loading

bash-scripting-expert #

Location: .claude/agents/languages/bash-scripting-expert.mdPurpose: Shell scripting and automation Expertise: Bash scripting, system administration, automation Example:

@bash-scripting-expert create deployment scripts with error handling and logging

DevOps Agents #

docker-containerization-expert #

Location: .claude/agents/devops/docker-containerization-expert.mdPurpose: Docker and containerization (consolidated from 3 agents) Expertise: Dockerfile optimization, multi-stage builds, security, orchestration Example:

@docker-containerization-expert create optimized Docker setup for microservices deployment

kubernetes-orchestrator #

Location: .claude/agents/devops/kubernetes-orchestrator.mdPurpose: Kubernetes deployment and management Expertise: K8s manifests, Helm charts, scaling, service mesh Example:

@kubernetes-orchestrator design a scalable Kubernetes deployment with auto-scaling

github-operations-specialist #

Location: .claude/agents/devops/github-operations-specialist.mdPurpose: GitHub Actions, workflows, and repository management Expertise: CI/CD pipelines, Actions, release automation Example:

@github-operations-specialist create a comprehensive CI/CD pipeline with testing and deployment

azure-devops-specialist #

Location: .claude/agents/devops/azure-devops-specialist.mdPurpose: Azure DevOps integration and automation Expertise: Azure Pipelines, Boards, Repos, deployment Example:

@azure-devops-specialist setup Azure DevOps pipeline with multi-environment deployment

docker-compose-expert #

Location: .claude/agents/devops/docker-compose-expert.mdPurpose: Docker Compose orchestration Expertise: Multi-container applications, networking, volumes Example:

@docker-compose-expert create development environment with database, cache, and monitoring

docker-expert #

Location: .claude/agents/devops/docker-expert.mdPurpose: Advanced Docker techniques and optimization Expertise: Performance tuning, security, registry management Example:

@docker-expert optimize Docker images for production deployment with security scanning

docker-development-orchestrator #

Location: .claude/agents/devops/docker-development-orchestrator.mdPurpose: Docker-based development environment setup Expertise: Development workflows, hot reloading, debugging Example:

@docker-development-orchestrator setup development environment with hot reload and debugging

ssh-operations-expert #

Location: .claude/agents/devops/ssh-operations-expert.mdPurpose: SSH configuration, security, and automation Expertise: SSH keys, tunneling, automation, security Example:

@ssh-operations-expert setup secure SSH access with key management and automation

traefik-proxy-expert #

Location: .claude/agents/devops/traefik-proxy-expert.mdPurpose: Traefik reverse proxy configuration Expertise: Load balancing, SSL termination, service discovery Example:

@traefik-proxy-expert configure Traefik for microservices with automatic SSL certificates

mcp-context-manager #

Location: .claude/agents/devops/mcp-context-manager.mdPurpose: Model Context Protocol deployment and management Expertise: MCP servers, context management, integration Example:

@mcp-context-manager deploy and configure MCP servers for development team

Cloud Architecture Agents #

aws-cloud-architect #

Location: .claude/agents/cloud/aws-cloud-architect.mdPurpose: AWS infrastructure design and implementation Expertise: EC2, Lambda, RDS, VPC, CloudFormation, cost optimization Example:

@aws-cloud-architect design serverless architecture for image processing with auto-scaling

azure-cloud-architect #

Location: .claude/agents/cloud/azure-cloud-architect.mdPurpose: Azure cloud infrastructure and services Expertise: Azure VMs, AKS, Functions, ARM templates, cost management Example:

@azure-cloud-architect create Azure infrastructure with AKS cluster and monitoring

gcp-cloud-architect #

Location: .claude/agents/cloud/gcp-cloud-architect.mdPurpose: Google Cloud Platform architecture Expertise: Compute Engine, GKE, Cloud Functions, Terraform Example:

@gcp-cloud-architect implement event-driven architecture with Cloud Run and Pub/Sub

terraform-infrastructure-expert #

Location: .claude/agents/cloud/terraform-infrastructure-expert.mdPurpose: Infrastructure as Code with Terraform Expertise: Terraform modules, state management, multi-cloud deployments Example:

@terraform-infrastructure-expert create reusable Terraform modules for multi-environment deployment

kubernetes-orchestrator #

Location: .claude/agents/cloud/kubernetes-orchestrator.mdPurpose: Kubernetes orchestration and management Expertise: K8s deployment, scaling, monitoring, service mesh Example:

@kubernetes-orchestrator implement blue-green deployment strategy with monitoring

openai-python-expert #

Location: .claude/agents/cloud/openai-python-expert.mdPurpose: OpenAI API integration with Python Expertise: OpenAI APIs, embeddings, fine-tuning, Python integration Example:

@openai-python-expert implement intelligent document processing with OpenAI embeddings

gemini-api-expert #

Location: .claude/agents/cloud/gemini-api-expert.mdPurpose: Google Gemini API integration Expertise: Gemini Pro, multimodal AI, Google AI Studio Example:

@gemini-api-expert create multimodal AI application with text and image processing

gcp-cloud-functions-engineer #

Location: .claude/agents/cloud/gcp-cloud-functions-engineer.mdPurpose: Google Cloud Functions development Expertise: Serverless functions, event triggers, HTTP functions Example:

@gcp-cloud-functions-engineer create event-driven serverless functions for data processing

Database Specialists #

postgresql-expert #

Location: .claude/agents/databases/postgresql-expert.mdPurpose: PostgreSQL database design and optimization Expertise: Schema design, query optimization, indexes, performance tuning Example:

@postgresql-expert optimize database schema for high-performance e-commerce application

mongodb-expert #

Location: .claude/agents/databases/mongodb-expert.mdPurpose: MongoDB NoSQL database development Expertise: Document design, aggregation pipelines, indexing, sharding Example:

@mongodb-expert design scalable document schema for user activity tracking

redis-expert #

Location: .claude/agents/databases/redis-expert.mdPurpose: Redis caching and data structures Expertise: Caching strategies, data structures, performance optimization Example:

@redis-expert implement distributed caching strategy with Redis cluster

cosmosdb-expert #

Location: .claude/agents/databases/cosmosdb-expert.mdPurpose: Azure Cosmos DB development Expertise: Multi-model database, global distribution, consistency levels Example:

@cosmosdb-expert design globally distributed database with optimal consistency model

bigquery-expert #

Location: .claude/agents/databases/bigquery-expert.mdPurpose: Google BigQuery analytics and data warehousing Expertise: SQL optimization, data modeling, analytics, streaming Example:

@bigquery-expert create data warehouse with real-time analytics and reporting

Data Pipeline Agents #

langgraph-workflow-expert #

Location: .claude/agents/data/langgraph-workflow-expert.mdPurpose: LangGraph workflow orchestration Expertise: AI workflow design, graph-based processing, state management Example:

@langgraph-workflow-expert create intelligent document processing workflow with multiple AI agents

airflow-orchestration-expert #

Location: .claude/agents/data/airflow-orchestration-expert.mdPurpose: Apache Airflow data pipeline orchestration Expertise: DAGs, task scheduling, data pipeline automation Example:

@airflow-orchestration-expert design data pipeline for ETL processing with monitoring

kedro-pipeline-expert #

Location: .claude/agents/data/kedro-pipeline-expert.mdPurpose: Kedro data science pipeline development Expertise: ML pipelines, data versioning, experiment tracking Example:

@kedro-pipeline-expert create ML pipeline with data versioning and experiment tracking

Decision Matrix Agents #

playwright-testing-selection #

Location: .claude/agents/decision-matrices/playwright-testing-selection.mdPurpose: Help choose optimal Playwright testing approach Use for: Test strategy decisions, framework selection Example:

@playwright-testing-selection recommend testing approach for e-commerce application

python-backend-selection #

Location: .claude/agents/decision-matrices/python-backend-selection.mdPurpose: Choose optimal Python backend framework Use for: Architecture decisions, framework selection Example:

@python-backend-selection recommend backend stack for high-traffic API

ui-framework-selection #

Location: .claude/agents/decision-matrices/ui-framework-selection.mdPurpose: Help choose UI framework and approach Use for: Frontend technology decisions, component library selection Example:

@ui-framework-selection recommend UI stack for enterprise dashboard application

Agent Usage Tips #

Legacy Agent Support #

Legacy agent names continue to work with deprecation warnings:

• @docker-expert → @docker-containerization-expert
• @react-expert → @react-ui-expert
• @python-expert → @python-backend-expert

Best Practices #

1. Use specific agents for specialized tasks
2. Combine agents for complex workflows
3. Provide context to get better results
4. Start with decision matrices when unsure

Agent Coordination #

When using multiple agents:

# Sequential execution
@code-analyzer review code quality
THEN @test-runner execute tests
THEN @docker-containerization-expert prepare deployment

# Parallel execution (when enabled)
@code-analyzer review backend/
@test-runner execute unit tests
@docker-containerization-expert build images

Migration from Legacy Agents #

If you're using deprecated agent names, update to the new consolidated agents:

Related Pages #

• Agent Selection Guide - Choose the right agent
• Custom Agents - Create your own agents
• Configuration Options - Agent configuration
• Testing Strategies - Testing with agents