Skip to content

agents.md

Latest commit

 

History

History
325 lines (251 loc) · 17.2 KB

agents.md

File metadata and controls

325 lines (251 loc) · 17.2 KB

Agent Reference

Complete reference for all 85 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
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:

  1. Create plugins/{plugin-name}/agents/{agent-name}.md
  2. Add frontmatter with name, description, and model assignment
  3. Write comprehensive system prompt
  4. Update plugin definition in .claude-plugin/marketplace.json

See Contributing Guide for details.