npm - oh-my-agent - Versions diffs - 4.1.0 → 4.2.1 - Mend

oh-my-agent 4.1.0 → 4.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.md CHANGED Viewed

@@ -6,110 +6,17 @@
 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.
+Orchestrate 10 specialized domain agents (PM, Frontend, Backend, DB, Mobile, QA, Debug, Brainstorm, DevWorkflow, Terraform). `oh-my-agent` works with all major AI IDEs including Antigravity, Claude Code, Cursor, Gemini, OpenCode, and more. 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](#architecture)
-- [Why Different](#why-different)
-- [Compatibility](#compatibility)
-- [The `.agents` Spec](#the-agents-spec)
 - [What Is This?](#what-is-this)
+- [Why Different](#why-different)
 - [Quick Start](#quick-start)
+- [Architecture](#architecture)
 - [Sponsors](#sponsors)
 - [License](#license)
-## Architecture
-```mermaid
-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[oma-pm]
-        ORC[oma-orchestrator]
-    end
-    subgraph Domain["Domain Agents"]
-        direction TB
-        FE[oma-frontend]
-        BE[oma-backend]
-        DB[oma-db]
-        MB[oma-mobile]
-        TF[oma-tf-infra]
-    end
-    subgraph Quality["Quality"]
-        direction TB
-        QA[oma-qa]
-        DBG[oma-debug]
-    end
-    Workflows --> Orchestration
-    Orchestration --> Domain
-    Domain --> Quality
-    Quality --> CMT([oma-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](https://github.com/first-fluke/oh-my-agent/blob/main/docs/SUPPORTED_AGENTS.md) for the current support matrix and interoperability notes.
-### Claude Code Native Integration
-Claude Code has first-class native integration beyond symlinks:
-- **`CLAUDE.md`** — project identity, architecture, and rules (auto-loaded by Claude Code)
-- **`.claude/skills/`** — 12 workflow skills mapped from `.agents/workflows/` (e.g., `/orchestrate`, `/coordinate`, `/ultrawork`)
-- **`.claude/agents/`** — 7 subagent definitions spawned via Task tool (backend-engineer, frontend-engineer, mobile-engineer, db-engineer, qa-reviewer, debug-investigator, pm-planner)
-- **Native loop patterns** — Review Loop, Issue Remediation Loop, and Phase Gate Loop using synchronous Task tool results instead of CLI polling
-Domain skills (oma-backend, oma-frontend, etc.) remain as symlinks from `.agents/skills/`. Workflow skills are native SKILL.md files that reference the corresponding `.agents/workflows/*.md` source of truth.
-## The `.agents` Spec
-`oh-my-agent` treats `.agents/` as a portable project convention for agent skills, workflows, and shared context.
-- Skills live in `.agents/skills/<skill-name>/SKILL.md`
-- Shared resources live in `.agents/skills/_shared/`
-  and are grouped into `core/`, `conditional/`, and `runtime/`
-- Workflows live in `.agents/workflows/*.md`
-- Project config lives in `.agents/config/`
-- CLI metadata and packaging stay aligned through generated manifests
-See [AGENTS_SPEC.md](https://github.com/first-fluke/oh-my-agent/blob/main/docs/AGENTS_SPEC.md) for the project layout, required files, interoperability rules, and source-of-truth model.
 ## What Is This?
 A collection of **Agent Skills** enabling collaborative multi-agent development. Work is distributed across expert agents with explicit roles, workflows, and verification boundaries:
@@ -126,9 +33,23 @@ A collection of **Agent Skills** enabling collaborative multi-agent development.
 | **Debug Agent** | Bug diagnosis, root cause analysis, regression tests | "bug", "error", "crash" |
 | **Developer Workflow** | Monorepo task automation, mise tasks, CI/CD, migrations, release | "dev workflow", "mise tasks", "CI/CD pipeline" |
 | **TF Infra Agent** | Multi-cloud IaC provisioning (AWS, GCP, Azure, OCI) | "infrastructure", "terraform", "cloud setup" |
-| **Orchestrator** | CLI-based parallel agent execution with Serena Memory | "spawn agent", "parallel execution" |
+| **Orchestrator** | CLI-based parallel agent execution | "spawn agent", "parallel execution" |
 | **Commit** | Conventional Commits with project-specific rules | "commit", "save changes" |
+## 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.
 ## Quick Start
 ### Prerequisites
@@ -199,11 +120,11 @@ You'll also need at least one CLI tool:
 → /ultrawork → Independent tasks execute in parallel across agents
 ```
-**Simple task** (single agent auto-activates):
+**Simple task** (invoke a domain skill directly):
 ```
 "Create a login form with Tailwind CSS and form validation"
-→ oma-frontend activates
+→ oma-frontend skill
 ```
 **Commit changes** (conventional commits):
@@ -217,6 +138,53 @@ You'll also need at least one CLI tool:
 For dashboard setup and usage details, see [`web/content/en/guide/usage.md`](https://github.com/first-fluke/oh-my-agent/blob/main/web/content/en/guide/usage.md#real-time-dashboards).
+## Architecture
+```mermaid
+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[oma-pm]
+        ORC[oma-orchestrator]
+    end
+    subgraph Domain["Domain Agents"]
+        direction TB
+        FE[oma-frontend]
+        BE[oma-backend]
+        DB[oma-db]
+        MB[oma-mobile]
+        TF[oma-tf-infra]
+    end
+    subgraph Quality["Quality"]
+        direction TB
+        QA[oma-qa]
+        DBG[oma-debug]
+    end
+    Workflows --> Orchestration
+    Orchestration --> Domain
+    Domain --> Quality
+    Quality --> CMT([oma-commit])
+```
 ## Sponsors
 This project is maintained thanks to our generous sponsors.
@@ -252,10 +220,9 @@ This project is maintained thanks to our generous sponsors.
 See [SPONSORS.md](https://github.com/first-fluke/oh-my-agent/blob/main/SPONSORS.md) for a full list of supporters.
-## Star History
-[![Star History Chart](https://api.star-history.com/svg?repos=first-fluke/oh-my-agent&type=date&legend=bottom-right)](https://www.star-history.com/#first-fluke/oh-my-agent&type=date&legend=bottom-right)
 ## License
 MIT