Imported from officechbusinessservices-creator/CompliCore (packages/oh-my-claudecode/src/agents/AGENTS.md). Install upstream with npx skills add officechbusinessservices-creator/CompliCore --skill agents. Copyright stays with the author.

agents

18 specialized AI agent definitions with 3-tier model routing for optimal cost and performance.

Purpose

This directory defines all agents available in oh-my-claudecode:

• 18 base agents with default model assignments
• Tiered variants (LOW/MEDIUM/HIGH) for smart routing
• Prompts loaded dynamically from /agents/*.md files
• Tools assigned based on agent specialization

Key Files

For AI Agents

Working In This Directory

Understanding the Agent Registry

The main registry is in definitions.ts:

// Get all 18 agents
const agents = getAgentDefinitions();

// Each agent has:
{
  name: 'architect',
  description: 'Architecture & Debugging Advisor',
  prompt: '...',  // Loaded from /agents/architect.md
  tools: ['Read', 'Glob', 'Grep', 'WebSearch', 'WebFetch'],
  model: 'opus',
  defaultModel: 'opus'
}

Agent Selection Guide

Creating a New Agent

1. Create agent file (e.g., new-agent.ts):

import type { AgentConfig } from '../shared/types.js';

export const newAgent: AgentConfig = {
  name: 'new-agent',
  description: 'What this agent does',
  prompt: '', // Will be loaded from /agents/new-agent.md
  tools: ['Read', 'Glob', 'Grep'],
  model: 'sonnet',
  defaultModel: 'sonnet'
};

2. Create prompt template at /agents/new-agent.md:

---
name: new-agent
description: What this agent does
model: sonnet
tools: [Read, Glob, Grep]
---

# Agent Instructions

You are a specialized agent for...

3. Add to definitions.ts:

import { newAgent } from './new-agent.js';

export function getAgentDefinitions() {
  return {
    // ... existing agents
    'new-agent': newAgent,
  };
}

4. Export from index.ts:

export { newAgent } from './new-agent.js';

Creating Tiered Variants

For model routing, create LOW/MEDIUM/HIGH variants in definitions.ts:

// Haiku variant for simple tasks
export const newAgentLow: AgentConfig = {
  name: 'new-agent-low',
  description: 'Quick new-agent tasks (Haiku)',
  prompt: loadAgentPrompt('new-agent-low'),
  tools: ['Read', 'Glob', 'Grep'],
  model: 'haiku',
  defaultModel: 'haiku'
};

// Opus variant for complex tasks
export const newAgentHigh: AgentConfig = {
  name: 'new-agent-high',
  description: 'Complex new-agent tasks (Opus)',
  prompt: loadAgentPrompt('new-agent-high'),
  tools: ['Read', 'Glob', 'Grep', 'WebSearch'],
  model: 'opus',
  defaultModel: 'opus'
};

Modification Checklist

When Adding a New Agent

1. Create agent file (src/agents/new-agent.ts)
2. Create prompt template (agents/new-agent.md)
3. Add to definitions.ts (import + registry)
4. Export from index.ts
5. Update docs/REFERENCE.md (Agents section, count)
6. Update docs/CLAUDE.md (Agent Selection Guide)
7. Update root /AGENTS.md (Agent Summary if applicable)

When Modifying an Agent

1. Update agent file (src/agents/*.ts) if changing tools/model
2. Update prompt template (agents/*.md) if changing behavior
3. Update tiered variants (-low, -medium, -high) if applicable
4. Update docs/REFERENCE.md if changing agent description/capabilities
5. Update docs/CLAUDE.md (Agent Tool Matrix) if changing tool assignments

When Removing an Agent

1. Remove agent file from src/agents/
2. Remove prompt template from agents/
3. Remove from definitions.ts and index.ts
4. Update agent counts in all documentation
5. Check for skill/hook references to the removed agent

Testing Requirements

Agents are tested via integration tests:

npm test -- --grep "agent"

Common Patterns

Prompt loading:

function loadAgentPrompt(agentName: string): string {
  const agentPath = join(getPackageDir(), 'agents', `${agentName}.md`);
  const content = readFileSync(agentPath, 'utf-8');
  // Strip YAML frontmatter
  const match = content.match(/^---[\s\S]*?---\s*([\s\S]*)$/);
  return match ? match[1].trim() : content.trim();
}

Tool assignment patterns:

• Read-only agents: ['Read', 'Glob', 'Grep']
• Analysis agents: Add ['WebSearch', 'WebFetch']
• Execution agents: Add ['Edit', 'Write', 'Bash', 'TodoWrite']
• Data agents: Add ['python_repl']

Dependencies

Internal

• Prompts from /agents/*.md
• Types from ../shared/types.ts

External

None - pure TypeScript definitions.

Agent Categories