oh-my-agent 2.2.0 → 2.4.0

package/README.md

@@ -0,0 +1,219 @@
+# oh-my-agent: Multi-Agent Harness
+
+[![npm version](https://img.shields.io/npm/v/oh-my-agent?color=cb3837&logo=npm)](https://www.npmjs.com/package/oh-my-agent) [![npm downloads](https://img.shields.io/npm/dm/oh-my-agent?color=cb3837&logo=npm)](https://www.npmjs.com/package/oh-my-agent) [![GitHub stars](https://img.shields.io/github/stars/first-fluke/oh-my-agent?style=flat&logo=github)](https://github.com/first-fluke/oh-my-agent) [![License](https://img.shields.io/github/license/first-fluke/oh-my-agent)](https://github.com/first-fluke/oh-my-agent/blob/main/LICENSE) [![Last Updated](https://img.shields.io/github/last-commit/first-fluke/oh-my-agent?label=updated&logo=git)](https://github.com/first-fluke/oh-my-agent/commits/main)
+
+[한국어](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.ko.md) | [中文](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.zh.md) | [Português](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.pt.md) | [日本語](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.ja.md) | [Français](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.fr.md) | [Español](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.es.md) | [Nederlands](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.nl.md) | [Polski](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.pl.md) | [Українська](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.uk.md) | [Русский](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.ru.md) | [Deutsch](https://github.com/first-fluke/oh-my-agent/blob/main/docs/README.de.md)
+
+The Ultimate Agent Orchestrator for agentic coding.
+
+Orchestrate 10 specialized domain agents (PM, Frontend, Backend, DB, Mobile, QA, Debug, Brainstorm, DevWorkflow, Terraform) via **Serena Memory**. Features parallel CLI execution, real-time observability dashboards, and zero-config progressive skill loading. The batteries-included solution for agentic coding.
+
+## Table of Contents
+
+- [Architecture](#architecture)
+- [What Is This?](#what-is-this)
+- [Quick Start](#quick-start)
+- [Sponsors](#sponsors)
+- [License](#license)
+
+## Architecture
+
+```mermaid
+flowchart TD
+    subgraph Workflows["Workflows"]
+        direction TB
+        W0["/brainstorm"]
+        W1["/coordinate"]
+        W1b["/coordinate-pro"]
+        W2["/orchestrate"]
+        W3["/plan"]
+        W4["/review"]
+        W5["/debug"]
+    end
+
+    subgraph Orchestration["Orchestration"]
+        direction TB
+        PM[pm-agent]
+        WF[workflow-guide]
+        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])
+```
+
+## What Is This?
+
+A collection of **Agent Skills** enabling collaborative multi-agent development. Work is distributed across expert agents:
+
+| Agent | Specialization | Triggers |
+|-------|---------------|----------|
+| **Brainstorm** | Design-first ideation before planning | "brainstorm", "ideate", "explore idea" |
+| **Workflow Guide** | Coordinates complex multi-agent projects | "multi-domain", "complex project" |
+| **PM Agent** | Requirements analysis, task decomposition, architecture | "plan", "break down", "what should we build" |
+| **Frontend Agent** | React/Next.js, TypeScript, Tailwind CSS | "UI", "component", "styling" |
+| **Backend Agent** | FastAPI, PostgreSQL, JWT authentication | "API", "database", "authentication" |
+| **DB Agent** | SQL/NoSQL modeling, normalization, integrity, backup, capacity | "ERD", "schema", "database design", "index tuning" |
+| **Mobile Agent** | Flutter cross-platform development | "mobile app", "iOS/Android" |
+| **QA Agent** | OWASP Top 10 security, performance, accessibility | "review security", "audit", "check performance" |
+| **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" |
+| **Commit** | Conventional Commits with project-specific rules | "commit", "save changes" |
+
+## Quick Start
+
+### Prerequisites
+
+- **AI IDE** (Antigravity, Claude Code, Codex, Gemini, etc.)
+- **Bun** (for CLI and dashboards)
+- **uv** (for Serena setup)
+
+### Option 1: Interactive CLI (Recommended)
+
+```bash
+# Install bun if you don't have it:
+# curl -fsSL https://bun.sh/install | bash
+
+# Install uv if you don't have it:
+# curl -LsSf https://astral.sh/uv/install.sh | sh
+
+bunx oh-my-agent
+```
+
+Select your project type and skills will be installed to `.agents/skills/`, with compatibility symlinks created under `.agents/skills/` and `.claude/skills/`.
+
+| Preset | Skills |
+|--------|--------|
+| ✨ All | Everything |
+| 🌐 Fullstack | brainstorm, frontend, backend, db, pm, qa, debug, commit |
+| 🎨 Frontend | brainstorm, frontend, pm, qa, debug, commit |
+| ⚙️ Backend | brainstorm, backend, db, pm, qa, debug, commit |
+| 📱 Mobile | brainstorm, mobile, pm, qa, debug, commit |
+| 🚀 DevOps | brainstorm, tf-infra, dev-workflow, pm, qa, debug, commit |
+
+### Option 2: Global Installation (For Orchestrator)
+
+To use the core tools globally or run the SubAgent Orchestrator:
+
+```bash
+bun install --global oh-my-agent
+```
+
+You'll also need at least one CLI tool:
+
+| CLI | Install | Auth |
+|-----|---------|------|
+| Gemini | `bun install --global @google/gemini-cli` | `gemini auth` |
+| Claude | `curl -fsSL https://claude.ai/install.sh \| bash` | `claude auth` |
+| Codex | `bun install --global @openai/codex` | `codex auth` |
+| Qwen | `bun install --global @qwen-code/qwen` | `qwen auth` |
+
+### Option 3: Integrate into Existing Project
+
+**Recommended (CLI):**
+
+Run the following command in your project root to automatically install/update skills and workflows:
+
+```bash
+bunx oh-my-agent
+```
+
+> **Tip:** Run `bunx oh-my-agent doctor` after installation to verify everything is set up correctly (including global workflows).
+
+
+
+### 2. Chat
+
+**Explicit coordination** (user-triggered workflow):
+
+```
+/coordinate
+→ Step-by-step: PM planning → agent spawning → QA review
+```
+
+**Complex project** (workflow-guide coordinates):
+
+```
+"Build a TODO app with user authentication"
+→ workflow-guide → PM Agent plans → agents spawned in Agent Manager
+```
+
+**Simple task** (single agent auto-activates):
+
+```
+"Create a login form with Tailwind CSS and form validation"
+→ frontend-agent activates
+```
+
+**Commit changes** (conventional commits):
+
+```
+/commit
+→ Analyze changes, suggest commit type/scope, create commit with Co-Author
+```
+
+### 3. Monitor with Dashboards
+
+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).
+
+## Sponsors
+
+This project is maintained thanks to our generous sponsors.
+
+> **Like this project?** Give it a star!
+>
+> ```bash
+> gh api --method PUT /user/starred/first-fluke/oh-my-agent
+> ```
+>
+> Try our optimized starter template: [fullstack-starter](https://github.com/first-fluke/fullstack-starter)
+
+<a href="https://github.com/sponsors/first-fluke">
+  <img src="https://img.shields.io/badge/Sponsor-♥-ea4aaa?style=for-the-badge" alt="Sponsor" />
+</a>
+<a href="https://buymeacoffee.com/firstfluke">
+  <img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-☕-FFDD00?style=for-the-badge" alt="Buy Me a Coffee" />
+</a>
+
+### 🚀 Champion
+
+<!-- Champion tier ($100/mo) logos here -->
+
+### 🛸 Booster
+
+<!-- Booster tier ($30/mo) logos here -->
+
+### ☕ Contributor
+
+<!-- Contributor tier ($10/mo) names here -->
+
+[Become a sponsor →](https://github.com/sponsors/first-fluke)
+
+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