oma

oh-my-agent: Portable Multi-Agent Harness

한국어 | 中文 | Português | 日本語 | Français | Español | Nederlands | Polski | Русский | Deutsch

The portable, role-based agent harness for serious AI-assisted engineering.

Orchestrate 10 specialized domain agents (PM, Frontend, Backend, DB, Mobile, QA, Debug, Brainstorm, DevWorkflow, Terraform) via Serena Memory. oh-my-agent uses .agents/ as the source of truth for portable skills and workflows, then projects compatibility to other AI IDEs and CLIs. It combines role-based agents, explicit workflows, real-time observability, and standards-aware guidance for teams that want less AI slop and more disciplined execution.

Table of Contents

• Architecture
• Why Different
• Compatibility
• The .agents Spec
• What Is This?
• Quick Start
• Sponsors
• License

Architecture

flowchart TD
    subgraph Workflows["Workflows"]
        direction TB
        W0["/brainstorm"]
        W1["/coordinate"]
        W1b["/ultrawork"]
        W2["/orchestrate"]
        W3["/plan"]
        W4["/review"]
        W5["/debug"]
        W6["/deepinit"]
    end

    subgraph Orchestration["Orchestration"]
        direction TB
        PM[pm-agent]
        ORC[orchestrator]
    end

    subgraph Domain["Domain Agents"]
        direction TB
        FE[frontend-agent]
        BE[backend-agent]
        DB[db-agent]
        MB[mobile-agent]
        TF[tf-infra-agent]
    end

    subgraph Quality["Quality"]
        direction TB
        QA[qa-agent]
        DBG[debug-agent]
    end

    Workflows --> Orchestration
    Orchestration --> Domain
    Domain --> Quality
    Quality --> CMT([commit])

Why Different

• .agents/ is the source of truth: skills, workflows, shared resources, and config live in one portable project structure instead of being trapped inside one IDE plugin.
• Role-shaped agent teams: PM, QA, DB, Infra, Frontend, Backend, Mobile, Debug, and Workflow agents are modeled like an engineering org, not just a pile of prompts.
• Workflow-first orchestration: planning, review, debug, and coordinated execution are first-class workflows, not afterthoughts.
• Standards-aware by design: agents now carry focused guidance for ISO-driven planning, QA, database continuity/security, and infrastructure governance.
• Built for verification: dashboards, manifest generation, shared execution protocols, and structured outputs favor traceability over vibe-only generation.

Compatibility

oh-my-agent is designed around .agents/ and then bridges to other tool-specific skill folders when needed.

Tool / IDE	Skills Source	Interop Mode	Notes
Antigravity	.agents/skills/	Native	Primary source-of-truth layout
Claude Code	.claude/skills/ + .claude/agents/	Native + Adapter	Symlinks for domain skills + native workflow skills, subagents, and CLAUDE.md
OpenCode	.agents/skills/	Native-compatible	Uses the same project-level skill source
Amp	.agents/skills/	Native-compatible	Shares the same project-level source
Codex CLI	.agents/skills/	Native-compatible	Works from the same project skill source
Cursor	.agents/skills/	Native-compatible	Can consume the same project-level skill source
GitHub Copilot	.github/skills/	Optional symlink	Installed when selected during setup

See SUPPORTED_AGENTS.md for the current support matrix and interoperability notes.

Claude Code Native Integration

Claude Code has first-class native integration beyond symlinks: