mirror of
https://github.com/wshobson/agents.git
synced 2026-03-18 09:37:15 +00:00
ddbd034ca3
* docs: enhance payment-integration agent with critical security guidance Add evidence-based security requirements from Stripe, PayPal, OWASP: - Webhook security (signature verification, idempotency, quick response, server validation) - PCI compliance essentials (tokenization, server-side validation, environment separation) - Real-world failure examples (processor collapse, Lambda failures, malicious price manipulation) Minimal expansion: 32 to 57 lines (25 lines added) * feat: add Temporal workflow orchestration to backend-development plugin Add comprehensive Temporal workflow orchestration support with 1 agent and 2 skills: **Agent:** - temporal-python-pro: Python SDK expert for durable workflows, saga patterns, async/await patterns, error handling, and production deployment **Skills:** - workflow-orchestration-patterns: Language-agnostic patterns for workflows vs activities, saga compensation, entity workflows, and determinism constraints - temporal-python-testing: Progressive disclosure testing guide with unit testing, integration testing, replay testing, and local development setup **Changes:** - Add agent: plugins/backend-development/agents/temporal-python-pro.md (311 lines) - Add skill: plugins/backend-development/skills/workflow-orchestration-patterns/ (286 lines) - Add skill: plugins/backend-development/skills/temporal-python-testing/ (SKILL.md + 4 resource files) - Update marketplace.json: backend-development plugin v1.2.2 → v1.2.3 - Update docs/agents.md: 85 → 86 agents - Update docs/agent-skills.md: 55 → 57 skills **Content Sources:** - Official Temporal documentation (docs.temporal.io) - Temporal Python SDK guide (python.temporal.io) - Temporal architecture docs (github.com/temporalio/temporal) - OWASP best practices for distributed systems Addresses #124 --------- Co-authored-by: Kiran Eshwarappa <kiran.eshwarapa@gmail.com>
17 KiB
17 KiB
Agent Reference
Complete reference for all 86 specialized AI agents organized by category with model assignments.
Agent Categories
Architecture & System Design
Core Architecture
| Agent | Model | Description |
|---|---|---|
| backend-architect | opus | RESTful API design, microservice boundaries, database schemas |
| frontend-developer | sonnet | React components, responsive layouts, client-side state management |
| graphql-architect | opus | GraphQL schemas, resolvers, federation architecture |
| architect-reviewer | opus | Architectural consistency analysis and pattern validation |
| cloud-architect | opus | AWS/Azure/GCP infrastructure design and cost optimization |
| hybrid-cloud-architect | opus | Multi-cloud strategies across cloud and on-premises environments |
| kubernetes-architect | opus | Cloud-native infrastructure with Kubernetes and GitOps |
UI/UX & Mobile
| Agent | Model | Description |
|---|---|---|
| ui-ux-designer | sonnet | Interface design, wireframes, design systems |
| ui-visual-validator | sonnet | Visual regression testing and UI verification |
| mobile-developer | sonnet | React Native and Flutter application development |
| ios-developer | sonnet | Native iOS development with Swift/SwiftUI |
| flutter-expert | sonnet | Advanced Flutter development with state management |
Programming Languages
Systems & Low-Level
| Agent | Model | Description |
|---|---|---|
| c-pro | sonnet | System programming with memory management and OS interfaces |
| cpp-pro | sonnet | Modern C++ with RAII, smart pointers, STL algorithms |
| rust-pro | sonnet | Memory-safe systems programming with ownership patterns |
| golang-pro | sonnet | Concurrent programming with goroutines and channels |
Web & Application
| Agent | Model | Description |
|---|---|---|
| javascript-pro | sonnet | Modern JavaScript with ES6+, async patterns, Node.js |
| typescript-pro | sonnet | Advanced TypeScript with type systems and generics |
| python-pro | sonnet | Python development with advanced features and optimization |
| temporal-python-pro | sonnet | Temporal workflow orchestration with Python SDK, durable workflows, saga patterns |
| ruby-pro | sonnet | Ruby with metaprogramming, Rails patterns, gem development |
| php-pro | sonnet | Modern PHP with frameworks and performance optimization |
Enterprise & JVM
| Agent | Model | Description |
|---|---|---|
| java-pro | sonnet | Modern Java with streams, concurrency, JVM optimization |
| scala-pro | sonnet | Enterprise Scala with functional programming and distributed systems |
| csharp-pro | sonnet | C# development with .NET frameworks and patterns |
Specialized Platforms
| Agent | Model | Description |
|---|---|---|
| elixir-pro | sonnet | Elixir with OTP patterns and Phoenix frameworks |
| django-pro | sonnet | Django development with ORM and async views |
| fastapi-pro | sonnet | FastAPI with async patterns and Pydantic |
| unity-developer | sonnet | Unity game development and optimization |
| minecraft-bukkit-pro | sonnet | Minecraft server plugin development |
| sql-pro | sonnet | Complex SQL queries and database optimization |
Infrastructure & Operations
DevOps & Deployment
| Agent | Model | Description |
|---|---|---|
| devops-troubleshooter | sonnet | Production debugging, log analysis, deployment troubleshooting |
| deployment-engineer | sonnet | CI/CD pipelines, containerization, cloud deployments |
| terraform-specialist | sonnet | Infrastructure as Code with Terraform modules and state management |
| dx-optimizer | sonnet | Developer experience optimization and tooling improvements |
Database Management
| Agent | Model | Description |
|---|---|---|
| database-optimizer | sonnet | Query optimization, index design, migration strategies |
| database-admin | sonnet | Database operations, backup, replication, monitoring |
| database-architect | opus | Database design from scratch, technology selection, schema modeling |
Incident Response & Network
| Agent | Model | Description |
|---|---|---|
| incident-responder | opus | Production incident management and resolution |
| network-engineer | sonnet | Network debugging, load balancing, traffic analysis |
Quality Assurance & Security
Code Quality & Review
| Agent | Model | Description |
|---|---|---|
| code-reviewer | opus | Code review with security focus and production reliability |
| security-auditor | opus | Vulnerability assessment and OWASP compliance |
| backend-security-coder | opus | Secure backend coding practices, API security implementation |
| frontend-security-coder | opus | XSS prevention, CSP implementation, client-side security |
| mobile-security-coder | opus | Mobile security patterns, WebView security, biometric auth |
Testing & Debugging
| Agent | Model | Description |
|---|---|---|
| test-automator | sonnet | Comprehensive test suite creation (unit, integration, e2e) |
| tdd-orchestrator | sonnet | Test-Driven Development methodology guidance |
| debugger | sonnet | Error resolution and test failure analysis |
| error-detective | sonnet | Log analysis and error pattern recognition |
Performance & Observability
| Agent | Model | Description |
|---|---|---|
| performance-engineer | opus | Application profiling and optimization |
| observability-engineer | opus | Production monitoring, distributed tracing, SLI/SLO management |
| search-specialist | haiku | Advanced web research and information synthesis |
Data & AI
Data Engineering & Analytics
| Agent | Model | Description |
|---|---|---|
| data-scientist | opus | Data analysis, SQL queries, BigQuery operations |
| data-engineer | sonnet | ETL pipelines, data warehouses, streaming architectures |
Machine Learning & AI
| Agent | Model | Description |
|---|---|---|
| ai-engineer | opus | LLM applications, RAG systems, prompt pipelines |
| ml-engineer | opus | ML pipelines, model serving, feature engineering |
| mlops-engineer | opus | ML infrastructure, experiment tracking, model registries |
| prompt-engineer | opus | LLM prompt optimization and engineering |
Documentation & Technical Writing
| Agent | Model | Description |
|---|---|---|
| docs-architect | opus | Comprehensive technical documentation generation |
| api-documenter | sonnet | OpenAPI/Swagger specifications and developer docs |
| reference-builder | haiku | Technical references and API documentation |
| tutorial-engineer | sonnet | Step-by-step tutorials and educational content |
| mermaid-expert | sonnet | Diagram creation (flowcharts, sequences, ERDs) |
Business & Operations
Business Analysis & Finance
| Agent | Model | Description |
|---|---|---|
| business-analyst | sonnet | Metrics analysis, reporting, KPI tracking |
| quant-analyst | opus | Financial modeling, trading strategies, market analysis |
| risk-manager | sonnet | Portfolio risk monitoring and management |
Marketing & Sales
| Agent | Model | Description |
|---|---|---|
| content-marketer | sonnet | Blog posts, social media, email campaigns |
| sales-automator | haiku | Cold emails, follow-ups, proposal generation |
Support & Legal
| Agent | Model | Description |
|---|---|---|
| customer-support | sonnet | Support tickets, FAQ responses, customer communication |
| hr-pro | opus | HR operations, policies, employee relations |
| legal-advisor | opus | Privacy policies, terms of service, legal documentation |
SEO & Content Optimization
| Agent | Model | Description |
|---|---|---|
| seo-content-auditor | sonnet | Content quality analysis, E-E-A-T signals assessment |
| seo-meta-optimizer | haiku | Meta title and description optimization |
| seo-keyword-strategist | haiku | Keyword analysis and semantic variations |
| seo-structure-architect | haiku | Content structure and schema markup |
| seo-snippet-hunter | haiku | Featured snippet formatting |
| seo-content-refresher | haiku | Content freshness analysis |
| seo-cannibalization-detector | haiku | Keyword overlap detection |
| seo-authority-builder | sonnet | E-E-A-T signal analysis |
| seo-content-writer | sonnet | SEO-optimized content creation |
| seo-content-planner | haiku | Content planning and topic clusters |
Specialized Domains
| Agent | Model | Description |
|---|---|---|
| arm-cortex-expert | sonnet | ARM Cortex-M firmware and peripheral driver development |
| blockchain-developer | sonnet | Web3 apps, smart contracts, DeFi protocols |
| payment-integration | sonnet | Payment processor integration (Stripe, PayPal) |
| legacy-modernizer | sonnet | Legacy code refactoring and modernization |
| context-manager | haiku | Multi-agent context management |
Model Configuration
Agents are assigned to specific Claude models based on task complexity and computational requirements.
Model Distribution Summary
| Model | Agent Count | Use Case |
|---|---|---|
| Haiku | 47 | Fast execution tasks: testing, documentation, ops, database optimization, business |
| Sonnet | 97 | Complex reasoning, architecture, language expertise, orchestration, security |
Model Selection Criteria
Haiku - Fast Execution & Deterministic Tasks
Use when:
- Generating code from well-defined specifications
- Creating tests following established patterns
- Writing documentation with clear templates
- Executing infrastructure operations
- Performing database query optimization
- Handling customer support responses
- Processing SEO optimization tasks
- Managing deployment pipelines
Sonnet - Complex Reasoning & Architecture
Use when:
- Designing system architecture
- Making technology selection decisions
- Performing security audits
- Reviewing code for architectural patterns
- Creating complex AI/ML pipelines
- Providing language-specific expertise
- Orchestrating multi-agent workflows
- Handling business-critical legal/HR matters
Hybrid Orchestration Patterns
The plugin ecosystem leverages Sonnet + Haiku orchestration for optimal performance and cost efficiency:
Pattern 1: Planning → Execution
Sonnet: backend-architect (design API architecture)
↓
Haiku: Generate API endpoints following spec
↓
Haiku: test-automator (generate comprehensive tests)
↓
Sonnet: code-reviewer (architectural review)
Pattern 2: Reasoning → Action (Incident Response)
Sonnet: incident-responder (diagnose issue, create strategy)
↓
Haiku: devops-troubleshooter (execute fixes)
↓
Haiku: deployment-engineer (deploy hotfix)
↓
Haiku: Implement monitoring alerts
Pattern 3: Complex → Simple (Database Design)
Sonnet: database-architect (schema design, technology selection)
↓
Haiku: sql-pro (generate migration scripts)
↓
Haiku: database-admin (execute migrations)
↓
Haiku: database-optimizer (tune query performance)
Pattern 4: Multi-Agent Workflows
Full-Stack Feature Development:
Sonnet: backend-architect + frontend-developer (design components)
↓
Haiku: Generate code following designs
↓
Haiku: test-automator (unit + integration tests)
↓
Sonnet: security-auditor (security review)
↓
Haiku: deployment-engineer (CI/CD setup)
↓
Haiku: Setup observability stack
Agent Invocation
Natural Language
Agents can 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"
Slash Commands
Many agents are accessible through plugin slash commands for direct invocation:
/backend-development:feature-development user authentication
/security-scanning:security-sast
/incident-response:smart-fix "memory leak in payment service"
Contributing
To add a new agent:
- Create
plugins/{plugin-name}/agents/{agent-name}.md - Add frontmatter with name, description, and model assignment
- Write comprehensive system prompt
- Update plugin definition in
.claude-plugin/marketplace.json
See Contributing Guide for details.