oh-my-opencode/src/agents/AGENTS.md

AGENTS KNOWLEDGE BASE

OVERVIEW

11 AI agents for multi-model orchestration. Each agent has factory function + metadata + fallback chains.

Primary Agents (respect UI model selection):

• Sisyphus, Atlas, Prometheus

Subagents (use own fallback chains):

• Hephaestus, Oracle, Librarian, Explore, Multimodal-Looker, Metis, Momus, Sisyphus-Junior

STRUCTURE

agents/
├── atlas/                      # Master Orchestrator (holds todo list)
│   ├── index.ts
│   ├── default.ts
│   ├── gpt.ts
│   └── utils.ts
├── sisyphus.ts                 # Main prompt (SF Bay Area engineer identity)
├── hephaestus.ts               # Autonomous Deep Worker (GPT 5.2 Codex, "The Legitimate Craftsman")
├── sisyphus-junior/            # Delegated task executor (category-spawned)
│   ├── index.ts
│   ├── default.ts
│   └── gpt.ts
├── oracle.ts                   # Strategic advisor (GPT-5.2)
├── librarian.ts                # Multi-repo research (GitHub CLI, Context7)
├── explore.ts                  # Fast contextual grep (Grok Code Fast)
├── multimodal-looker.ts        # Media analyzer (Gemini 3 Flash)
├── prometheus/                 # Planning (Interview/Consultant mode)
│   ├── index.ts
│   ├── plan-template.ts
│   ├── interview-mode.ts
│   ├── plan-generation.ts
│   ├── high-accuracy-mode.ts
│   ├── identity-constraints.ts
│   └── behavioral-summary.ts
├── metis.ts                    # Pre-planning analysis (Gap detection)
├── momus.ts                    # Plan reviewer (Ruthless fault-finding)
├── dynamic-agent-prompt-builder.ts  # Dynamic prompt generation
├── types.ts                    # AgentModelConfig, AgentPromptMetadata
├── utils.ts                    # createBuiltinAgents(), resolveModelWithFallback()
└── index.ts                    # builtinAgents export

AGENT MODELS

Agent	Model	Temp	Purpose
Sisyphus	anthropic/claude-opus-4-6	0.1	Primary orchestrator (fallback: kimi-k2.5 → glm-4.7 → gpt-5.3-codex → gemini-3-pro)
Hephaestus	openai/gpt-5.3-codex	0.1	Autonomous deep worker, "The Legitimate Craftsman" (requires gpt-5.3-codex, no fallback)
Atlas	anthropic/claude-sonnet-4-5	0.1	Master orchestrator (fallback: kimi-k2.5 → gpt-5.2)
oracle	openai/gpt-5.2	0.1	Consultation, debugging
librarian	zai-coding-plan/glm-4.7	0.1	Docs, GitHub search (fallback: glm-4.7-free)
explore	xai/grok-code-fast-1	0.1	Fast contextual grep (fallback: claude-haiku-4-5 → gpt-5-mini → gpt-5-nano)
multimodal-looker	google/gemini-3-flash	0.1	PDF/image analysis
Prometheus	anthropic/claude-opus-4-6	0.1	Strategic planning (fallback: kimi-k2.5 → gpt-5.2)
Metis	anthropic/claude-opus-4-6	0.3	Pre-planning analysis (fallback: kimi-k2.5 → gpt-5.2)
Momus	openai/gpt-5.2	0.1	Plan validation (fallback: claude-opus-4-6)
Sisyphus-Junior	anthropic/claude-sonnet-4-5	0.1	Category-spawned executor

HOW TO ADD

1. Create src/agents/my-agent.ts exporting factory + metadata.
2. Add to agentSources in src/agents/utils.ts.
3. Update AgentNameSchema in src/config/schema.ts.
4. Register in src/index.ts initialization.

TOOL RESTRICTIONS

Agent	Denied Tools
oracle	write, edit, task, delegate_task
librarian	write, edit, task, delegate_task, call_omo_agent
explore	write, edit, task, delegate_task, call_omo_agent
multimodal-looker	Allowlist: read only
Sisyphus-Junior	task, delegate_task

PATTERNS

• Factory: createXXXAgent(model: string): AgentConfig
• Metadata: XXX_PROMPT_METADATA with category, cost, triggers.
• Tool restrictions: createAgentToolRestrictions(tools) or createAgentToolAllowlist(tools).
• Thinking: 32k budget tokens for Sisyphus, Oracle, Prometheus, Atlas.

ANTI-PATTERNS

• Trust reports: NEVER trust "I'm done" - verify outputs.
• High temp: Don't use >0.3 for code agents.
• Sequential calls: Use delegate_task with run_in_background for exploration.
• Prometheus writing code: Planner only - never implements.