/docs/agents.md

Agent Reference

Complete reference for all 203 local 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
service-mesh-expert	opus	Istio/Linkerd service mesh architecture, mTLS, and traffic management
event-sourcing-architect	opus	Event sourcing, CQRS patterns, event stores, and saga orchestration
monorepo-architect	opus	Monorepo tooling with Nx, Turborepo, Bazel, and workspace optimization

UI/UX & Mobile

Agent	Model	Description
ui-designer	opus	UI/UX design for mobile and web with modern patterns
accessibility-expert	opus	WCAG compliance, accessibility audits, inclusive design
design-system-architect	opus	Design tokens, component libraries, theming systems
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
haskell-pro	sonnet	Strongly typed functional programming with purity, advanced type systems, and concurrency
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

Project Management

Agent	Model	Description
conductor-validator	opus	Validates Conductor project artifacts for completeness, consistency, and correctness

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
threat-modeling-expert	opus	STRIDE threat modeling, attack trees, and security requirements

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
vector-database-engineer	opus	Vector databases, embeddings, similarity search, and hybrid retrieval
llm-finetuning-architect	opus	Fine-tuning strategy, method/model selection, eval-gate ownership
llm-finetuning-training-engineer	sonnet	Dataset prep, Unsloth training runs, artifact export
llm-finetuning-eval-engineer	sonnet	Golden sets, judge calibration, checkpoint promotion verdicts
dgx-spark-ops-engineer	sonnet	DGX Spark (GB10/aarch64/CUDA 13) environment setup and diagnostics

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)
c4-code	haiku	C4 Code-level documentation with function signatures and dependencies
c4-component	sonnet	C4 Component-level architecture synthesis and documentation
c4-container	sonnet	C4 Container-level architecture with API documentation
c4-context	sonnet	C4 Context-level system documentation with personas and user journeys

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
social-publishing-publisher	haiku	Multi-platform social media publishing via SocialClaw
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
Fable	0	Longest-horizon autonomous work (tier above Opus; see criteria)
Opus	55	Critical architecture, security, code review, production coding
Sonnet	71	Complex tasks, support with intelligence
Haiku	25	Fast operational tasks
Inherit	52	Complex tasks where the user chooses the model at runtime

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

Fable - Longest-Horizon Autonomous Work

Claude Fable 5 (model: fable) is the tier above Opus. It is opt-in in Claude Code (v2.1.170+, never the default) and carries roughly 2.6× the effective cost of Opus ($10/$50 per MTok plus a ~30% heavier tokenizer), so reserve it for agents where Opus demonstrably needs multiple attempts.

Use when:

• Running multi-hour autonomous sessions (large codebase migrations, overnight refactors)
• Executing end-to-end work from a single well-specified goal
• Coordinating long-lived parallel sub-agent workstreams

Avoid for:

• Security-analysis agents — Fable 5's cyber/bio safety classifiers fall back to Opus 4.8 on that content anyway
• Anything Sonnet or Opus already completes in one pass

Other harnesses map fable to their top available model (see authoring.md). Fable-tier agent bodies should state goals and constraints rather than step-by-step scaffolding, and must not ask the model to echo its internal reasoning.

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.