oh-my-agent 2.4.2 → 2.6.0

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
  1. package/README.md +26 -24
  2. package/bin/cli.js +285 -270
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -27,17 +27,17 @@ flowchart TD
27
27
  direction TB
28
28
  W0["/brainstorm"]
29
29
  W1["/coordinate"]
30
- W1b["/coordinate-pro"]
30
+ W1b["/ultrawork"]
31
31
  W2["/orchestrate"]
32
32
  W3["/plan"]
33
33
  W4["/review"]
34
34
  W5["/debug"]
35
+ W6["/deepinit"]
35
36
  end
36
37
 
37
38
  subgraph Orchestration["Orchestration"]
38
39
  direction TB
39
40
  PM[pm-agent]
40
- WF[workflow-guide]
41
41
  ORC[orchestrator]
42
42
  end
43
43
 
@@ -77,7 +77,7 @@ flowchart TD
77
77
  | Tool / IDE | Skills Source | Interop Mode | Notes |
78
78
  |------------|---------------|--------------|-------|
79
79
  | Antigravity | `.agents/skills/` | Native | Primary source-of-truth layout |
80
- | Claude Code | `.claude/skills/` | Symlink to `.agents/skills/` | Managed by installer |
80
+ | Claude Code | `.claude/skills/` + `.claude/agents/` | Native + Adapter | Symlinks for domain skills + native workflow skills, subagents, and CLAUDE.md |
81
81
  | OpenCode | `.agents/skills/` | Native-compatible | Uses the same project-level skill source |
82
82
  | Amp | `.agents/skills/` | Native-compatible | Shares the same project-level source |
83
83
  | Codex CLI | `.agents/skills/` | Native-compatible | Works from the same project skill source |
@@ -86,6 +86,17 @@ flowchart TD
86
86
 
87
87
  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.
88
88
 
89
+ ### Claude Code Native Integration
90
+
91
+ Claude Code has first-class native integration beyond symlinks:
92
+
93
+ - **`CLAUDE.md`** — project identity, architecture, and rules (auto-loaded by Claude Code)
94
+ - **`.claude/skills/`** — 12 workflow skills mapped from `.agents/workflows/` (e.g., `/orchestrate`, `/coordinate`, `/ultrawork`)
95
+ - **`.claude/agents/`** — 7 subagent definitions spawned via Task tool (backend-impl, frontend-impl, mobile-impl, db-impl, qa-reviewer, debug-investigator, pm-planner)
96
+ - **Native loop patterns** — Review Loop, Issue Remediation Loop, and Phase Gate Loop using synchronous Task tool results instead of CLI polling
97
+
98
+ Domain skills (backend-agent, frontend-agent, etc.) remain as symlinks from `.agents/skills/`. Workflow skills are native SKILL.md files that reference the corresponding `.agents/workflows/*.md` source of truth.
99
+
89
100
  ## The `.agents` Spec
90
101
 
91
102
  `oh-my-agent` treats `.agents/` as a portable project convention for agent skills, workflows, and shared context.
@@ -105,7 +116,6 @@ A collection of **Agent Skills** enabling collaborative multi-agent development.
105
116
  | Agent | Specialization | Triggers |
106
117
  |-------|---------------|----------|
107
118
  | **Brainstorm** | Design-first ideation before planning | "brainstorm", "ideate", "explore idea" |
108
- | **Workflow Guide** | Coordinates complex multi-agent projects | "multi-domain", "complex project" |
109
119
  | **PM Agent** | Requirements analysis, task decomposition, architecture | "plan", "break down", "what should we build" |
110
120
  | **Frontend Agent** | React/Next.js, TypeScript, Tailwind CSS | "UI", "component", "styling" |
111
121
  | **Backend Agent** | FastAPI, PostgreSQL, JWT authentication | "API", "database", "authentication" |
@@ -123,10 +133,16 @@ A collection of **Agent Skills** enabling collaborative multi-agent development.
123
133
  ### Prerequisites
124
134
 
125
135
  - **AI IDE** (Antigravity, Claude Code, Codex, Gemini, etc.)
126
- - **Bun** (for CLI and dashboards)
127
- - **uv** (for Serena setup)
128
136
 
129
- ### Option 1: Interactive CLI (Recommended)
137
+ ### Option 1: One-Line Install (Recommended)
138
+
139
+ ```bash
140
+ curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash
141
+ ```
142
+
143
+ Automatically detects and installs missing dependencies (bun, uv), then launches the interactive setup.
144
+
145
+ ### Option 2: Manual Install
130
146
 
131
147
  ```bash
132
148
  # Install bun if you don't have it:
@@ -149,7 +165,7 @@ Select your project type and skills will be installed to `.agents/skills/`, with
149
165
  | 📱 Mobile | brainstorm, mobile, pm, qa, debug, commit |
150
166
  | 🚀 DevOps | brainstorm, tf-infra, dev-workflow, pm, qa, debug, commit |
151
167
 
152
- ### Option 2: Global Installation (For Orchestrator)
168
+ ### Option 3: Global Installation (For Orchestrator)
153
169
 
154
170
  To use the core tools globally or run the SubAgent Orchestrator:
155
171
 
@@ -166,20 +182,6 @@ You'll also need at least one CLI tool:
166
182
  | Codex | `bun install --global @openai/codex` | `codex auth` |
167
183
  | Qwen | `bun install --global @qwen-code/qwen` | `qwen auth` |
168
184
 
169
- ### Option 3: Integrate into Existing Project
170
-
171
- **Recommended (CLI):**
172
-
173
- Run the following command in your project root to automatically install/update skills and workflows:
174
-
175
- ```bash
176
- bunx oh-my-agent
177
- ```
178
-
179
- > **Tip:** Run `bunx oh-my-agent doctor` after installation to verify everything is set up correctly (including global workflows).
180
-
181
-
182
-
183
185
  ### 2. Chat
184
186
 
185
187
  **Explicit coordination** (user-triggered workflow):
@@ -189,11 +191,11 @@ bunx oh-my-agent
189
191
  → Step-by-step: PM planning → agent spawning → QA review
190
192
  ```
191
193
 
192
- **Complex project** (workflow-guide coordinates):
194
+ **Complex project** (/coordinate workflow)::
193
195
 
194
196
  ```
195
197
  "Build a TODO app with user authentication"
196
- workflow-guide → PM Agent plans → agents spawned in Agent Manager
198
+ /coordinate → PM Agent plans → agents spawned in Agent Manager
197
199
  ```
198
200
 
199
201
  **Simple task** (single agent auto-activates):