agent-catalog

Files (1)

• SKILL.md

SKILL.md (first lines)

## omg Agent Catalog

Use this catalog to decide which agent to spawn for a task. All agents are invoked via the `task` tool:

```
task(agent_type="omg:<name>", prompt="<task>", model="<model>", mode="background|sync")

# With effort control (Copilot CLI --effort flag):
copilot -p "<task>" --agent omg:<name> --effort <low|medium|high|xhigh> --yolo
```

### READ-ONLY Enforcement

READ-ONLY agents should be spawned with `--excluded-tools` to physically prevent file modifications:

```
# When spawning via copilot CLI (automation/CI):
copilot -p "..." --agent omg:architect --excluded-tools edit,create --yolo

# The task() tool does not support --excluded-tools directly,
# but the agent prompt enforces read-only behavior.
# For maximum security in CI, use copilot CLI with --excluded-tools.
```

### Orchestrators (9) — coordinate specialists, do NOT implement directly

| Agent | task() name | Purpose | Mode |
|-------|------------|---------|------|
| **autopilot** | `omg:autopilot` | Full lifecycle: idea → working verified code. Delegates to specialists. | sync |
| **ralph** | `omg:ralph` | Persistence loop — keeps iterating until all acceptance criteria pass. | sync |
| **team** | `omg:team` | Decomposes task, fires N parallel workers, verifies combined result. | sync |
| **ralplan** | `omg:ralplan` | Consensus planning: planner → architect → critic loop until agreement. | sync |
| **ultrawork** | `omg:ultrawork` | Parallel fire-and-forget — launches independent tasks simultaneously. | sync |
| **research-to-pr** | `omg:research-to-pr` | Deep investigation → /delegate → cloud agent creates PR. Copilot-exclusive. | sync |
| **sciomc** | `omg:sciomc` | Staged parallel research with tiered scientist agents. | sync |
| **self-improve** | `omg:self-improve` | Autonomous optimization: benchmark, tournament-select best approach. | sync |
| **deep-dive** | `omg:deep-dive` | Two-stage: trace root cause → crystallize into actionable spec. | sync |

### Deep Reasoning (opus-class)

| Agent | task() name | Purpose | Mode |
|-------|------------|---------|------|
| **architect** | `omg:architect` | Code analysis, root-cause diagnosis, architectural recommendations. READ-ONLY. | sync |
| **critic** | `omg:critic` | Final quality gate — multi-perspective review with severity ratings. READ-ONLY. | sync |
| **analyst** | `omg:analyst` | Requirements analysis — catches gaps, edge cases, undefined guardrails. READ-ONLY. | sync |
| **code-reviewer** | `omg:code-reviewer` | Severity-rated code review — spec compliance, security, SOLID, logic. READ-ONLY. | sync |
| **security-reviewer** | `omg:security-reviewer` | OWASP Top 10, secrets scanning, dependency audits. READ-ONLY. | sync |
| **code-simplifier** | `omg:code-simplifier` | Simplifies code for clarity without changing behavior. | sync |

### Balanced (sonnet-class)

| Agent | task() name | Purpose | Mode |
|-------|------------|---------|------|
| **executor** | `omg:executor` | Implements code changes — smallest viable diff, verified. | background |
| **debugger** | `omg:debugger` | Root-cause analysis, minimal fixes, build error resolution. | sync |
| **verifier** | `omg:verifier` | Evidence-based completion checks — fresh test output, PASS/FAIL. | sync |
| **test-engineer** | `omg:test-engineer` | Test strategy, TDD, flaky test hardening. | background |
| **designer** | `omg:designer` | UI/UX — stunning, production-grade interfaces. | background |
| **git-master** | `omg:git-master` | Atomic commits, style-matched messages, safe rebasing. | sync |
| **qa-tester** | `omg:qa-tester` | Interactive CLI testing via tmux sessions. | sync |
| **scientist** | `omg:scientist` | Data analysis with statistical rigor. READ-ONLY. | sync |
| **tracer** | `omg:tracer` | Evidence-driven causal tracing with competing hypotheses. READ-ONLY. | sync |
| **document-specialist** | `omg:document-specialist` | External docs, API references, version compatibility. READ-ONLY. | background |

### Fast (haiku-class)

| Agent | task() name | Purpose | Mode |
|-------|------------|---------|------|
| **explore** | `omg:explore` | Fast codebase search — finds files, patterns, relationships. READ-ONLY. | background |
| **writer** | `omg:writer` | Technical documentation with verified code examples. | background |

## Delegation Decision Tree

```
Full lifecycle from idea to code?
  → omg:autopilot (sonnet, sync)

Must complete with proof?
  → omg:ralph (sonnet, sync)

Multiple independent subtasks?
  → omg:team (sonnet, sync)

Need consensus plan?
  → omg:ralplan (opus, sync)

Investigate → auto PR?
  → omg:research-to-pr (sonnet, sync)

Need to find files/patterns?
  → omg:explore (haiku, background)

Need to understand architecture?
  → omg:architect (opus, sync)

Need to implement code?
  → omg:executor (sonnet, background)

Need to fix a bug?
  → omg:debugger (sonnet, sync)

Need to verify work is done?
  → omg:verifier (sonnet, sync)

Need a code review?
  → omg:code-reviewer (opus, sync)

Need a security audit?
  → omg:security-reviewer (opus, sync)

Need to plan before coding?
  → omg:analyst (opus, sync) then omg:planner (opus, sync)

Need a quality gate on a plan?
  → omg:critic (opus, sync)

Need tests written?
  → omg:test-engineer (sonnet, background)

From TheTrustedAdvisor/omg, MIT.

More from TheTrustedAdvisor/omg