agents/

agents/

Purpose

Subagent definitions for the OmO multi-agent orchestration system. Each .md file defines one agent with frontmatter metadata and behavioral instructions.

Frontmatter Schema

All agent files use YAML frontmatter with these fields:

• name — Agent identifier (used in subagent_type parameter)
• description — One-line role description
• tools — Comma-separated list of allowed tools
• model — LLM model tier: opus (complex), sonnet (balanced), haiku (fast)
• color — Display color for status output

Agent Roster

Execution Agents

• sisyphus-junior.md — Focused task executor. Receives 6-section delegation prompts, cannot delegate further. Uses sonnet.
• hephaestus.md — Senior Staff Engineer. Autonomous end-to-end worker (explore→plan→implement→verify). Uses opus.

Planning Agents

• prometheus.md — Strategic planner. Creates plans via interview→research→draft→gap analysis. Writes to .claude/omo/plans/. Uses opus.
• metis.md — Gap analyzer. Read-only. Detects hidden requirements, AI-slop patterns, ambiguities in plans. Uses sonnet.
• momus.md — Plan validator. Approval-biased (80% clear = approve). Checks executability. Uses sonnet.

Orchestration

• atlas.md — Task conductor. Delegates to sisyphus-junior, verifies every result, never codes directly. Uses sonnet.
• briareus.md — Team conductor. Spawns parallel workers (sisyphus-junior or hephaestus), verifies integration across waves. Uses sonnet.

Advisory / Research

• oracle.md — Architecture consultant. Read-only. Called on failure recovery or complex decisions. Uses opus.
• librarian.md — Documentation/code search. Parallel searches across codebase, GitHub, web, library docs. Uses sonnet.
• explorer.md — Fast codebase grep. Read-only (Read/Glob/Grep only). Uses haiku.

Conventions

• Execution agents (sisyphus-junior, hephaestus) have Write/Edit tools
• Read-only agents (explorer, metis, momus, oracle) have no write tools
• All agents follow the 6-section delegation format: TASK, EXPECTED OUTCOME, REQUIRED TOOLS, MUST DO, MUST NOT DO, CONTEXT
• Model selection follows complexity: haiku for fast search, sonnet for standard work, opus for complex reasoning

Dependencies

• All execution agents reference scripts/diagnostics.sh for verification
• Atlas delegates to sisyphus-junior exclusively
• Prometheus writes to .claude/omo/plans/ and .claude/omo/drafts/
• Atlas reads plans and writes to .claude/omo/notepads/
• Briareus delegates to sisyphus-junior and hephaestus, verifies results, stores learnings in notepads