# Agent Tiers

This file defines practical tier guidance for Omagy agent routing.

## Mental Model

Omagy separates three concepts:

- `role`: what the agent is responsible for (`implementer`, `planner`, `architect`)
- `tier`: how much reasoning/cost to spend (`LOW`, `STANDARD`, `THOROUGH`)
- `posture`: how the role behaves (`frontier-orchestrator`, `deep-worker`, `fast-lane`)

Use role to choose responsibility, tier to choose depth, and posture to choose
operating style.

## Tiers

- `LOW`:
  Fast lookups and narrow checks.
  Use for simple exploration, style checks, and lightweight docs edits.
  Typical roles: `explorer`, `librarian`.

- `STANDARD`:
  Default tier for implementation, debugging, and normal verification.
  Typical roles: `implementer`, `verifier`, `quality-reviewer`.

- `THOROUGH`:
  Use for architectural, security-sensitive, or high-impact multi-file work.
  Typical roles: `architect`, `analyst`, `critic`, `security-reviewer`,
  `implementer`.

## Selection Rules

1. Start at `STANDARD` for most code changes.
2. Use `LOW` only when the task is bounded and non-invasive.
3. Escalate to `THOROUGH` for:
   - security/auth/trust-boundary changes
   - architectural decisions with system-wide impact
   - large refactors across many files
4. For Ralph completion checks, use at least `STANDARD` architect verification.

## Posture Guidance

- `frontier-orchestrator`:
  - Best for steerable frontier models and leader-style roles.
  - Prioritizes intent classification, delegation, verification, and
    architectural judgment.
  - Typical roles: `planner`, `analyst`, `architect`, `critic`,
    `code-reviewer`.

- `deep-worker`:
  - Best for implementation-heavy roles that should carry work to completion.
  - Prioritizes direct execution, minimal diffs, and strict verification.
  - Typical roles: `implementer`, `verifier`, `quality-reviewer`,
    `security-reviewer`.

- `fast-lane`:
  - Best for cheap/fast models used for triage, search, and narrow synthesis.
  - Prioritizes quick routing, concise search, and escalation over deep
    autonomous work.
  - Typical roles: `explorer`, `librarian`.