From 743772eae9c87daa8f423ea9066832d72692b93e Mon Sep 17 00:00:00 2001 From: Seth Hobson Date: Mon, 13 Oct 2025 10:34:23 -0400 Subject: [PATCH] readme tidy --- README.md | 537 +++++++++++++++++++++++++++++------------------------- 1 file changed, 289 insertions(+), 248 deletions(-) diff --git a/README.md b/README.md index 00fd98f..a072879 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Claude Code Workflows & Agents +# 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). @@ -66,83 +66,107 @@ Each installed plugin loads **only its specific agents and commands** into Claud ### 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. --- @@ -153,179 +177,179 @@ Next.js, React + Vite, and Node.js project setup with pnpm and TypeScript best p ### 🎨 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` | +| 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` | +| 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` | +| 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 | -|--------|-------------|---------| +| 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` | +| 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` | +| 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` | +| **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` | +| 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` | +| 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` | +| 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` | +| 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` | +| 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 | -|--------|-------------|---------| +| 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` | +| **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` | +| 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 | -|--------|-------------|---------| +| 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` | +| **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` | +| 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` | +| 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` | +| 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` | +| 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 | -|--------|-------------|---------| +| Plugin | Description | Install | +| ------------------- | ---------------------------------- | --------------------------------- | | **blockchain-web3** | Smart contracts and DeFi protocols | `/plugin install blockchain-web3` | ### 💰 Finance (1 plugin) -| Plugin | Description | Install | -|--------|-------------|---------| +| Plugin | Description | Install | +| ------------------------ | --------------------------------------- | -------------------------------------- | | **quantitative-trading** | Algorithmic trading and risk management | `/plugin install quantitative-trading` | ### 💳 Payments (1 plugin) -| Plugin | Description | Install | -|--------|-------------|---------| +| Plugin | Description | Install | +| ---------------------- | ------------------------------------- | ------------------------------------ | | **payment-processing** | Stripe/PayPal integration and billing | `/plugin install payment-processing` | ### 🎮 Gaming (1 plugin) -| Plugin | Description | Install | -|--------|-------------|---------| +| Plugin | Description | Install | +| -------------------- | -------------------------------------- | ---------------------------------- | | **game-development** | Unity and Minecraft plugin development | `/plugin install game-development` | ### ♿ Accessibility (1 plugin) -| Plugin | Description | Install | -|--------|-------------|---------| +| Plugin | Description | Install | +| ---------------------------- | ---------------------------------- | ------------------------------------------ | | **accessibility-compliance** | WCAG auditing and inclusive design | `/plugin install accessibility-compliance` | ## Repository Structure @@ -361,6 +385,7 @@ claude-agents/ ``` Each plugin contains: + - **agents/** - Specialized agents for that domain - **commands/** - Tools and workflows specific to that plugin @@ -383,27 +408,35 @@ Claude Code automatically selects and coordinates the appropriate agents based o 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 @@ -412,197 +445,197 @@ Plugins provide pre-configured multi-agent workflows that coordinate complex ope #### 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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) | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 | +| 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 @@ -610,51 +643,53 @@ Agents are assigned to specific Claude models based on task complexity and compu ### 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 | +| 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` | +| 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` | +| 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` | +| 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: @@ -666,6 +701,7 @@ This marketplace follows industry best practices with a focus on granularity, co - 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 @@ -677,6 +713,7 @@ This marketplace follows industry best practices with a focus on granularity, co - **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 @@ -686,26 +723,29 @@ This marketplace follows industry best practices with a focus on granularity, co ### 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: @@ -720,6 +760,7 @@ To add new agents or commands: ### Plugin Structure Each plugin must follow this structure: + ``` plugins/{plugin-name}/ ├── agents/ # Agent definitions (optional) @@ -736,8 +777,8 @@ Each subagent is defined as a Markdown file with frontmatter: --- name: subagent-name description: Activation criteria for this subagent -model: haiku|sonnet|opus # Optional: Model selection -tools: tool1, tool2 # Optional: Tool restrictions +model: haiku|sonnet|opus # Optional: Model selection +tools: tool1, tool2 # Optional: Tool restrictions --- System prompt defining the subagent's expertise and behavior