agents/README.md

# Claude Code Plugins for Agents, Commands, and Workflows

A comprehensive production-ready system combining **84 specialized AI agents**, **15 multi-agent workflow orchestrators**, and **44 development tools** organized into **62 focused, single-purpose plugins** for [Claude Code](https://docs.claude.com/en/docs/claude-code/overview).

## Overview

This unified repository provides everything needed for intelligent automation and multi-agent orchestration across modern software development:

- **62 Focused Plugins** - Granular, single-purpose plugins optimized for minimal token usage and composability
- **84 Specialized Agents** - Domain experts with deep knowledge across architecture, languages, infrastructure, quality, data/AI, documentation, business operations, and SEO
- **15 Workflow Orchestrators** - Multi-agent coordination systems for complex operations like full-stack development, security hardening, ML pipelines, and incident response
- **44 Development Tools** - Optimized utilities including project scaffolding, security scanning, test automation, and infrastructure setup

### Key Features

- **Granular Plugin Architecture**: 62 focused plugins optimized for minimal token usage
- **Comprehensive Tooling**: 44 development tools including test generation, scaffolding, and security scanning
- **100% Agent Coverage**: All plugins include specialized agents
- **Clear Organization**: 23 categories with 1-6 plugins each for easy discovery
- **Efficient Design**: Average 3.4 components per plugin (follows Anthropic's 2-8 pattern)

### How It Works

Each plugin is completely isolated with its own agents and commands:

- **Install only what you need** - Each plugin loads only its specific agents and tools
- **Minimal token usage** - No unnecessary resources loaded into context
- **Mix and match** - Compose multiple plugins for complex workflows
- **Clear boundaries** - Each plugin has a single, focused purpose

**Example**: Installing `python-development` loads only 3 Python agents and 1 scaffolding tool (~300 tokens), not the entire marketplace.

## Installation

### Step 1: Add the Marketplace

Add this marketplace to Claude Code:

```bash
/plugin marketplace add wshobson/agents
```

This makes all 62 plugins available for installation, but **does not load any agents or tools** into your context.

### Step 2: Install Specific Plugins

Browse available plugins:

```bash
/plugin
```

Install only the plugins you need:

```bash
/plugin install python-development
/plugin install backend-development
```

Each installed plugin loads **only its specific agents and commands** into Claude's context.

## Quick Start - Essential Plugins

> 💡 **Getting Started?** Install these popular plugins for immediate productivity gains.

### Development Essentials

**code-documentation** - Documentation and technical writing

```bash
/plugin install code-documentation
```

Automated doc generation, code explanation, and tutorial creation for comprehensive technical documentation.

**debugging-toolkit** - Smart debugging and developer experience

```bash
/plugin install debugging-toolkit
```

Interactive debugging, error analysis, and DX optimization for faster problem resolution.

**git-pr-workflows** - Git automation and PR enhancement

```bash
/plugin install git-pr-workflows
```

Git workflow automation, pull request enhancement, and team onboarding processes.

### Full-Stack Development

**backend-development** - Backend API design and architecture

```bash
/plugin install backend-development
```

RESTful and GraphQL API design with test-driven development and modern backend architecture patterns.

**frontend-mobile-development** - UI and mobile development

```bash
/plugin install frontend-mobile-development
```

React/React Native component development with automated scaffolding and cross-platform implementation.

**full-stack-orchestration** - End-to-end feature development

```bash
/plugin install full-stack-orchestration
```

Multi-agent coordination from backend → frontend → testing → security → deployment.

### Testing & Quality

**unit-testing** - Automated test generation

```bash
/plugin install unit-testing
```

Generate pytest (Python) and Jest (JavaScript) unit tests automatically with comprehensive edge case coverage.

**code-review-ai** - AI-powered code review

```bash
/plugin install code-review-ai
```

Architectural analysis, security assessment, and code quality review with actionable feedback.

### Infrastructure & Operations

**cloud-infrastructure** - Cloud architecture design

```bash
/plugin install cloud-infrastructure
```

AWS/Azure/GCP architecture, Kubernetes setup, Terraform IaC, and multi-cloud cost optimization.

**incident-response** - Production incident management

```bash
/plugin install incident-response
```

Rapid incident triage, root cause analysis, and automated resolution workflows for production systems.

### Language Support

**python-development** - Python project scaffolding

```bash
/plugin install python-development
```

FastAPI/Django project initialization with modern tooling (uv, ruff) and production-ready architecture.

**javascript-typescript** - JavaScript/TypeScript scaffolding

```bash
/plugin install javascript-typescript
```

Next.js, React + Vite, and Node.js project setup with pnpm and TypeScript best practices.

---

## Complete Plugin Reference

> 📋 **All 62 Plugins** - Browse by category to find specialized plugins for your workflow.

### 🎨 Development (4 plugins)

| Plugin                          | Description                                       | Install                                       |
| ------------------------------- | ------------------------------------------------- | --------------------------------------------- |
| **debugging-toolkit**           | Interactive debugging and DX optimization         | `/plugin install debugging-toolkit`           |
| **backend-development**         | Backend API design with GraphQL and TDD           | `/plugin install backend-development`         |
| **frontend-mobile-development** | Frontend UI and mobile development                | `/plugin install frontend-mobile-development` |
| **multi-platform-apps**         | Cross-platform app coordination (web/iOS/Android) | `/plugin install multi-platform-apps`         |

### 📚 Documentation (2 plugins)

| Plugin                       | Description                                   | Install                                    |
| ---------------------------- | --------------------------------------------- | ------------------------------------------ |
| **code-documentation**       | Documentation generation and code explanation | `/plugin install code-documentation`       |
| **documentation-generation** | OpenAPI specs, Mermaid diagrams, tutorials    | `/plugin install documentation-generation` |

### 🔄 Workflows (3 plugins)

| Plugin                       | Description                         | Install                                    |
| ---------------------------- | ----------------------------------- | ------------------------------------------ |
| **git-pr-workflows**         | Git automation and PR enhancement   | `/plugin install git-pr-workflows`         |
| **full-stack-orchestration** | End-to-end feature orchestration    | `/plugin install full-stack-orchestration` |
| **tdd-workflows**            | Test-driven development methodology | `/plugin install tdd-workflows`            |

### ✅ Testing (1 plugin)

| Plugin           | Description                                        | Install                        |
| ---------------- | -------------------------------------------------- | ------------------------------ |
| **unit-testing** | Automated unit test generation (Python/JavaScript) | `/plugin install unit-testing` |

### 🔍 Quality (3 plugins)

| Plugin                         | Description                                   | Install                                      |
| ------------------------------ | --------------------------------------------- | -------------------------------------------- |
| **code-review-ai**             | AI-powered architectural review               | `/plugin install code-review-ai`             |
| **comprehensive-review**       | Multi-perspective code analysis               | `/plugin install comprehensive-review`       |
| **performance-testing-review** | Performance analysis and test coverage review | `/plugin install performance-testing-review` |

### 🛠️ Utilities (4 plugins)

| Plugin                    | Description                                | Install                                 |
| ------------------------- | ------------------------------------------ | --------------------------------------- |
| **code-refactoring**      | Code cleanup and technical debt management | `/plugin install code-refactoring`      |
| **dependency-management** | Dependency auditing and version management | `/plugin install dependency-management` |
| **error-debugging**       | Error analysis and trace debugging         | `/plugin install error-debugging`       |
| **team-collaboration**    | Team workflows and standup automation      | `/plugin install team-collaboration`    |

### 🤖 AI & ML (4 plugins)

| Plugin                   | Description                         | Install                                |
| ------------------------ | ----------------------------------- | -------------------------------------- |
| **llm-application-dev**  | LLM apps and prompt engineering     | `/plugin install llm-application-dev`  |
| **agent-orchestration**  | Multi-agent system optimization     | `/plugin install agent-orchestration`  |
| **context-management**   | Context persistence and restoration | `/plugin install context-management`   |
| **machine-learning-ops** | ML training pipelines and MLOps     | `/plugin install machine-learning-ops` |

### 📊 Data (2 plugins)

| Plugin                    | Description                        | Install                                 |
| ------------------------- | ---------------------------------- | --------------------------------------- |
| **data-engineering**      | ETL pipelines and data warehouses  | `/plugin install data-engineering`      |
| **data-validation-suite** | Schema validation and data quality | `/plugin install data-validation-suite` |

### 🗄️ Database (2 plugins)

| Plugin                  | Description                             | Install                               |
| ----------------------- | --------------------------------------- | ------------------------------------- |
| **database-design**     | Database architecture and schema design | `/plugin install database-design`     |
| **database-migrations** | Database migration automation           | `/plugin install database-migrations` |

### 🚨 Operations (4 plugins)

| Plugin                       | Description                           | Install                                    |
| ---------------------------- | ------------------------------------- | ------------------------------------------ |
| **incident-response**        | Production incident management        | `/plugin install incident-response`        |
| **error-diagnostics**        | Error tracing and root cause analysis | `/plugin install error-diagnostics`        |
| **distributed-debugging**    | Distributed system tracing            | `/plugin install distributed-debugging`    |
| **observability-monitoring** | Metrics, logging, tracing, and SLO    | `/plugin install observability-monitoring` |

### ⚡ Performance (2 plugins)

| Plugin                          | Description                                | Install                                       |
| ------------------------------- | ------------------------------------------ | --------------------------------------------- |
| **application-performance**     | Application profiling and optimization     | `/plugin install application-performance`     |
| **database-cloud-optimization** | Database query and cloud cost optimization | `/plugin install database-cloud-optimization` |

### ☁️ Infrastructure (5 plugins)

| Plugin                    | Description                                 | Install                                 |
| ------------------------- | ------------------------------------------- | --------------------------------------- |
| **deployment-strategies** | Deployment patterns and rollback automation | `/plugin install deployment-strategies` |
| **deployment-validation** | Pre-deployment checks and validation        | `/plugin install deployment-validation` |
| **kubernetes-operations** | K8s manifests and GitOps workflows          | `/plugin install kubernetes-operations` |
| **cloud-infrastructure**  | AWS/Azure/GCP cloud architecture            | `/plugin install cloud-infrastructure`  |
| **cicd-automation**       | CI/CD pipeline configuration                | `/plugin install cicd-automation`       |

### 🔒 Security (4 plugins)

| Plugin                       | Description                              | Install                                    |
| ---------------------------- | ---------------------------------------- | ------------------------------------------ |
| **security-scanning**        | SAST analysis and vulnerability scanning | `/plugin install security-scanning`        |
| **security-compliance**      | SOC2/HIPAA/GDPR compliance               | `/plugin install security-compliance`      |
| **backend-api-security**     | API security and authentication          | `/plugin install backend-api-security`     |
| **frontend-mobile-security** | XSS/CSRF prevention and mobile security  | `/plugin install frontend-mobile-security` |

### 🔄 Modernization (2 plugins)

| Plugin                  | Description                               | Install                               |
| ----------------------- | ----------------------------------------- | ------------------------------------- |
| **framework-migration** | Framework upgrades and migration planning | `/plugin install framework-migration` |
| **codebase-cleanup**    | Technical debt reduction and cleanup      | `/plugin install codebase-cleanup`    |

### 🌐 API (2 plugins)

| Plugin                        | Description                 | Install                                     |
| ----------------------------- | --------------------------- | ------------------------------------------- |
| **api-scaffolding**           | REST/GraphQL API generation | `/plugin install api-scaffolding`           |
| **api-testing-observability** | API testing and monitoring  | `/plugin install api-testing-observability` |

### 📢 Marketing (4 plugins)

| Plugin                         | Description                             | Install                                      |
| ------------------------------ | --------------------------------------- | -------------------------------------------- |
| **seo-content-creation**       | SEO content writing and planning        | `/plugin install seo-content-creation`       |
| **seo-technical-optimization** | Meta tags, keywords, and schema markup  | `/plugin install seo-technical-optimization` |
| **seo-analysis-monitoring**    | Content analysis and authority building | `/plugin install seo-analysis-monitoring`    |
| **content-marketing**          | Content strategy and web research       | `/plugin install content-marketing`          |

### 💼 Business (3 plugins)

| Plugin                        | Description                          | Install                                     |
| ----------------------------- | ------------------------------------ | ------------------------------------------- |
| **business-analytics**        | KPI tracking and financial reporting | `/plugin install business-analytics`        |
| **hr-legal-compliance**       | HR policies and legal templates      | `/plugin install hr-legal-compliance`       |
| **customer-sales-automation** | Support and sales automation         | `/plugin install customer-sales-automation` |

### 💻 Languages (6 plugins)

| Plugin                     | Description                              | Install                                  |
| -------------------------- | ---------------------------------------- | ---------------------------------------- |
| **python-development**     | Python 3.12+ with Django/FastAPI         | `/plugin install python-development`     |
| **javascript-typescript**  | JavaScript/TypeScript with Node.js       | `/plugin install javascript-typescript`  |
| **systems-programming**    | Rust, Go, C, C++ for systems development | `/plugin install systems-programming`    |
| **jvm-languages**          | Java, Scala, C# with enterprise patterns | `/plugin install jvm-languages`          |
| **web-scripting**          | PHP and Ruby for web applications        | `/plugin install web-scripting`          |
| **functional-programming** | Elixir with OTP and Phoenix              | `/plugin install functional-programming` |

### 🔗 Blockchain (1 plugin)

| Plugin              | Description                        | Install                           |
| ------------------- | ---------------------------------- | --------------------------------- |
| **blockchain-web3** | Smart contracts and DeFi protocols | `/plugin install blockchain-web3` |

### 💰 Finance (1 plugin)

| Plugin                   | Description                             | Install                                |
| ------------------------ | --------------------------------------- | -------------------------------------- |
| **quantitative-trading** | Algorithmic trading and risk management | `/plugin install quantitative-trading` |

### 💳 Payments (1 plugin)

| Plugin                 | Description                           | Install                              |
| ---------------------- | ------------------------------------- | ------------------------------------ |
| **payment-processing** | Stripe/PayPal integration and billing | `/plugin install payment-processing` |

### 🎮 Gaming (1 plugin)

| Plugin               | Description                            | Install                            |
| -------------------- | -------------------------------------- | ---------------------------------- |
| **game-development** | Unity and Minecraft plugin development | `/plugin install game-development` |

### ♿ Accessibility (1 plugin)

| Plugin                       | Description                        | Install                                    |
| ---------------------------- | ---------------------------------- | ------------------------------------------ |
| **accessibility-compliance** | WCAG auditing and inclusive design | `/plugin install accessibility-compliance` |

## Repository Structure

```
claude-agents/
├── .claude-plugin/
│   └── marketplace.json          # Marketplace catalog (62 plugins)
├── plugins/                       # Isolated plugin directories
│   ├── python-development/
│   │   ├── agents/               # Python language agents
│   │   │   ├── python-pro.md
│   │   │   ├── django-pro.md
│   │   │   └── fastapi-pro.md
│   │   └── commands/             # Python tooling
│   │       └── python-scaffold.md
│   ├── backend-development/
│   │   ├── agents/
│   │   │   ├── backend-architect.md
│   │   │   ├── graphql-architect.md
│   │   │   └── tdd-orchestrator.md
│   │   └── commands/
│   │       └── feature-development.md
│   ├── security-scanning/
│   │   ├── agents/
│   │   │   └── security-auditor.md
│   │   └── commands/
│   │       ├── security-hardening.md
│   │       ├── security-sast.md
│   │       └── security-dependencies.md
│   └── ... (59 more isolated plugins)
└── README.md                      # This file
```

Each plugin contains:

- **agents/** - Specialized agents for that domain
- **commands/** - Tools and workflows specific to that plugin

## Usage

### Agent Invocation

After installing plugins, agents are automatically available. Invoke them explicitly in natural language:

```
"Use backend-architect to design the authentication API"
"Have security-auditor scan for OWASP vulnerabilities"
"Get performance-engineer to optimize this database query"
```

Claude Code automatically selects and coordinates the appropriate agents based on your request.

### Multi-Agent Orchestration Examples

Plugins provide pre-configured multi-agent workflows that coordinate complex operations:

**Full-Stack Development Plugin**

```
"Implement user dashboard with real-time analytics"
```

→ backend-architect → graphql-architect → frontend-developer → mobile-developer → test-automator → security-auditor → performance-engineer → deployment-engineer

**Security Hardening Plugin**

```
"Perform security audit and implement OWASP best practices"
```

→ security-auditor → backend-security-coder → frontend-security-coder → mobile-security-coder → test-automator

**Data/ML Pipeline Plugin**

```
"Build customer churn prediction model with deployment"
```

→ data-scientist → data-engineer → ml-engineer → mlops-engineer → ai-engineer → performance-engineer

**Incident Response Plugin**

```
"Debug production memory leak and create runbook"
```

→ incident-responder → devops-troubleshooter → debugger → error-detective → observability-engineer

## Agent Categories

### Architecture & System Design

#### Core Architecture

| Agent                                                      | Model  | Description                                                        |
| ---------------------------------------------------------- | ------ | ------------------------------------------------------------------ |
| [backend-architect](agents/backend-architect.md)           | opus   | RESTful API design, microservice boundaries, database schemas      |
| [frontend-developer](agents/frontend-developer.md)         | sonnet | React components, responsive layouts, client-side state management |
| [graphql-architect](agents/graphql-architect.md)           | opus   | GraphQL schemas, resolvers, federation architecture                |
| [architect-reviewer](agents/architect-review.md)           | opus   | Architectural consistency analysis and pattern validation          |
| [cloud-architect](agents/cloud-architect.md)               | opus   | AWS/Azure/GCP infrastructure design and cost optimization          |
| [hybrid-cloud-architect](agents/hybrid-cloud-architect.md) | opus   | Multi-cloud strategies across cloud and on-premises environments   |
| [kubernetes-architect](agents/kubernetes-architect.md)     | opus   | Cloud-native infrastructure with Kubernetes and GitOps             |

#### UI/UX & Mobile

| Agent                                                | Model  | Description                                        |
| ---------------------------------------------------- | ------ | -------------------------------------------------- |
| [ui-ux-designer](agents/ui-ux-designer.md)           | sonnet | Interface design, wireframes, design systems       |
| [ui-visual-validator](agents/ui-visual-validator.md) | sonnet | Visual regression testing and UI verification      |
| [mobile-developer](agents/mobile-developer.md)       | sonnet | React Native and Flutter application development   |
| [ios-developer](agents/ios-developer.md)             | sonnet | Native iOS development with Swift/SwiftUI          |
| [flutter-expert](agents/flutter-expert.md)           | sonnet | Advanced Flutter development with state management |

### Programming Languages

#### Systems & Low-Level

| Agent                              | Model  | Description                                                 |
| ---------------------------------- | ------ | ----------------------------------------------------------- |
| [c-pro](agents/c-pro.md)           | sonnet | System programming with memory management and OS interfaces |
| [cpp-pro](agents/cpp-pro.md)       | sonnet | Modern C++ with RAII, smart pointers, STL algorithms        |
| [rust-pro](agents/rust-pro.md)     | sonnet | Memory-safe systems programming with ownership patterns     |
| [golang-pro](agents/golang-pro.md) | sonnet | Concurrent programming with goroutines and channels         |

#### Web & Application

| Agent                                      | Model  | Description                                                |
| ------------------------------------------ | ------ | ---------------------------------------------------------- |
| [javascript-pro](agents/javascript-pro.md) | sonnet | Modern JavaScript with ES6+, async patterns, Node.js       |
| [typescript-pro](agents/typescript-pro.md) | sonnet | Advanced TypeScript with type systems and generics         |
| [python-pro](agents/python-pro.md)         | sonnet | Python development with advanced features and optimization |
| [ruby-pro](agents/ruby-pro.md)             | sonnet | Ruby with metaprogramming, Rails patterns, gem development |
| [php-pro](agents/php-pro.md)               | sonnet | Modern PHP with frameworks and performance optimization    |

#### Enterprise & JVM

| Agent                              | Model  | Description                                                          |
| ---------------------------------- | ------ | -------------------------------------------------------------------- |
| [java-pro](agents/java-pro.md)     | sonnet | Modern Java with streams, concurrency, JVM optimization              |
| [scala-pro](agents/scala-pro.md)   | sonnet | Enterprise Scala with functional programming and distributed systems |
| [csharp-pro](agents/csharp-pro.md) | sonnet | C# development with .NET frameworks and patterns                     |

#### Specialized Platforms

| Agent                                                  | Model  | Description                                     |
| ------------------------------------------------------ | ------ | ----------------------------------------------- |
| [elixir-pro](agents/elixir-pro.md)                     | sonnet | Elixir with OTP patterns and Phoenix frameworks |
| [django-pro](agents/django-pro.md)                     | sonnet | Django development with ORM and async views     |
| [fastapi-pro](agents/fastapi-pro.md)                   | sonnet | FastAPI with async patterns and Pydantic        |
| [unity-developer](agents/unity-developer.md)           | sonnet | Unity game development and optimization         |
| [minecraft-bukkit-pro](agents/minecraft-bukkit-pro.md) | sonnet | Minecraft server plugin development             |
| [sql-pro](agents/sql-pro.md)                           | sonnet | Complex SQL queries and database optimization   |

### Infrastructure & Operations

#### DevOps & Deployment

| Agent                                                    | Model  | Description                                                        |
| -------------------------------------------------------- | ------ | ------------------------------------------------------------------ |
| [devops-troubleshooter](agents/devops-troubleshooter.md) | sonnet | Production debugging, log analysis, deployment troubleshooting     |
| [deployment-engineer](agents/deployment-engineer.md)     | sonnet | CI/CD pipelines, containerization, cloud deployments               |
| [terraform-specialist](agents/terraform-specialist.md)   | sonnet | Infrastructure as Code with Terraform modules and state management |
| [dx-optimizer](agents/dx-optimizer.md)                   | sonnet | Developer experience optimization and tooling improvements         |

#### Database Management

| Agent                                              | Model  | Description                                                         |
| -------------------------------------------------- | ------ | ------------------------------------------------------------------- |
| [database-optimizer](agents/database-optimizer.md) | sonnet | Query optimization, index design, migration strategies              |
| [database-admin](agents/database-admin.md)         | sonnet | Database operations, backup, replication, monitoring                |
| [database-architect](agents/database-architect.md) | opus   | Database design from scratch, technology selection, schema modeling |

#### Incident Response & Network

| Agent                                              | Model  | Description                                         |
| -------------------------------------------------- | ------ | --------------------------------------------------- |
| [incident-responder](agents/incident-responder.md) | opus   | Production incident management and resolution       |
| [network-engineer](agents/network-engineer.md)     | sonnet | Network debugging, load balancing, traffic analysis |

### Quality Assurance & Security

#### Code Quality & Review

| Agent                                                        | Model | Description                                                  |
| ------------------------------------------------------------ | ----- | ------------------------------------------------------------ |
| [code-reviewer](agents/code-reviewer.md)                     | opus  | Code review with security focus and production reliability   |
| [security-auditor](agents/security-auditor.md)               | opus  | Vulnerability assessment and OWASP compliance                |
| [backend-security-coder](agents/backend-security-coder.md)   | opus  | Secure backend coding practices, API security implementation |
| [frontend-security-coder](agents/frontend-security-coder.md) | opus  | XSS prevention, CSP implementation, client-side security     |
| [mobile-security-coder](agents/mobile-security-coder.md)     | opus  | Mobile security patterns, WebView security, biometric auth   |

#### Testing & Debugging

| Agent                                          | Model  | Description                                                |
| ---------------------------------------------- | ------ | ---------------------------------------------------------- |
| [test-automator](agents/test-automator.md)     | sonnet | Comprehensive test suite creation (unit, integration, e2e) |
| [tdd-orchestrator](agents/tdd-orchestrator.md) | sonnet | Test-Driven Development methodology guidance               |
| [debugger](agents/debugger.md)                 | sonnet | Error resolution and test failure analysis                 |
| [error-detective](agents/error-detective.md)   | sonnet | Log analysis and error pattern recognition                 |

#### Performance & Observability

| Agent                                                      | Model | Description                                                    |
| ---------------------------------------------------------- | ----- | -------------------------------------------------------------- |
| [performance-engineer](agents/performance-engineer.md)     | opus  | Application profiling and optimization                         |
| [observability-engineer](agents/observability-engineer.md) | opus  | Production monitoring, distributed tracing, SLI/SLO management |
| [search-specialist](agents/search-specialist.md)           | haiku | Advanced web research and information synthesis                |

### Data & AI

#### Data Engineering & Analytics

| Agent                                      | Model  | Description                                             |
| ------------------------------------------ | ------ | ------------------------------------------------------- |
| [data-scientist](agents/data-scientist.md) | opus   | Data analysis, SQL queries, BigQuery operations         |
| [data-engineer](agents/data-engineer.md)   | sonnet | ETL pipelines, data warehouses, streaming architectures |

#### Machine Learning & AI

| Agent                                        | Model | Description                                              |
| -------------------------------------------- | ----- | -------------------------------------------------------- |
| [ai-engineer](agents/ai-engineer.md)         | opus  | LLM applications, RAG systems, prompt pipelines          |
| [ml-engineer](agents/ml-engineer.md)         | opus  | ML pipelines, model serving, feature engineering         |
| [mlops-engineer](agents/mlops-engineer.md)   | opus  | ML infrastructure, experiment tracking, model registries |
| [prompt-engineer](agents/prompt-engineer.md) | opus  | LLM prompt optimization and engineering                  |

### Documentation & Technical Writing

| Agent                                            | Model  | Description                                       |
| ------------------------------------------------ | ------ | ------------------------------------------------- |
| [docs-architect](agents/docs-architect.md)       | opus   | Comprehensive technical documentation generation  |
| [api-documenter](agents/api-documenter.md)       | sonnet | OpenAPI/Swagger specifications and developer docs |
| [reference-builder](agents/reference-builder.md) | haiku  | Technical references and API documentation        |
| [tutorial-engineer](agents/tutorial-engineer.md) | sonnet | Step-by-step tutorials and educational content    |
| [mermaid-expert](agents/mermaid-expert.md)       | sonnet | Diagram creation (flowcharts, sequences, ERDs)    |

### Business & Operations

#### Business Analysis & Finance

| Agent                                          | Model  | Description                                             |
| ---------------------------------------------- | ------ | ------------------------------------------------------- |
| [business-analyst](agents/business-analyst.md) | sonnet | Metrics analysis, reporting, KPI tracking               |
| [quant-analyst](agents/quant-analyst.md)       | opus   | Financial modeling, trading strategies, market analysis |
| [risk-manager](agents/risk-manager.md)         | sonnet | Portfolio risk monitoring and management                |

#### Marketing & Sales

| Agent                                          | Model  | Description                                  |
| ---------------------------------------------- | ------ | -------------------------------------------- |
| [content-marketer](agents/content-marketer.md) | sonnet | Blog posts, social media, email campaigns    |
| [sales-automator](agents/sales-automator.md)   | haiku  | Cold emails, follow-ups, proposal generation |

#### Support & Legal

| Agent                                          | Model  | Description                                             |
| ---------------------------------------------- | ------ | ------------------------------------------------------- |
| [customer-support](agents/customer-support.md) | sonnet | Support tickets, FAQ responses, customer communication  |
| [hr-pro](agents/hr-pro.md)                     | opus   | HR operations, policies, employee relations             |
| [legal-advisor](agents/legal-advisor.md)       | opus   | Privacy policies, terms of service, legal documentation |

### SEO & Content Optimization

| Agent                                                                  | Model  | Description                                          |
| ---------------------------------------------------------------------- | ------ | ---------------------------------------------------- |
| [seo-content-auditor](agents/seo-content-auditor.md)                   | sonnet | Content quality analysis, E-E-A-T signals assessment |
| [seo-meta-optimizer](agents/seo-meta-optimizer.md)                     | haiku  | Meta title and description optimization              |
| [seo-keyword-strategist](agents/seo-keyword-strategist.md)             | haiku  | Keyword analysis and semantic variations             |
| [seo-structure-architect](agents/seo-structure-architect.md)           | haiku  | Content structure and schema markup                  |
| [seo-snippet-hunter](agents/seo-snippet-hunter.md)                     | haiku  | Featured snippet formatting                          |
| [seo-content-refresher](agents/seo-content-refresher.md)               | haiku  | Content freshness analysis                           |
| [seo-cannibalization-detector](agents/seo-cannibalization-detector.md) | haiku  | Keyword overlap detection                            |
| [seo-authority-builder](agents/seo-authority-builder.md)               | sonnet | E-E-A-T signal analysis                              |
| [seo-content-writer](agents/seo-content-writer.md)                     | sonnet | SEO-optimized content creation                       |
| [seo-content-planner](agents/seo-content-planner.md)                   | haiku  | Content planning and topic clusters                  |

### Specialized Domains

| Agent                                                  | Model  | Description                                    |
| ------------------------------------------------------ | ------ | ---------------------------------------------- |
| [blockchain-developer](agents/blockchain-developer.md) | sonnet | Web3 apps, smart contracts, DeFi protocols     |
| [payment-integration](agents/payment-integration.md)   | sonnet | Payment processor integration (Stripe, PayPal) |
| [legacy-modernizer](agents/legacy-modernizer.md)       | sonnet | Legacy code refactoring and modernization      |
| [context-manager](agents/context-manager.md)           | haiku  | Multi-agent context management                 |

## Model Configuration

Agents are assigned to specific Claude models based on task complexity and computational requirements. The system uses three model tiers:

### Model Distribution Summary

| Model  | Agent Count | Use Case                                                 |
| ------ | ----------- | -------------------------------------------------------- |
| Haiku  | 11          | Quick, focused tasks with minimal computational overhead |
| Sonnet | 50          | Standard development and specialized engineering tasks   |
| Opus   | 23          | Complex reasoning, architecture, and critical analysis   |

### Haiku Model Agents

| Category            | Agents                                                                                                                                                                          |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Context & Reference | `context-manager`, `reference-builder`, `sales-automator`, `search-specialist`                                                                                                  |
| SEO Optimization    | `seo-meta-optimizer`, `seo-keyword-strategist`, `seo-structure-architect`, `seo-snippet-hunter`, `seo-content-refresher`, `seo-cannibalization-detector`, `seo-content-planner` |

### Sonnet Model Agents

| Category              | Count | Agents                                                                                                                                                                                                      |
| --------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Programming Languages | 18    | All language-specific agents (JavaScript, Python, Java, C++, etc.)                                                                                                                                          |
| Frontend & UI         | 5     | `frontend-developer`, `ui-ux-designer`, `ui-visual-validator`, `mobile-developer`, `ios-developer`                                                                                                          |
| Infrastructure        | 10    | `devops-troubleshooter`, `deployment-engineer`, `terraform-specialist`, `dx-optimizer`, `database-admin`, `database-optimizer`, `network-engineer`, `flutter-expert`, `api-documenter`, `tutorial-engineer` |
| Quality & Testing     | 4     | `test-automator`, `tdd-orchestrator`, `debugger`, `error-detective`                                                                                                                                         |
| Business & Support    | 6     | `business-analyst`, `risk-manager`, `content-marketer`, `customer-support`, `mermaid-expert`, `legacy-modernizer`                                                                                           |
| Data & Content        | 5     | `data-engineer`, `payment-integration`, `seo-content-auditor`, `seo-authority-builder`, `seo-content-writer`                                                                                                |

### Opus Model Agents

| Category                    | Count | Agents                                                                                                            |
| --------------------------- | ----- | ----------------------------------------------------------------------------------------------------------------- |
| Architecture & Design       | 5     | `backend-architect`, `cloud-architect`, `hybrid-cloud-architect`, `kubernetes-architect`, `database-architect`    |
| Security & Code Review      | 5     | `code-reviewer`, `security-auditor`, `backend-security-coder`, `frontend-security-coder`, `mobile-security-coder` |
| Performance & Observability | 3     | `performance-engineer`, `observability-engineer`, `incident-responder`                                            |
| AI/ML Complex               | 5     | `ai-engineer`, `ml-engineer`, `mlops-engineer`, `data-scientist`, `prompt-engineer`                               |
| Business Critical           | 5     | `docs-architect`, `hr-pro`, `legal-advisor`, `quant-analyst`, `risk-manager`                                      |

## Architecture & Design Principles

This marketplace follows industry best practices with a focus on granularity, composability, and minimal token usage:

### Single Responsibility Principle

- Each plugin does **one thing well** (Unix philosophy)
- Clear, focused purposes (describable in 5-10 words)
- Average plugin size: **3.4 components** (follows Anthropic's 2-8 pattern)
- **Zero bloated plugins** - all plugins focused and purposeful

### Granular Plugin Architecture

- **62 focused plugins** optimized for specific use cases
- **23 clear categories** with 1-6 plugins each for easy discovery
- Organized by domain:
  - **Development**: 4 plugins (debugging, backend, frontend, multi-platform)
  - **Security**: 4 plugins (scanning, compliance, backend-api, frontend-mobile)
  - **Operations**: 4 plugins (incident, diagnostics, distributed, observability)
  - **Languages**: 6 plugins (Python, JS/TS, systems, JVM, scripting, functional)
  - **Infrastructure**: 5 plugins (deployment, validation, K8s, cloud, CI/CD)
  - And 18 more specialized categories

### Tools & Capabilities

- **44 development tools** including:
  - `test-generate.md` - Automated unit test generation (pytest/Jest)
  - `component-scaffold.md` - React/React Native scaffolding
  - `xss-scan.md` - XSS vulnerability scanner with secure patterns
  - `python-scaffold.md` - Python project scaffolding (FastAPI/Django)
  - `typescript-scaffold.md` - TypeScript project scaffolding (Next.js/Vite)
  - `rust-project.md` - Rust project scaffolding (cargo/Axum)
- **100% agent coverage** - all plugins include at least one agent
- **Language-specific plugins** - 6 dedicated plugins for language experts

### Performance & Quality

- **Optimized token usage** - isolated plugins load only what you need
- **Better context efficiency** - granular plugins reduce unnecessary context
- **Clear discoverability** - well-organized categories and focused purposes
- **Isolated dependencies** - each plugin contains only its required resources
- **100% component coverage** - all 84 agents available across plugins

### Design Philosophy

**Composability Over Bundling**

- Mix and match plugins based on needs
- Workflow orchestrators compose focused plugins
- No forced feature bundling

**Context Efficiency**

- Smaller tools = faster processing
- Better fit in LLM context windows
- More accurate, focused responses

**Maintainability**

- Single-purpose = easier updates
- Clear boundaries = isolated changes
- Less duplication = simpler maintenance

**Discoverability**

- Clear plugin names convey purpose
- Logical categorization
- Easy to find the right tool

## Contributing

To add new agents or commands:

1. Identify or create the appropriate plugin directory in `plugins/`
2. Create a new `.md` file in `plugins/{plugin-name}/agents/` or `plugins/{plugin-name}/commands/`
3. Use lowercase, hyphen-separated naming convention
4. Write clear activation criteria in the description
5. Define comprehensive system prompt with expertise areas
6. Update the plugin definition in `.claude-plugin/marketplace.json`

### Plugin Structure

Each plugin must follow this structure:

```
plugins/{plugin-name}/
├── agents/          # Agent definitions (optional)
│   └── agent-name.md
└── commands/        # Commands/tools (optional)
    └── command-name.md
```

### Subagent Format

Each subagent is defined as a Markdown file with frontmatter:

```markdown
---
name: subagent-name
description: Activation criteria for this subagent
model: haiku|sonnet|opus # Optional: Model selection
tools: tool1, tool2 # Optional: Tool restrictions
---

System prompt defining the subagent's expertise and behavior
```

### Model Selection Criteria

- **haiku**: Simple, deterministic tasks with minimal reasoning
- **sonnet**: Standard development and engineering tasks
- **opus**: Complex analysis, architecture, and critical operations

## License

MIT License - see [LICENSE](LICENSE) file for details.

## Resources

- [Claude Code Documentation](https://docs.claude.com/en/docs/claude-code/overview)
- [Claude Code Plugins Guide](https://docs.claude.com/en/docs/claude-code/plugins)
- [Subagents Documentation](https://docs.claude.com/en/docs/claude-code/sub-agents)
- [Claude Code GitHub](https://github.com/anthropics/claude-code)