Claude Code Tresor - Sub-Agents Directory

Organized collection of 137+ specialized AI agents for software development

Version: 2.5.0 | Last Updated: November 15, 2025

📚 Table of Contents

Overview
Directory Structure
Team Categories
Color Legend
Quick Start
Navigation
Installation

Overview

This directory contains a comprehensive, team-aligned organization of 137+ specialized AI agents covering all aspects of software development, business operations, design, marketing, and more.

Key Features

✨ 9 Team Categories - Organized by business function
🎨 Color-Coded - Visual identification system
📁 Hierarchical Structure - Easy navigation and discovery
🔧 Standardized Format - Consistent YAML frontmatter
🤝 Skill Integration - Coordination with autonomous skills
📊 137+ Agents - Comprehensive coverage

Directory Structure

subagents/
├── README.md                          # This file
│
├── 🔵 engineering/                    # Engineering Team (60+ agents)
│   ├── backend/
│   ├── frontend/
│   ├── mobile/
│   ├── devops/
│   ├── security/
│   ├── testing/
│   ├── data/
│   ├── languages/                     # 16 language specialists
│   ├── architecture/
│   ├── code-quality/
│   ├── performance/
│   ├── debugging/
│   └── documentation/
│
├── 🎨 design/                         # Design Team (10 agents)
│   ├── ui/
│   ├── ux/
│   ├── visual/
│   └── brand/
│
├── 🌱 marketing/                      # Marketing Team (15+ agents)
│   ├── content/
│   ├── social/
│   ├── growth/
│   └── seo/
│
├── 💜 product/                        # Product Team (10+ agents)
│   ├── management/
│   ├── requirements/
│   ├── research/
│   └── analytics/
│
├── 🏆 leadership/                     # Leadership & Strategy (15+ agents)
│   ├── finance/
│   ├── strategy/
│   ├── risk/
│   └── compliance/
│
├── 🌊 operations/                     # Operations Team (10+ agents)
│   ├── analytics/
│   ├── infrastructure/
│   ├── support/
│   └── project-management/
│
├── 🔶 research/                       # Research Team (10+ agents)
│   ├── market/
│   ├── user/
│   └── data/
│
├── 🧠 ai-automation/                  # AI & Automation (10+ agents)
│   ├── ai-engineering/
│   ├── ml-engineering/
│   ├── automation/
│   └── prompts/
│
├── 💙 account-customer-success/       # Account & CS (8+ agents)
│   ├── account-management/
│   ├── customer-success/
│   ├── support/
│   └── sales/
│
└── ⭐ core/                           # Core Agents (8 production-ready)
    ├── systems-architect.md
    ├── config-safety-reviewer.md
    ├── root-cause-analyzer.md
    ├── security-auditor.md
    ├── test-engineer.md
    ├── performance-tuner.md
    ├── refactor-expert.md
    └── docs-writer.md

Team Categories

1. 🔵 Engineering (60+ agents)

Color: Blue (#3B82F6) Path: subagents/engineering/

Specializations:

Backend Development (APIs, microservices, databases)
Frontend Development (React, Vue, Angular)
Mobile Development (iOS, Android, cross-platform)
DevOps & Infrastructure (CI/CD, cloud, containers)
Security (OWASP, secure coding, compliance)
Testing & QA (test automation, quality assurance)
Data Engineering (ETL, pipelines, analytics)
Language Specialists (16 languages)
Architecture (system design, patterns)
Code Quality (reviews, refactoring)
Performance (optimization, profiling)
Debugging (RCA, troubleshooting)
Documentation (technical writing, API docs)

Quick Start: See Engineering README

2. 🎨 Design (10 agents)

Color: Magenta/Pink (#EC4899) Path: subagents/design/

Specializations:

UI Design (interface design, design systems)
UX Research (user research, usability testing)
Visual Design (branding, visual storytelling)
Brand (brand guidelines, consistency)

Key Agents: ui-designer, ux-researcher, brand-guardian, visual-storyteller, whimsy-injector

3. 🌱 Marketing (15+ agents)

Color: Green (#10B981) Path: subagents/marketing/

Specializations:

Content Marketing (blog posts, SEO, content strategy)
Social Media (Instagram, TikTok, Twitter/X, Reddit)
Growth Marketing (growth hacking, viral marketing)
SEO & ASO (search optimization, app store optimization)

Key Agents: content-creator, growth-hacker, instagram-curator, tiktok-strategist, reddit-community-builder

4. 💜 Product (10+ agents)

Color: Purple (#8B5CF6) Path: subagents/product/

Specializations:

Product Management (roadmap, prioritization, strategy)
Requirements (PRD writing, requirements gathering)
Product Research (trend analysis, user feedback)
Product Analytics (metrics, KPIs, dashboards)

Key Agents: product-manager-orchestrator, sprint-prioritizer, prd-writer, feedback-synthesizer, trend-researcher

5. 🏆 Leadership & Strategy (15+ agents)

Color: Gold (#F59E0B) Path: subagents/leadership/

Specializations:

Finance (financial analysis, investment, pricing)
Business Strategy (strategic planning, partnerships)
Risk Management (portfolio risk, hedging, assessment)
Compliance & Legal (regulatory compliance, legal docs)

Key Agents: financial-analyst-fs, business-strategist-fs, risk-manager, compliance-officer-fs, legal-advisor

6. 🌊 Operations (10+ agents)

Color: Teal (#14B8A6) Path: subagents/operations/

Specializations:

Business Analytics (reporting, insights)
Infrastructure Operations (maintenance, optimization)
Support Operations (customer support, tickets)
Project Management (delivery, tracking)

Key Agents: analytics-reporter, infrastructure-maintainer, support-responder, studio-producer

7. 🔶 Research (10+ agents)

Color: Orange (#F97316) Path: subagents/research/

Specializations:

Market Research (competitive intelligence, market sizing)
User Research (experience analysis, user insights)
Data Research (deep research, web search)

Key Agents: competitive-intelligence-mx, market-research-analyst, tam-market-sizing-mx, search-specialist

8. 🧠 AI & Automation (10+ agents)

Color: Indigo (#6366F1) Path: subagents/ai-automation/

Specializations:

AI Engineering (LLM applications, RAG systems)
ML Engineering (ML pipelines, model serving, MLOps)
Automation (workflow automation, integration)
Prompt Engineering (prompt optimization, LLM tuning)

Key Agents: ai-engineer, ml-engineer, mlops-engineer, ai-workflow-designer-aa, automation-architect-aa

9. 💙 Account & Customer Success (8+ agents)

Color: Cyan (#06B6D4) Path: subagents/account-customer-success/

Specializations:

Account Management (account executives, revenue)
Customer Success (onboarding, retention)
Customer Support (support specialists)
Sales Engineering (technical sales, demos)

Key Agents: account-executive-revenue-at, customer-success-manager, sales-engineer-gr

10. ⭐ Core Agents (8 production-ready)

Path: subagents/core/ or /agents/

Core Production Agents:

systems-architect - System design and architecture
config-safety-reviewer - Configuration safety specialist
root-cause-analyzer - Comprehensive RCA debugging
security-auditor - Strategic security audits
test-engineer - Comprehensive testing strategy
performance-tuner - Performance optimization
refactor-expert - Code refactoring specialist
docs-writer - Technical documentation

These are the most mature, production-ready agents with comprehensive capabilities and skills integration.

Color Legend

Team	Color	Hex Code	Emoji	Example Use
Engineering	Blue	`#3B82F6`	🔵	Software development, architecture, testing
Design	Magenta/Pink	`#EC4899`	🎨	UI/UX design, branding, visual design
Marketing	Green	`#10B981`	🌱	Content, growth, social media
Product	Purple	`#8B5CF6`	💜	Product management, requirements, research
Leadership	Gold	`#F59E0B`	🏆	Finance, strategy, risk, compliance
Operations	Teal	`#14B8A6`	🌊	Analytics, support, project management
Research	Orange	`#F97316`	🔶	Market research, competitive intelligence
AI/Automation	Indigo	`#6366F1`	🧠	AI/ML engineering, automation
Account/CS	Cyan	`#06B6D4`	💙	Account management, customer success
Core	Gold	`#FFD700`	⭐	Production-ready core agents

Color Usage

Colors are used in:

Agent Badges - Visual identification
Documentation - Color-coded sections
CLI Output - Terminal formatting
IDE Integration - File icons and decorations

Quick Start

1. Find an Agent

By Category:

# List engineering agents
ls subagents/engineering/

# List backend agents
ls subagents/engineering/backend/

# List all agents
find subagents -name "*.md" -type f

By Function:

Need API design? → subagents/engineering/backend/
Need UI design? → subagents/design/ui/
Need market research? → subagents/research/market/
Need testing? → subagents/engineering/testing/

2. Invoke an Agent

# Use @ symbol with agent name
@systems-architect Design a scalable system for 100k users
@config-safety-reviewer Review database connection settings
@root-cause-analyzer Debug production API timeout
@security-auditor Audit authentication implementation

3. Use Skills (Autonomous Helpers)

Skills work automatically in the background:

security-auditor skill - OWASP scanning
test-generator skill - Test scaffolding
secret-scanner skill - Credential detection
dependency-auditor skill - CVE checking

Agents invoke skills automatically for quick checks before deep analysis.

Navigation

Finding the Right Agent

Decision Tree:

1. What's your task domain?
   ├─ Software Development → Engineering
   ├─ Design Work → Design
   ├─ Marketing/Content → Marketing
   ├─ Product Work → Product
   ├─ Business Strategy → Leadership
   ├─ Operations → Operations
   ├─ Research → Research
   ├─ AI/ML → AI & Automation
   └─ Customer Facing → Account & CS

2. What's your specific need?
   Engineering:
   ├─ Backend work? → engineering/backend/
   ├─ Frontend work? → engineering/frontend/
   ├─ Security? → engineering/security/
   ├─ Testing? → engineering/testing/
   ├─ Performance? → engineering/performance/
   ├─ Debugging? → engineering/debugging/
   └─ Architecture? → engineering/architecture/

3. Choose agent:
   - Read agent README for capabilities
   - Check usage examples
   - Invoke with @agent-name

Category READMEs

Each category has a comprehensive README:

Engineering README - 60+ engineering agents
Design README - 10 design agents
Marketing README - 15+ marketing agents
Product README - 10+ product agents
Leadership README - 15+ leadership agents
Operations README - 10+ operations agents
Research README - 10+ research agents
AI & Automation README - 10+ AI/automation agents
Account & CS README - 8+ account/CS agents

Installation

Full Installation

# Install all agents (recommended)
./scripts/install.sh

# This installs:
# - 8 core agents (to ~/.claude/agents/)
# - 137+ specialized agents (to .claude/agents/)
# - Skills (8 autonomous helpers)
# - Commands (4 workflow orchestrators)

Selective Installation

# Install specific categories
./scripts/install.sh --category engineering
./scripts/install.sh --category design
./scripts/install.sh --category marketing

# Install core agents only
./scripts/install.sh --core

# Install skills only
./scripts/install.sh --skills

Directory Locations

User-Level Agents (global):

~/.claude/agents/

Project-Level Agents (project-specific):

.claude/agents/

Precedence: Project agents override user agents with the same name.

Agent Structure

YAML Frontmatter

Every agent follows this structure:

---
name: agent-name
description: Agent purpose and when to use it
tools: Tool1, Tool2, Tool3
model: inherit
color: blue
category: engineering
subcategory: backend
---

[Agent system prompt and capabilities]

Required Fields

name: kebab-case identifier
description: When to use this agent
tools: Accessible tools (Read, Write, Edit, etc.)
model: Always inherit

Optional Fields

color: Team color code
category: Primary team category
subcategory: Functional sub-category
level: strategic/tactical
depth: comprehensive/lightweight
specialization: Unique focus area

Standards Integration

All agents follow standards from /standards/ folder:

Code Quality - ESLint, Prettier, best practices
Git Workflows - Conventional commits, branch strategies
Testing - Test pyramid, coverage standards
Security - OWASP guidelines, secure coding
Documentation - Technical writing standards
Performance - Performance budgets

These standards act as Standard Operating Procedures (SOPs) for consistent quality.

Usage Examples

Comprehensive Code Review

# Configuration safety review
@config-safety-reviewer Review database pool settings in config.js

# General code review
@code-reviewer Review this React component for best practices

# Security-focused review
@security-auditor Full security audit of authentication system

System Architecture

# System design
@systems-architect Design scalable e-commerce platform

# Backend API design
@backend-architect Design RESTful API for user management

# Cloud infrastructure
@cloud-architect Design AWS infrastructure for microservices

Testing & QA

# Comprehensive test strategy
@test-engineer Create test suite for UserService

# QA mindset testing
@qa-test-engineer Create adversarial test cases

# Performance testing
@performance-benchmarker Create load tests for API endpoints

Debugging

# Comprehensive root cause analysis
@root-cause-analyzer Production API timing out under load

# Quick debugging
@debugger Fix error in payment processing

# Error patterns
@error-detective Analyze recurring 500 errors in logs

Contributing

See CONTRIBUTING.md for guidelines on:

Adding new agents
Updating existing agents
Category organization
Testing and validation

Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Documentation: Complete Documentation

Version: 2.5.0 Last Updated: November 15, 2025 License: MIT Author: Alireza Rezvani

Uh oh!

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

Claude Code Tresor - Sub-Agents Directory

📚 Table of Contents

Overview

Key Features

Directory Structure

Team Categories

1. 🔵 Engineering (60+ agents)

2. 🎨 Design (10 agents)

3. 🌱 Marketing (15+ agents)

4. 💜 Product (10+ agents)

5. 🏆 Leadership & Strategy (15+ agents)

6. 🌊 Operations (10+ agents)

7. 🔶 Research (10+ agents)

8. 🧠 AI & Automation (10+ agents)

9. 💙 Account & Customer Success (8+ agents)

10. ⭐ Core Agents (8 production-ready)

Color Legend

Color Usage

Quick Start

1. Find an Agent

2. Invoke an Agent

3. Use Skills (Autonomous Helpers)

Navigation

Finding the Right Agent

Category READMEs

Installation

Full Installation

Selective Installation

Directory Locations

Agent Structure

YAML Frontmatter

Required Fields

Optional Fields

Standards Integration

Usage Examples

Comprehensive Code Review

System Architecture

Testing & QA

Debugging

Related Documentation

Contributing

Support