Agents

Files (27)

• AgentPersonalities.md
• AgentProfileSystem.md
• ArchitectContext.md
• ArtistContext.md
• ClaudeResearcherContext.md
• CodexResearcherContext.md
• Traits.yaml · Data/
• DesignerContext.md
• EngineerContext.md
• GeminiResearcherContext.md
• GrokResearcherContext.md
• PerplexityResearcherContext.md
• QATesterContext.md
• REDESIGN-SUMMARY.md
• SKILL.md
• sparkline-color-analysis.md · Scratchpad/
• CUSTOMAGENTTEMPLATE.md · Templates/
• DynamicAgent.hbs · Templates/
• AgentFactory.ts · Tools/
• ComposeAgent.ts · Tools/
• LoadAgentContext.ts · Tools/
• SpawnAgentWithProfile.ts · Tools/
• bun.lock · Tools/
• package.json · Tools/
• CreateCustomAgent.md · Workflows/
• ListTraits.md · Workflows/
• SpawnParallelAgents.md · Workflows/

SKILL.md (first lines)

# Agents - Custom Agent Composition System

**Auto-routes when user mentions custom agents, agent creation, or specialized personalities.**

## Overview

The Agents skill provides complete agent composition and management:
- Dynamic agent composition from traits (expertise + personality + approach)
- Personality definitions and voice mappings
- Custom agent creation with unique voices
- Parallel agent orchestration patterns

## Workflow Routing

**Available Workflows:**
- **CREATECUSTOMAGENT** - Create specialized custom agents → `Workflows/CreateCustomAgent.md`
- **LISTTRAITS** - Show available agent traits → `Workflows/ListTraits.md`
- **SPAWNPARALLEL** - Launch parallel agents → `Workflows/SpawnParallelAgents.md`

## Route Triggers

**CRITICAL: The word "custom" is the ABSOLUTE trigger - NO EXCEPTIONS:**

| User Says | What to Use | subagent_type | Why |
|-----------|-------------|---------------|-----|
| "**custom agents**", "create **custom** agents", "spin up **custom**" | AgentFactory | `general-purpose` | Unique prompts + unique voices |
| "agents", "launch agents", "bunch of agents" | Generic prompt | `Intern` | Same voice, parallel grunt work |
| "use [agent name]", "get [agent name] to" | Direct call | Named agent type | Pre-defined personality |

**CONSTITUTIONAL RULE FOR CUSTOM AGENTS:**
When user says "custom agents", you MUST:
1. Use AgentFactory to compose EACH agent with DIFFERENT traits
2. Use `subagent_type: "general-purpose"` - **NEVER** "Intern", "Designer", "Architect", etc.
3. Each agent gets their own voice from the trait-to-voice mapping

**❌ NEVER DO THIS for custom agents:**
```
subagent_type: "Intern"      // WRONG - forces same voice on all
subagent_type: "Designer"    // WRONG - forces Designer's voice
subagent_type: "Architect"   // WRONG - forces Architect's voice
```

**✅ ALWAYS DO THIS for custom agents:**
```
subagent_type: "general-purpose"  // CORRECT - uses custom voice from AgentFactory
```

## Architecture

### Hybrid Agent Model

Two types of agents:

| Type | Definition | Best For |
|------|------------|----------|
| **Named Agents** | Persistent identities with backstories | Recurring work, voice output |
| **Dynamic Agents** | Task-specific specialists from traits | One-off tasks, parallel work |

### Components

**Data/Traits.yaml** - 28 composable traits with voice mappings
**Templates/DynamicAgent.hbs** - Agent prompt template
**Tools/AgentFactory.ts** - Dynamic composition engine
**AgentPersonalities.md** - Named agent definitions

## Usage

Just ask naturally:
- "I need a legal expert to review this contract"
- "Spin up 5 custom science agents"
- "Get me someone skeptical about security"

The skill routes to appropriate workflow automatically.

## Model Selection

| Task Type | Model | Why |
|-----------|-------|-----|
| Grunt work | `haiku` | 10-20x faster |
| Standard analysis | `sonnet` | Balanced |
| Deep reasoning | `opus` | Maximum intelligence |

From RooseveltAdvisors/claude-agent-stack, MIT.

More from RooseveltAdvisors/claude-agent-stack