A comprehensive collection of specialized AI subagents for Claude Code, designed to enhance development workflows with domain-specific expertise. Now featuring Hive-Mind Architecture for intelligent multi-agent coordination.
This repository contains 95 expert-level subagents that extend Claude Code's capabilities with deep, specialized knowledge across all areas of software development and business operations. Each subagent has been comprehensively enhanced with:
- 2024/2025 Best Practices - Latest tools, frameworks, and industry standards
- Production-Ready Knowledge - Real-world scenarios and enterprise patterns
- Expert-Level Depth - 8-12 detailed capability subsections per agent
- Modern Tech Stacks - Current versions and cutting-edge technologies
- Optimal Model Selection - Opus/Sonnet/Haiku assignment based on task complexity
- Hive-Mind Architecture - Distributed multi-agent coordination for complex tasks
The hive-mind system enables intelligent coordination of multiple agents for complex, enterprise-scale tasks. Inspired by swarm intelligence and distributed systems patterns.
| Agent | Purpose | Model |
|---|---|---|
| hive-queen-strategic | High-level planning, goal decomposition, multi-agent orchestration | Opus |
| hive-queen-tactical | Real-time execution coordination, progress monitoring, blocker resolution | Opus |
| hive-queen-adaptive | Continuous optimization, pattern learning, workflow improvement | Opus |
┌─────────────────────────────────────────────────────────────────────┐
│ HIVE-QUEEN-STRATEGIC │
│ (Planning & Decomposition) │
└──────────────────────────┬──────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ HIVE-QUEEN-TACTICAL │
│ (Execution Coordination) │
└──────────────────────────┬──────────────────────────────────────────┘
│
┌────────────┼────────────┐
│ │ │
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐
│ SWARM │ │ TASK │ │ MEMORY │
│COORDNTR │ │ ROUTER │ │ARCHIVIST│
└────┬────┘ └────┬────┘ └────┬────┘
│ │ │
┌───────┴───────┐ │ │
│ │ │ │
▼ ▼ ▼ ▼
┌─────────┐ ┌─────────────┐ ┌─────────────┐
│ Worker │ │ Worker │ │ Shared │
│ Agents │ │ Agents │ │ Memory │
│ (Swarm) │ │ (Routed) │ │ System │
└─────────┘ └─────────────┘ └─────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ HIVE-QUEEN-ADAPTIVE │
│ (Learning & Continuous Improvement) │
└─────────────────────────────────────────────────────────────────────┘
# Enterprise-scale platform migration
"Use hive-queen-strategic to orchestrate migration from monolith to microservices"
# Spawns: backend-architect, database-architect, kubernetes-architect, devops-troubleshooter
# Complex feature with multiple teams
"Have hive-queen-tactical coordinate the checkout feature across frontend, backend, and payments"
# Coordinates: frontend-developer, backend-architect, payment-integration, test-automator
# Continuous optimization
"Use hive-queen-adaptive to analyze our deployment patterns and suggest improvements"
# Analyzes: deployment-engineer, performance-engineer, observability-engineer
# Distributed code analysis
"Have swarm-coordinator spawn parallel code reviewers across the codebase"
# Spawns: multiple code-reviewer instances, consensus-builder for aggregation
# Multi-agent decision making
"Use consensus-builder to resolve the architecture disagreement between teams"
# Coordinates: backend-architect, frontend-developer, security-auditor- backend-architect - Design RESTful APIs, microservice boundaries, and database schemas
- frontend-developer - Build React components, implement responsive layouts, and handle client-side state management
- ui-ux-designer - Create interface designs, wireframes, and design systems
- ui-visual-validator - Verify whether UI modifications have achieved their intended goals through rigorous screenshot analysis
- mobile-developer - Develop React Native or Flutter apps with native integrations
- graphql-architect - Design GraphQL schemas, resolvers, and federation
- architect-reviewer - Reviews code changes for architectural consistency and patterns
- database-architect - Design scalable database systems, data modeling, and distributed data architecture
- event-sourcing-architect - Expert in event sourcing, CQRS, and event-driven architecture patterns
- monorepo-architect - Monorepo strategy with Nx, Turborepo, and Bazel for large-scale codebases
- python-pro - Write idiomatic Python code with advanced features and optimizations
- ruby-pro - Write idiomatic Ruby code with metaprogramming, Rails patterns, gem development, and testing frameworks
- golang-pro - Write idiomatic Go code with goroutines, channels, and interfaces
- rust-pro - Write idiomatic Rust with ownership patterns, lifetimes, and trait implementations
- c-pro - Write efficient C code with proper memory management and system calls
- cpp-pro - Write idiomatic C++ code with modern features, RAII, smart pointers, and STL algorithms
- javascript-pro - Master modern JavaScript with ES6+, async patterns, and Node.js APIs
- typescript-pro - Master TypeScript with advanced types, generics, and strict type safety
- php-pro - Write idiomatic PHP code with modern features and performance optimizations
- java-pro - Master modern Java with streams, concurrency, and JVM optimization
- elixir-pro - Write idiomatic Elixir code with OTP patterns, functional programming, and Phoenix frameworks
- csharp-pro - Write modern C# code with advanced features and .NET optimization
- scala-pro - Master enterprise-grade Scala development with functional programming, distributed systems, and big data processing
- flutter-expert - Master Flutter development with Dart, widgets, and platform integrations
- unity-developer - Build Unity games with optimized scripts and performance tuning
- minecraft-bukkit-pro - Master Minecraft server plugin development with Bukkit, Spigot, and Paper APIs
- ios-developer - Develop native iOS applications with Swift/SwiftUI
- sql-pro - Write complex SQL queries, optimize execution plans, and design normalized schemas
- haskell-pro - Pure functional programming with advanced type systems and GHC
- devops-troubleshooter - Debug production issues, analyze logs, and fix deployment failures
- deployment-engineer - Configure CI/CD pipelines, Docker containers, and cloud deployments
- cloud-architect - Design AWS/Azure/GCP infrastructure and optimize cloud costs
- hybrid-cloud-architect - Design hybrid cloud infrastructure across AWS/Azure/GCP and OpenStack on-premises environments
- kubernetes-architect - Design cloud-native infrastructure with Kubernetes at its core and GitOps principles across AWS/Azure/GCP and hybrid environments.
- database-optimizer - Optimize SQL queries, design efficient indexes, and handle database migrations
- database-admin - Manage database operations, backups, replication, and monitoring
- terraform-specialist - Write advanced Terraform modules, manage state files, and implement IaC best practices
- incident-responder - Handles production incidents with urgency and precision
- network-engineer - Debug network connectivity, configure load balancers, and analyze traffic patterns
- dx-optimizer - Developer Experience specialist that improves tooling, setup, and workflows
- service-mesh-expert - Istio, Linkerd, and Envoy for microservice traffic management and mTLS
- observability-engineer - OpenTelemetry, metrics, logging, and distributed tracing
- arm-cortex-expert - Embedded systems with ARM Cortex-M, RTOS, and bare-metal programming
- code-reviewer - Expert code review with deep configuration security focus and production reliability
- security-auditor - Review code for vulnerabilities and ensure OWASP compliance
- test-automator - Create comprehensive test suites with unit, integration, and e2e tests
- performance-engineer - Profile applications, optimize bottlenecks, and implement caching strategies
- debugger - Debugging specialist for errors, test failures, and unexpected behavior
- error-detective - Search logs and codebases for error patterns, stack traces, and anomalies
- search-specialist - Expert web researcher using advanced search techniques and synthesis
- tdd-orchestrator - Test-Driven Development workflows and testing strategy
- data-scientist - Data analysis expert for SQL queries, BigQuery operations, and data insights
- data-engineer - Build ETL pipelines, data warehouses, and streaming architectures
- ai-engineer - Build LLM applications, RAG systems, and prompt pipelines
- ml-engineer - Implement ML pipelines, model serving, and feature engineering
- mlops-engineer - Build ML pipelines, experiment tracking, and model registries
- prompt-engineer - Optimizes prompts for LLMs and AI systems
- vector-database-engineer - Pinecone, Qdrant, Weaviate, and semantic search systems
- api-documenter - Create OpenAPI/Swagger specs and write developer documentation
- payment-integration - Integrate Stripe, PayPal, and payment processors
- quant-analyst - Build financial models, backtest trading strategies, and analyze market data
- risk-manager - Monitor portfolio risk, R-multiples, and position limits
- legacy-modernizer - Refactor legacy codebases and implement gradual modernization
- context-manager - Manages context across multiple agents and long-running tasks
- blockchain-developer - Smart contracts, DeFi, Web3, and blockchain security with Solidity
- docs-architect - Creates comprehensive technical documentation from existing codebases
- mermaid-expert - Create Mermaid diagrams for flowcharts, sequences, ERDs, and architectures
- reference-builder - Creates exhaustive technical references and API documentation
- tutorial-engineer - Creates step-by-step tutorials and educational content from code
- business-analyst - Analyze metrics, create reports, and track KPIs
- content-marketer - Write blog posts, social media content, and email newsletters
- hp-pro - Partner for hiring, onboarding/offboarding, PTO and leave, performance, compliant policies, and employee relations.
- sales-automator - Draft cold emails, follow-ups, and proposal templates
- customer-support - Handle support tickets, FAQ responses, and customer emails
- legal-advisor - Draft privacy policies, terms of service, disclaimers, and legal notices
- seo-content-auditor - Analyzes provided content for quality, E-E-A-T signals, and SEO best practices
- seo-meta-optimizer - Creates optimized meta titles, descriptions, and URL suggestions
- seo-keyword-strategist - Analyzes keyword usage, calculates density, suggests semantic variations
- seo-structure-architect - Optimizes content structure, header hierarchy, and schema markup
- seo-snippet-hunter - Formats content for featured snippets and SERP features
- seo-content-refresher - Identifies outdated elements and suggests content updates
- seo-cannibalization-detector - Analyzes multiple pages for keyword overlap and conflicts
- seo-authority-builder - Analyzes content for E-E-A-T signals and trust indicators
- seo-content-writer - Writes SEO-optimized content based on keywords and briefs
- seo-content-planner - Creates content outlines, topic clusters, and calendars
All 95 subagents are configured with specific Claude models based on task complexity:
Model: haiku
context-manager- AI context engineering with vector databasesreference-builder- Exhaustive technical references and API documentationsales-automator- Modern sales automation with CRM integrationsearch-specialist- Expert web research and information synthesisseo-meta-optimizer- Meta title and description optimizationseo-keyword-strategist- Keyword density and semantic analysisseo-structure-architect- Content structure and schema markupseo-snippet-hunter- Featured snippet formattingseo-content-refresher- Content freshness updatesseo-cannibalization-detector- Keyword overlap detectionseo-content-planner- Content calendars and topic clusterstask-router- Intelligent task assignment and capability matchingagent-spawner- Agent creation and lifecycle management
Model: sonnet
Development & Languages:
python-pro- Python development with advanced featuresruby-pro- Ruby development with metaprogramming, Rails patterns, and gem developmentjavascript-pro- Modern JavaScript and Node.jstypescript-pro- Advanced TypeScript with type systemsgolang-pro- Go concurrency and idiomatic patternsrust-pro- Rust memory safety and systems programmingc-pro- C programming and embedded systemscpp-pro- Modern C++ with STL and templatesphp-pro- Modern PHP with advanced featuresjava-pro- Modern Java with streams and concurrencyelixir-pro- Elixir with OTP patterns and Phoenixcsharp-pro- Modern C# with .NET frameworks and patternsscala-pro- Enterprise Scala with Apache Pekko, Akka, Spark, and ZIO/Cats Effectflutter-expert- Flutter development with state management and animationsunity-developer- Unity game development and optimizationminecraft-bukkit-pro- Minecraft plugin development with Bukkit/Spigot/Paperios-developer- Native iOS development with Swift/SwiftUIfrontend-developer- React components and UIui-ux-designer- Interface design and wireframesui-visual-validator- Rigorous UI validation through screenshot analysisbackend-architect- API design and microservicesmobile-developer- React Native/Flutter appssql-pro- Complex SQL optimizationgraphql-architect- GraphQL schemas and resolvershaskell-pro- Pure functional programming with advanced type systems
Infrastructure & Operations:
devops-troubleshooter- Production debugging with modern observabilitydeployment-engineer- GitOps workflows and platform engineeringcloud-architect- Multi-cloud expertise with FinOps optimizationhybrid-cloud-architect- Complex multi-cloud and edge architectureskubernetes-architect- Cloud-native infrastructure with service meshdatabase-optimizer- Advanced performance tuning and scalabilitydatabase-admin- Cloud databases and reliability engineeringterraform-specialist- Advanced IaC with OpenTofu knowledgenetwork-engineer- Zero-trust networking and service meshsecurity-auditor- DevSecOps and compliance automationperformance-engineer- OpenTelemetry and comprehensive optimizationincident-responder- SRE principles and modern incident managementdx-optimizer- Developer experience and platform engineeringdata-engineer- Modern data stack and real-time streamingservice-mesh-expert- Istio, Linkerd, and microservice traffic managementarm-cortex-expert- Embedded systems with ARM Cortex-M microcontrollersmonorepo-architect- Nx, Turborepo, and Bazel for large codebasesswarm-coordinator- Distributed agent spawning and coordinationconsensus-builder- Multi-agent decision-making and conflict resolutionmemory-archivist- Persistent shared memory for multi-agent operationstdd-orchestrator- Test-Driven Development workflows
Quality & AI/ML:
test-automator- AI-powered testing with self-healing frameworkscode-reviewer- Expert code analysis with modern security scanningai-engineer- Advanced LLM integration with RAG and agent systemsml-engineer- Production ML with modern frameworks and monitoringmlops-engineer- Comprehensive ML infrastructure and automationdata-scientist- Advanced analytics with cloud platformsprompt-engineer- Cutting-edge LLM optimization techniques
Model: opus
Critical Analysis & Architecture:
ai-engineer- LLM applications and RAG systemsarchitect-reviewer- Architectural consistency and patternsbackend-architect- System architecture and scalability designcloud-architect- Multi-cloud infrastructure architecturecode-reviewer- Critical code quality and security analysisdata-scientist- Complex analytics and statistical modelingdatabase-optimizer- Performance-critical query optimizationdatabase-architect- Scalable database design and distributed systemsevent-sourcing-architect- Event sourcing, CQRS, and domain-driven design
Complex Engineering & Operations:
hybrid-cloud-architect- Complex multi-cloud strategiesincident-responder- Critical production incident handlingkubernetes-architect- Cloud-native infrastructure designml-engineer- Complex ML model development and deploymentmlops-engineer- ML infrastructure and automationperformance-engineer- Advanced application optimizationprompt-engineer- Advanced LLM optimization techniquessecurity-auditor- Comprehensive vulnerability analysisterraform-specialist- Infrastructure architecture with IaCobservability-engineer- OpenTelemetry, distributed tracing, and monitoringvector-database-engineer- Semantic search and RAG infrastructureblockchain-developer- Smart contracts, DeFi, and Web3 security
Hive-Mind Leadership:
hive-queen-strategic- Strategic planning and multi-agent orchestrationhive-queen-tactical- Real-time execution coordinationhive-queen-adaptive- Continuous optimization and learning
Business Critical & Compliance:
context-manager- Multi-agent coordination for complex tasksdocs-architect- Comprehensive technical documentationhr-pro- Complex HR scenarios and legal compliancelegal-advisor- Legal analysis and contract reviewquant-analyst- Advanced financial modeling and algorithmic trading
Model Optimization: Agents are strategically assigned models based on task complexity:
- Opus (31): Complex reasoning, critical analysis, architecture, hive-mind leadership
- Sonnet (49): Balanced development, specialized tasks, swarm coordination
- Haiku (15): Fast, focused utility tasks, task routing
These subagents are automatically available when placed in ~/.claude/agents/ directory.
cd ~/.claude
git clone https://github.com/wshobson/agents.gitClaude Code will automatically delegate to the appropriate subagent based on the task context and the subagent's description.
Mention the subagent by name in your request:
"Use the code-reviewer to check my recent changes"
"Have the security-auditor scan for vulnerabilities"
"Get the performance-engineer to optimize this bottleneck"
# Code quality and review
"Use code-reviewer to analyze this component for best practices"
"Have code-reviewer scrutinize these configuration changes"
"Have security-auditor check for OWASP compliance issues"
# Development tasks
"Get backend-architect to design a user authentication API"
"Use frontend-developer to create a responsive dashboard layout"
# Infrastructure and operations
"Have devops-troubleshooter analyze these production logs"
"Use cloud-architect to design a scalable AWS architecture"
"Get network-engineer to debug SSL certificate issues"
"Use database-admin to set up backup and replication"
# Data and AI
"Get data-scientist to analyze this customer behavior dataset"
"Use ai-engineer to build a RAG system for document search"
"Have mlops-engineer set up MLflow experiment tracking"
# Business and marketing
"Have business-analyst create investor deck with growth metrics"
"Use content-marketer to write SEO-optimized blog post"
"Get sales-automator to create cold email sequence"
"Have customer-support draft FAQ documentation"These subagents work together seamlessly, and for more complex orchestrations, you can use the Claude Code Commands collection which provides 52 pre-built slash commands that leverage these subagents in sophisticated workflows.
# Feature development workflow
"Implement user authentication feature"
# Automatically uses: backend-architect → frontend-developer → test-automator → security-auditor
# Performance optimization workflow
"Optimize the checkout process performance"
# Automatically uses: performance-engineer → database-optimizer → frontend-developer
# Production incident workflow
"Debug high memory usage in production"
# Automatically uses: incident-responder → devops-troubleshooter → error-detective → performance-engineer
# Network connectivity workflow
"Fix intermittent API timeouts"
# Automatically uses: network-engineer → devops-troubleshooter → performance-engineer
# Database maintenance workflow
"Set up disaster recovery for production database"
# Automatically uses: database-admin → database-optimizer → incident-responder
# ML pipeline workflow
"Build end-to-end ML pipeline with monitoring"
# Automatically uses: mlops-engineer → ml-engineer → data-engineer → performance-engineer
# Product launch workflow
"Launch new feature with marketing campaign"
# Automatically uses: business-analyst → content-marketer → sales-automator → customer-supportFor more sophisticated multi-subagent orchestration, use the companion Commands repository:
# Complex feature development (8+ subagents)
/full-stack-feature Build user dashboard with real-time analytics
# Production incident response (5+ subagents)
/incident-response Database connection pool exhausted
# ML infrastructure setup (6+ subagents)
/ml-pipeline Create recommendation engine with A/B testing
# Security-focused implementation (7+ subagents)
/security-hardening Implement OAuth2 with zero-trust architectureEach subagent follows this structure:
---
name: subagent-name
description: When this subagent should be invoked
model: haiku # Optional - specify which model to use (haiku/sonnet/opus)
tools: tool1, tool2 # Optional - defaults to all tools
---
System prompt defining the subagent's role and capabilitiesAs of Claude Code v1.0.64, subagents can specify which Claude model they should use. This allows for cost-effective task delegation based on complexity:
- Low Complexity (Haiku): Simple tasks like basic data analysis, documentation generation, and standard responses
- Medium Complexity (Sonnet): Development tasks, code review, testing, and standard engineering work
- High Complexity (Opus): Critical tasks like security auditing, architecture review, incident response, and AI/ML engineering
Available models (using simplified naming as of Claude Code v1.0.64):
haiku- Fast and cost-effective for simple taskssonnet- Balanced performance for most development workopus- Most capable for complex analysis and critical tasks
If no model is specified, the subagent will use the system's default model.
Claude Code automatically coordinates agents using these common patterns:
User Request → Agent A → Agent B → Agent C → Result
Example: "Build a new API feature"
backend-architect → frontend-developer → test-automator → security-auditor
User Request → Agent A + Agent B (simultaneously) → Merge Results
Example: "Optimize application performance"
performance-engineer + database-optimizer → Combined recommendations
User Request → Analysis → Route to appropriate specialist
Example: "Fix this bug"
debugger (analyzes) → Routes to: backend-architect OR frontend-developer OR devops-troubleshooter
Primary Agent → Review Agent → Final Result
Example: "Implement payment processing"
payment-integration → security-auditor → Validated implementation
- hive-queen-strategic: Enterprise-scale planning, multi-team coordination, complex initiatives
- hive-queen-tactical: Active project execution, progress monitoring, blocker resolution
- hive-queen-adaptive: Workflow optimization, pattern analysis, continuous improvement
- swarm-coordinator: Parallel task execution, distributed agent management
- consensus-builder: Multi-agent decisions, conflict resolution, voting
- memory-archivist: Persistent context, cross-session continuity, collective knowledge
- task-router: Automatic task assignment, capability matching
- agent-spawner: Dynamic agent creation, configuration management
- backend-architect: API design, database schemas, system architecture
- frontend-developer: UI/UX planning, component architecture
- ui-ux-designer: Interface design, wireframes, design systems, user research
- cloud-architect: Infrastructure design, scalability planning
- database-architect: Data modeling, distributed databases, sharding strategies
- event-sourcing-architect: Event sourcing, CQRS, domain-driven design
- monorepo-architect: Nx, Turborepo, Bazel, large-scale repo management
- python-pro: Python-specific development tasks
- ruby-pro: Ruby metaprogramming, Rails applications, gem development, RSpec/Minitest testing
- golang-pro: Go-specific development tasks
- rust-pro: Rust-specific development, memory safety, systems programming
- c-pro: C programming, embedded systems, performance-critical code
- javascript-pro: Modern JavaScript, async patterns, Node.js/browser code
- typescript-pro: Advanced TypeScript, generics, type inference, enterprise patterns
- java-pro: Modern Java development, streams, concurrency, Spring Boot
- elixir-pro: Elixir development, OTP patterns, Phoenix frameworks, functional programming
- csharp-pro: Modern C# development, .NET frameworks, enterprise patterns
- scala-pro: Enterprise Scala with functional programming, Apache Pekko/Akka actors, Apache Spark, ZIO/Cats Effect, reactive architectures
- flutter-expert: Flutter development, Dart, state management, animations, cross-platform deployment
- unity-developer: Unity game development, C# scripting, performance optimization
- minecraft-bukkit-pro: Minecraft plugin development, event systems, server-side features
- ios-developer: Native iOS development with Swift/SwiftUI
- sql-pro: Database queries, schema design, query optimization
- mobile-developer: React Native/Flutter development
- haskell-pro: Pure functional programming, advanced type systems
- arm-cortex-expert: Embedded systems, ARM Cortex-M, RTOS
- devops-troubleshooter: Production issues, deployment problems
- incident-responder: Critical outages requiring immediate response
- database-optimizer: Query performance, indexing strategies
- database-admin: Backup strategies, replication, user management, disaster recovery
- terraform-specialist: Infrastructure as Code, Terraform modules, state management
- network-engineer: Network connectivity, load balancers, SSL/TLS, DNS debugging
- service-mesh-expert: Istio, Linkerd, Envoy, mTLS, traffic management
- observability-engineer: OpenTelemetry, metrics, logging, distributed tracing
- performance-engineer: Application bottlenecks, optimization
- security-auditor: Vulnerability scanning, compliance checks
- data-scientist: Data analysis, insights, reporting
- mlops-engineer: ML infrastructure, experiment tracking, model registries, pipeline automation
- vector-database-engineer: Pinecone, Qdrant, Weaviate, semantic search, RAG systems
- code-reviewer: Code quality, configuration security, production reliability
- test-automator: Test strategy, test suite creation
- debugger: Bug investigation, error resolution
- error-detective: Log analysis, error pattern recognition, root cause analysis
- search-specialist: Deep web research, competitive analysis, fact-checking
- tdd-orchestrator: Test-Driven Development, testing strategy, test pyramid design
- api-documenter: AI-powered documentation with modern dev portal architecture
- docs-architect: Comprehensive technical documentation with automated generation
- reference-builder: Exhaustive API references with interactive examples
- tutorial-engineer: AI-enhanced educational content with progressive learning
- architect-reviewer: Master software architecture with modern patterns
- graphql-architect: Modern GraphQL federation and performance optimization
- business-analyst: Advanced BI with AI-powered analytics and strategic frameworks
- hr-pro: Modern HR technology with talent management and compliance
- legal-advisor: Legal technology with contract analysis and compliance automation
- content-marketer: AI-powered content marketing with omnichannel distribution
- sales-automator: Modern sales automation with CRM integration
- customer-support: AI-powered support with conversational automation
- quant-analyst: Advanced quantitative finance with algorithmic trading
- risk-manager: Comprehensive risk management with modern analytics
- payment-integration: Modern payment systems and fintech integration
- legacy-modernizer: Strategic legacy transformation with cloud migration
- blockchain-developer: Smart contracts, DeFi, Web3, Solidity, blockchain security
- Let Claude Code delegate automatically - The main agent analyzes context and selects optimal agents
- Be specific about requirements - Include constraints, tech stack, and quality requirements
- Trust agent expertise - Each agent is optimized for their domain
- Start with high-level requests - Let agents coordinate complex multi-step tasks
- Provide context between agents - Ensure agents have necessary background information
- Review integration points - Check how different agents' outputs work together
- Use explicit invocation for specific needs - When you want a particular expert's perspective
- Combine multiple agents strategically - Different specialists can validate each other's work
- Request specific review patterns - "Have security-auditor review backend-architect's API design"
- Monitor agent effectiveness - Learn which agents work best for your use cases
- Iterate on complex tasks - Use agent feedback to refine requirements
- Leverage agent strengths - Match task complexity to agent capabilities
To add a new subagent:
- Create a new
.mdfile following the format above - Use lowercase, hyphen-separated names
- Write clear descriptions for when the subagent should be used
- Include specific instructions in the system prompt
Agent not being invoked automatically:
- Ensure your request clearly indicates the domain (e.g., "performance issue" → performance-engineer)
- Be specific about the task type (e.g., "review code" → code-reviewer)
Unexpected agent selection:
- Provide more context about your tech stack and requirements
- Use explicit invocation if you need a specific agent
Multiple agents producing conflicting advice:
- This is normal - different specialists may have different priorities
- Ask for clarification: "Reconcile the recommendations from security-auditor and performance-engineer"
Agent seems to lack context:
- Provide background information in your request
- Reference previous conversations or established patterns
If agents aren't working as expected:
- Check agent descriptions in their individual files
- Try more specific language in your requests
- Use explicit invocation to test specific agents
- Provide more context about your project and goals
This project is licensed under the MIT License - see the LICENSE file for details.