dpnmw/agents
1
0
Fork 0
mirror of https://github.com/wshobson/agents.git synced 2026-03-18 09:37:15 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
1ebddda482d26fefd31b0f8f455434124fe6e8fa
agents/README.md
Seth Hobson 1ebddda482 Update README usage section to highlight plugin slash commands 
- Add comprehensive slash command documentation as primary interface
- Include real command examples mapped to actual plugins in marketplace
- Add 70+ categorized slash command reference (all real commands)
- Show both command-based and natural language invocation patterns
- Add tdd-workflows to Testing section for better discoverability
- Provide detailed workflow orchestration examples with step breakdowns
- Include command argument examples and discovery instructions

All examples now use actual commands that exist in the plugin system
(backend-development:feature-development, unit-testing:test-generate, etc.)
2025-10-13 10:47:33 -04:00

1012 lines
54 KiB
Markdown
Raw Blame History

# Claude Code Plugins: Orchestration and Productivity
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 (2 plugins)
| Plugin | Description | Install |
| ----------------- | -------------------------------------------------- | ------------------------------- |
| **unit-testing** | Automated unit test generation (Python/JavaScript) | `/plugin install unit-testing` |
| **tdd-workflows** | Test-driven development methodology | `/plugin install tdd-workflows` |
### 🔍 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
### Using Plugin Slash Commands
After installing plugins, you can invoke their capabilities using **slash commands** - the primary interface for working with agents and workflows. Each plugin provides namespaced commands that you can run directly:
```bash
# List all available slash commands from installed plugins
/plugin
# Run a workflow command with arguments
/backend-development:feature-development user authentication with JWT
# Execute specialized tools
/unit-testing:test-generate src/auth/login.py
# Invoke security scans
/security-scanning:security-sast
```
**Key benefits of slash commands:**
- **Direct invocation** - No need to describe what you want in natural language
- **Structured arguments** - Pass parameters explicitly for precise control
- **Composability** - Chain commands together for complex workflows
- **Discoverability** - Use `/plugin` to see all available commands
### Agent Invocation
Agents can also be invoked through natural language when you need Claude to reason about which specialist to use:
```
"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 Workflow Examples
Plugins provide pre-configured multi-agent workflows accessible via slash commands:
#### Full-Stack Development
```bash
# Command-based workflow invocation
/full-stack-orchestration:full-stack-feature "user dashboard with real-time analytics"
# Natural language alternative
"Implement user dashboard with real-time analytics"
```
**Orchestration:** backend-architect → database-architect → frontend-developer → test-automator → security-auditor → deployment-engineer → observability-engineer
**What happens:**
1. Database schema design with migrations
2. Backend API implementation (REST/GraphQL)
3. Frontend components with state management
4. Comprehensive test suite (unit/integration/E2E)
5. Security audit and hardening
6. CI/CD pipeline setup with feature flags
7. Observability and monitoring configuration
#### Security Hardening
```bash
# Comprehensive security assessment and remediation
/security-scanning:security-hardening --level comprehensive
# Natural language alternative
"Perform security audit and implement OWASP best practices"
```
**Orchestration:** security-auditor → backend-security-coder → frontend-security-coder → mobile-security-coder → test-automator
#### Data/ML Pipeline
```bash
# ML feature development with production deployment
/machine-learning-ops:ml-pipeline "customer churn prediction model"
# Natural language alternative
"Build customer churn prediction model with deployment"
```
**Orchestration:** data-scientist → data-engineer → ml-engineer → mlops-engineer → performance-engineer
#### Incident Response
```bash
# Smart debugging with root cause analysis
/incident-response:smart-fix "production memory leak in payment service"
# Natural language alternative
"Debug production memory leak and create runbook"
```
**Orchestration:** incident-responder → devops-troubleshooter → debugger → error-detective → observability-engineer
### Command Arguments and Options
Many slash commands support arguments for precise control:
```bash
# Test generation for specific files
/unit-testing:test-generate src/api/users.py
# Feature development with methodology specification
/backend-development:feature-development OAuth2 integration with social login
# Security dependency scanning
/security-scanning:security-dependencies
# Component scaffolding
/frontend-mobile-development:component-scaffold UserProfile component with hooks
# TDD workflow cycle
/tdd-workflows:tdd-red User can reset password
/tdd-workflows:tdd-green
/tdd-workflows:tdd-refactor
# Smart debugging
/debugging-toolkit:smart-debug memory leak in checkout flow
# Python project scaffolding
/python-development:python-scaffold fastapi-microservice
```
### Combining Natural Language and Commands
You can mix both approaches for optimal flexibility:
```
# Start with a command for structured workflow
/full-stack-orchestration:full-stack-feature "payment processing"
# Then provide natural language guidance
"Ensure PCI-DSS compliance and integrate with Stripe"
"Add retry logic for failed transactions"
"Set up fraud detection rules"
```
### Discovering Commands
Use these commands to explore available functionality:
```bash
# List all installed plugins and their commands
/plugin
# Install a specific plugin
/plugin install python-development
# View available commands in a plugin
# After installation, commands will be listed with the format:
# /plugin-name:command-name
```
### Real Command Examples by Category
**Development & Features:**
- `/backend-development:feature-development` - End-to-end backend feature development
- `/full-stack-orchestration:full-stack-feature` - Complete full-stack feature implementation
- `/multi-platform-apps:multi-platform` - Cross-platform app development coordination
**Testing & Quality:**
- `/unit-testing:test-generate` - Generate comprehensive unit tests
- `/tdd-workflows:tdd-cycle` - Complete TDD red-green-refactor cycle
- `/tdd-workflows:tdd-red` - Write failing tests first
- `/tdd-workflows:tdd-green` - Implement code to pass tests
- `/tdd-workflows:tdd-refactor` - Refactor with passing tests
**Code Quality & Review:**
- `/code-review-ai:ai-review` - AI-powered code review
- `/comprehensive-review:full-review` - Multi-perspective analysis
- `/comprehensive-review:pr-enhance` - Enhance pull requests
**Debugging & Troubleshooting:**
- `/debugging-toolkit:smart-debug` - Interactive smart debugging
- `/incident-response:incident-response` - Production incident management
- `/incident-response:smart-fix` - Automated incident resolution
- `/error-debugging:error-analysis` - Deep error analysis
- `/error-debugging:error-trace` - Stack trace debugging
- `/error-diagnostics:smart-debug` - Smart diagnostic debugging
- `/distributed-debugging:debug-trace` - Distributed system tracing
**Security:**
- `/security-scanning:security-hardening` - Comprehensive security hardening
- `/security-scanning:security-sast` - Static application security testing
- `/security-scanning:security-dependencies` - Dependency vulnerability scanning
- `/security-compliance:compliance-check` - SOC2/HIPAA/GDPR compliance
- `/frontend-mobile-security:xss-scan` - XSS vulnerability scanning
**Infrastructure & Deployment:**
- `/observability-monitoring:monitor-setup` - Setup monitoring infrastructure
- `/observability-monitoring:slo-implement` - Implement SLO/SLI metrics
- `/deployment-validation:config-validate` - Pre-deployment validation
- `/cicd-automation:workflow-automate` - CI/CD pipeline automation
**Data & ML:**
- `/machine-learning-ops:ml-pipeline` - ML training pipeline orchestration
- `/data-engineering:data-pipeline` - ETL/ELT pipeline construction
- `/data-engineering:data-driven-feature` - Data-driven feature development
**Documentation:**
- `/code-documentation:doc-generate` - Generate comprehensive documentation
- `/code-documentation:code-explain` - Explain code functionality
- `/documentation-generation:doc-generate` - OpenAPI specs, diagrams, tutorials
**Refactoring & Maintenance:**
- `/code-refactoring:refactor-clean` - Code cleanup and refactoring
- `/code-refactoring:tech-debt` - Technical debt management
- `/codebase-cleanup:deps-audit` - Dependency auditing
- `/codebase-cleanup:tech-debt` - Technical debt reduction
- `/framework-migration:legacy-modernize` - Legacy code modernization
- `/framework-migration:code-migrate` - Framework migration
- `/framework-migration:deps-upgrade` - Dependency upgrades
**Database:**
- `/database-migrations:sql-migrations` - SQL migration automation
- `/database-migrations:migration-observability` - Migration monitoring
- `/database-cloud-optimization:cost-optimize` - Database and cloud optimization
**Git & PR Workflows:**
- `/git-pr-workflows:pr-enhance` - Enhance pull request quality
- `/git-pr-workflows:onboard` - Team onboarding automation
- `/git-pr-workflows:git-workflow` - Git workflow automation
**Project Scaffolding:**
- `/python-development:python-scaffold` - FastAPI/Django project setup
- `/javascript-typescript:typescript-scaffold` - Next.js/React + Vite setup
- `/systems-programming:rust-project` - Rust project scaffolding
**AI & LLM Development:**
- `/llm-application-dev:langchain-agent` - LangChain agent development
- `/llm-application-dev:ai-assistant` - AI assistant implementation
- `/llm-application-dev:prompt-optimize` - Prompt engineering optimization
- `/agent-orchestration:multi-agent-optimize` - Multi-agent optimization
- `/agent-orchestration:improve-agent` - Agent improvement workflows
**Testing & Performance:**
- `/performance-testing-review:ai-review` - Performance analysis
- `/application-performance:performance-optimization` - App optimization
**Team Collaboration:**
- `/team-collaboration:issue` - Issue management automation
- `/team-collaboration:standup-notes` - Standup notes generation
**Accessibility:**
- `/accessibility-compliance:accessibility-audit` - WCAG compliance auditing
**API Development:**
- `/api-testing-observability:api-mock` - API mocking and testing
**Context Management:**
- `/context-management:context-save` - Save conversation context
- `/context-management:context-restore` - Restore previous context
## 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)
Reference in New Issue View Git Blame Copy Permalink