Skip to content

hanzoai/agents

Agents and Agentic Workflows

A comprehensive production-ready system combining 83 specialized AI agents, 15 multi-agent workflow orchestrators, 42 development tools, and 16 role-based agents for Claude Code.

🚀 Quick Start

Get started in 5 minutes → See QUICKSTART.md

Overview

This unified repository provides everything needed for intelligent automation and multi-agent orchestration across modern software development:

  • 16 Role-Based Agents - Consolidated agents mapping to real job titles (Staff Engineer, Tech Lead, DevOps, Security, Frontend, Backend, Data, ML, QA, Platform, Mobile, Product Manager, Technical Writer, etc.)
  • 88 Specialized Agents - Domain experts with deep knowledge across architecture, languages, infrastructure, quality, data/AI, documentation, business operations, and SEO
  • 15 Workflow Orchestrators - Multi-agent coordination systems for complex operations like full-stack development, security hardening, ML pipelines, and incident response
  • 42 Development Tools - Focused utilities for specific tasks including API scaffolding, security scanning, test automation, and infrastructure setup

🎯 All agents are Hanzo-native:

  • Built-in hanzo-mcp tool integration (26 tools for file, search, shell, agent coordination)
  • Prioritize @hanzo/ui components, Hanzo LLM Gateway, and Hanzo Cloud Platform
  • Support parallel agent execution with batch() and dispatch_agent()
  • Include multi-agent coordination patterns and workflows

Installation

To install plugins, run the /plugin command in Claude Code and follow the interactive prompts:

  1. Browse & install plugins from available marketplaces
  2. Add custom marketplace sources
  3. Manage installed plugins

Note: When adding a marketplace, enter hanzoai/agents to access all plugins from this repository.

Available Plugins

Getting Started

hanzo-essentials - Essential tools for daily development

/plugin install hanzo-essentials

Includes: Code explanation, debugging, documentation, PR enhancement, git workflows

Complete Workflow Systems

full-stack-development - End-to-end feature implementation

/plugin install hanzo-full-stack

Multi-agent coordination: Backend API → Frontend UI → Mobile → Testing → Security → Deployment

security-hardening - Security auditing and compliance

/plugin install hanzo-security

OWASP scanning, penetration testing, code review, SOC2/HIPAA/GDPR compliance

data-ml-pipeline - ML/AI development and MLOps

/plugin install hanzo-data-ml

Data engineering → Model training → MLOps → LangChain/RAG → Deployment

incident-response - Production debugging and SRE

/plugin install hanzo-incident-response

Diagnostics → Root cause analysis → Rollback → Post-mortem documentation

performance-optimization - System profiling and optimization

/plugin install hanzo-performance

Profiling → Query optimization → Caching → Scalability assessment

code-quality-review - Multi-perspective code analysis

/plugin install hanzo-quality-review

Architecture → Security → Performance → Test coverage analysis

legacy-modernization - Codebase modernization workflows

/plugin install hanzo-legacy-modernize

Framework migration → Dependency updates → Refactoring → Compatibility testing

multi-platform-apps - Cross-platform development

/plugin install hanzo-multi-platform

Web (React/Next.js) → iOS (Swift) → Android (Kotlin) → Desktop coordination

cicd-automation - CI/CD pipeline configuration

/plugin install hanzo-cicd

GitHub Actions/GitLab CI → Progressive deployment → Canary releases → Monitoring

agent-optimization - AI agent performance tuning

/plugin install hanzo-agent-optimize

Prompt engineering → Multi-agent coordination → Context management

documentation-generation - Technical documentation automation

/plugin install hanzo-docs

OpenAPI specs → Mermaid diagrams → Tutorials → API references

Focused Development Kits

api-development-kit - REST/GraphQL API development

/plugin install hanzo-api-kit

API scaffolding → OpenAPI docs → Security scanning → Mocking → Validation

testing-quality-suite - Comprehensive testing workflows

/plugin install hanzo-testing

TDD workflows → Test generation → Unit/integration/e2e → Quality gates

infrastructure-devops - Container orchestration deployment

/plugin install hanzo-infrastructure

Kubernetes manifests → Docker optimization → Terraform IaC → Cost analysis

development-utilities - Daily productivity tools

/plugin install hanzo-dev-utils

Refactoring → Dependency auditing → Error analysis → Standup automation

Infrastructure & Operations

cloud-infrastructure - AWS/Azure/GCP architecture

/plugin install hanzo-cloud

Cloud design → Kubernetes → Terraform IaC → Hybrid cloud → Cost optimization

database-operations - Database optimization and administration

/plugin install hanzo-database

Schema design → Query optimization → Migrations → PostgreSQL/MySQL/MongoDB

Marketing & Business

seo-content-suite - SEO optimization toolkit

/plugin install hanzo-seo

Content analysis → Keyword research → Meta optimization → E-E-A-T signals

business-analytics - Business intelligence and metrics

/plugin install hanzo-business

KPI tracking → Financial reporting → Data-driven decision making

hr-legal-compliance - HR and legal documentation

/plugin install hanzo-hr-legal

HR policies → Legal templates → GDPR/SOC2/HIPAA compliance → Employment contracts

customer-sales-automation - Customer relationship workflows

/plugin install hanzo-sales

Support automation → Sales pipeline → Email campaigns → CRM integration

Specialized Domains

blockchain-web3 - Blockchain and smart contract development

/plugin install hanzo-blockchain

Solidity → Smart contracts → DeFi protocols → NFT platforms → Web3 apps

quantitative-trading - Financial modeling and algorithmic trading

/plugin install hanzo-quant

Quant analysis → Trading strategies → Portfolio risk → Backtesting

payment-processing - Payment gateway integration

/plugin install hanzo-payments

Stripe/PayPal integration → Checkout flows → Subscription billing → PCI compliance

game-development - Unity and Minecraft development

/plugin install hanzo-gaming

Unity C# scripting → Minecraft Bukkit/Spigot plugins → Game mechanics

accessibility-compliance - WCAG accessibility auditing

/plugin install hanzo-accessibility

WCAG validation → Screen reader testing → Keyboard navigation → Inclusive design

Manual Installation

cd ~/.claude
git clone https://github.com/hanzoai/agents.git

All agents, workflows, and tools will be automatically available to Claude Code.

Repository Structure

agents/
├── agents/                        # 83 specialized AI agents
│   ├── backend-architect.md
│   ├── frontend-developer.md
│   └── ... (all agent definitions)
├── workflows/                     # 15 multi-agent orchestrators
│   ├── feature-development.md
│   ├── full-stack-feature.md
│   ├── security-hardening.md
│   └── ... (workflow commands)
├── tools/                         # 42 development utilities
│   ├── api-scaffold.md
│   ├── security-scan.md
│   └── ... (tool commands)
└── README.md

Usage

Agent Invocation

After installing plugins, agents are automatically available. Invoke them explicitly in natural language:

"Use backend-architect to design the authentication API"
"Have security-auditor scan for OWASP vulnerabilities"
"Get performance-engineer to optimize this database query"

Claude Code automatically selects and coordinates the appropriate agents based on your request.

Multi-Agent Orchestration Examples

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

Role-Based Agents (Recommended)

For most users: Start with role-based agents that map to real job titles and coordinate multiple specialists.

Engineering Roles (IC Track)

Role Level Model Description Specialists Coordinated
staff-engineer IC6/L6 opus Platform architecture, company-wide initiatives architect-review, cloud-architect, kubernetes-architect, terraform-specialist
senior-engineer IC5/L5 sonnet Complex refactoring, performance optimization performance-engineer, database-optimizer, security-auditor
full-stack-engineer IC4/L4 sonnet End-to-end feature development backend-architect, frontend-developer, database-architect, deployment-engineer

Engineering Specializations

Role Model Description Key Capabilities Specialists Coordinated
devops opus Cloud infrastructure, K8s, IaC AWS/GCP/Azure, Terraform, Kubernetes, networking, cost optimization cloud-architect, kubernetes-architect, terraform-specialist, network-engineer
security-engineer opus Security audits, compliance OWASP Top 10, OAuth2, SOC2/GDPR/HIPAA, penetration testing security-auditor, backend/frontend/mobile-security-coder
devops-engineer sonnet CI/CD, production ops, SRE GitHub Actions, canary deploys, SLI/SLO, incident response devops-troubleshooter, deployment-engineer, incident-responder, observability-engineer
backend-engineer sonnet APIs, microservices, databases FastAPI, REST/GraphQL, PostgreSQL, event-driven architecture backend-architect, database-architect, api-documenter
frontend-engineer sonnet React/Next.js, UI/UX React 18+, Next.js 14+, @hanzo/ui, Core Web Vitals, accessibility frontend-developer, ui-ux-designer, ui-visual-validator
data-engineer sonnet ETL, data warehouses Airflow, dbt, Kafka, Snowflake/BigQuery, Great Expectations data-engineer (specialist), database-architect, sql-pro
ml-engineer opus ML models, MLOps PyTorch, MLflow, RAG systems, LLM fine-tuning, model serving ml-engineer (specialist), mlops-engineer, ai-engineer, data-scientist
qa-engineer sonnet Test automation, QA Jest/Pytest, Playwright, TDD, k6 load testing, quality gates test-automator, tdd-orchestrator, debugger, error-detective
platform-engineer opus Developer platforms Self-service deployment, CLIs, GitOps, service catalogs kubernetes-architect, terraform-specialist, deployment-engineer, dx-optimizer
mobile-engineer sonnet iOS/Android apps SwiftUI, Jetpack Compose, React Native, Flutter, offline-first mobile-developer, ios-developer, flutter-expert

Management & Leadership

Role Model Description Specialists Coordinated
tech-lead sonnet Sprint planning, team coordination, technical decisions Backend-architect, frontend-developer, database-optimizer, deployment-engineer

Product & Content

Role Model Description Specialists Coordinated
product-manager sonnet Product strategy, roadmap, PRDs business-analyst, ui-ux-designer, data-scientist
technical-writer sonnet API docs, tutorials, developer education docs-architect, api-documenter, tutorial-engineer, mermaid-expert

Usage Examples:

# Engineering IC Track
"Use staff-engineer to design our multi-tenant platform architecture"
"Have senior-engineer refactor this monolith into microservices"
"Use full-stack-engineer to build user authentication with dashboard"

# Infrastructure & Operations
"Use devops to design multi-region AWS infrastructure with auto-scaling"
"Have security-engineer perform OWASP audit and fix vulnerabilities"
"Use devops-engineer to set up CI/CD with GitHub Actions and canary deploys"

# Application Development
"Use backend-engineer to build REST API with PostgreSQL and Redis caching"
"Have frontend-engineer create responsive dashboard with @hanzo/ui components"
"Use mobile-engineer to build iOS app with offline-first architecture"

# Data & ML
"Use data-engineer to build ETL pipeline with Airflow and dbt"
"Have ml-engineer create customer churn model with deployment pipeline"
"Use qa-engineer to create comprehensive test suite with 90% coverage"

# Product & Platform
"Use platform-engineer to build self-service deployment system"
"Have product-manager write PRD for new onboarding flow with metrics"
"Use technical-writer to generate OpenAPI docs and tutorials"

# Management
"Use tech-lead to plan Q1 sprint and break down epics into tasks"

Specialized 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 opus 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 opus 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 sonnet 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 sonnet 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 sonnet 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 sonnet Meta title and description optimization
seo-keyword-strategist sonnet Keyword analysis and semantic variations
seo-structure-architect sonnet Content structure and schema markup
seo-snippet-hunter sonnet Featured snippet formatting
seo-content-refresher sonnet Content freshness analysis
seo-cannibalization-detector sonnet Keyword overlap detection
seo-authority-builder sonnet E-E-A-T signal analysis
seo-content-writer sonnet SEO-optimized content creation
seo-content-planner sonnet Content planning and topic clusters

Specialized Domains

Agent Model Description
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 sonnet Multi-agent context management

Model Configuration

Agents are assigned to specific Claude models based on task complexity and computational requirements. The system uses three model tiers:

Model Distribution Summary

Model Agent Count Use Case
Haiku 11 Quick, focused tasks with minimal computational overhead
Sonnet 50 Standard development and specialized engineering tasks
Opus 22 Complex reasoning, architecture, and critical analysis

Haiku Model Agents

Category Agents
Context & Reference context-manager, reference-builder, sales-automator, search-specialist
SEO Optimization seo-meta-optimizer, seo-keyword-strategist, seo-structure-architect, seo-snippet-hunter, seo-content-refresher, seo-cannibalization-detector, seo-content-planner

Sonnet Model Agents

Category Count Agents
Programming Languages 18 All language-specific agents (JavaScript, Python, Java, C++, etc.)
Frontend & UI 5 frontend-developer, ui-ux-designer, ui-visual-validator, mobile-developer, ios-developer
Infrastructure 8 devops-troubleshooter, deployment-engineer, dx-optimizer, database-admin, 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 7 architect-reviewer, backend-architect, cloud-architect, hybrid-cloud-architect, kubernetes-architect, graphql-architect, terraform-specialist
Critical Analysis 6 code-reviewer, security-auditor, performance-engineer, observability-engineer, incident-responder, database-optimizer
AI/ML Complex 5 ai-engineer, ml-engineer, mlops-engineer, data-scientist, prompt-engineer
Business Critical 4 docs-architect, hr-pro, legal-advisor, quant-analyst

Agent Registry

All 107 agents are catalogued in .hanzo/agents/plugins/agent-registry.json for programmatic access and tooling integration.

Regenerating the Registry

After adding or modifying agents:

make registry

Or manually:

python3 scripts/generate-registry.py

The registry includes:

  • Agent name and display name
  • File path relative to repo root
  • Model configuration (opus/sonnet/inherit)
  • Color coding (if specified)
  • Short description extracted from frontmatter

Registry Format

{
  "version": "1.0.1",
  "agents": {
    "agent-name": {
      "name": "Display Name",
      "path": "./agents/filename.md",
      "model": "opus|sonnet|inherit",
      "color": "red",
      "description": "Short description"
    }
  }
}

Contributing

To add new agents, workflows, or tools:

  1. Create a new .md file in the appropriate directory with frontmatter
  2. Use lowercase, hyphen-separated naming convention
  3. Write clear activation criteria in the description
  4. Define comprehensive system prompt with expertise areas
  5. Run make registry to update the agent registry

Subagent Format

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
---

System prompt defining the subagent's expertise and behavior

Model Selection Criteria

  • Sonnet: Standard development, engineering tasks, and focused operations (default for quality)
  • Opus: Complex analysis, architecture, critical operations, and high-stakes decisions

Agent Architecture

Every agent includes:

  1. Hanzo-First Development - Prioritizes Hanzo infrastructure (@hanzo/ui, LLM Gateway, Cloud)
  2. hanzo-mcp tools - 26 tools for file, search, shell, and agent operations
  3. Multi-Agent Coordination - Parallel execution with batch() and dispatch_agent()
  4. Production Examples - Real code, runbooks, and best practices
  5. Specialist Coordination - Knows which specialists to invoke for complex tasks

License

MIT License - see LICENSE file for details.

Core Team Preset (Recommended for Most Users)

Start with these essential agents (covers 90% of development tasks):

/plugin install hanzo-core-team

Option A: Role-Based Core Team (Recommended)

Agent Role Use For
staff-engineer IC6 Platform Architect Company-wide technical initiatives, platform design
senior-engineer IC5 Technical Lead Complex refactoring, performance optimization
full-stack-engineer IC4 Feature Developer End-to-end feature implementation
devops Infrastructure Cloud architecture, Kubernetes, Terraform, networking
security-engineer Security & Compliance OWASP audits, compliance, secure coding

Option B: Specialist Core Team (Classic)

Agent Specialty Use For
cto Technical Leadership Architecture decisions, technology evaluation, first-principles coding
dev Primary Developer Clean, simple implementations with minimal dependencies
hanzo Hanzo Infrastructure Hanzo platform integration, MCP, @hanzo/ui components
reviewer Code Quality PR reviews, best practices, security checks
architect System Design Architecture planning, system design, technical strategy

Usage:

# Role-based (simpler, maps to job titles)
"Use senior-engineer to optimize this slow API"
"Have devops design our Kubernetes infrastructure"

# Specialist (focused, specific expertise)
"Use dev to implement a rate limiter"
"Have reviewer check this PR for issues"

Documentation

Key Features

Hanzo-Native - All agents prioritize Hanzo infrastructure and use hanzo-mcp tools ✅ Parallel Execution - Agents use batch() and dispatch_agent() for speed ✅ Role-Based - 16 agents map to real job titles (Staff Engineer, DevOps, Security, etc.) ✅ Comprehensive - 88 specialists cover every domain (languages, frameworks, platforms) ✅ Production-Ready - Real code examples, runbooks, testing strategies ✅ Multi-Agent Workflows - Coordinate multiple agents for complex operations ✅ No Haiku - All agents use Sonnet (quality) or Opus (complexity) ✅ MCP Integration - 26 hanzo-mcp tools built into every agent

Resources

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

 
 
 

Contributors