oh-my-ag 1.4.1 → 1.5.1

package/.agent/skills/frontend-agent/resources/component-template.tsx

@@ -5,15 +5,16 @@
  * Follow this structure for consistency.
  */
 
-import { cn } from '@/lib/utils';
+import type { ReactNode } from "react";
+import { cn } from "@/lib/utils";
 
 // 1. Type Definitions
 interface ComponentNameProps {
   className?: string;
-  children: React.ReactNode;
+  children: ReactNode;
   // Add specific props here
-  variant?: 'default' | 'primary' | 'secondary';
-  size?: 'sm' | 'md' | 'lg';
+  variant?: "default" | "primary" | "secondary";
+  size?: "sm" | "md" | "lg";
   onClick?: () => void;
   disabled?: boolean;
 }
@@ -22,8 +23,8 @@ interface ComponentNameProps {
 export function ComponentName({
   className,
   children,
-  variant = 'default',
-  size = 'md',
+  variant = "default",
+  size = "md",
   onClick,
   disabled = false,
 }: ComponentNameProps) {
@@ -42,24 +43,26 @@ export function ComponentName({
   // 6. Computed Values
   const classes = cn(
     // Base styles
-    'inline-flex items-center justify-center rounded-md font-medium transition-colors',
+    "inline-flex items-center justify-center rounded-md font-medium transition-colors",
     // Variants
     {
-      'bg-primary text-primary-foreground hover:bg-primary/90': variant === 'primary',
-      'bg-secondary text-secondary-foreground hover:bg-secondary/80': variant === 'secondary',
-      'bg-background text-foreground hover:bg-accent': variant === 'default',
+      "bg-primary text-primary-foreground hover:bg-primary/90":
+        variant === "primary",
+      "bg-secondary text-secondary-foreground hover:bg-secondary/80":
+        variant === "secondary",
+      "bg-background text-foreground hover:bg-accent": variant === "default",
     },
     // Sizes
     {
-      'h-8 px-3 text-sm': size === 'sm',
-      'h-10 px-4 text-base': size === 'md',
-      'h-12 px-6 text-lg': size === 'lg',
+      "h-8 px-3 text-sm": size === "sm",
+      "h-10 px-4 text-base": size === "md",
+      "h-12 px-6 text-lg": size === "lg",
     },
     // States
     {
-      'opacity-50 cursor-not-allowed': disabled,
+      "opacity-50 cursor-not-allowed": disabled,
     },
-    className
+    className,
   );
 
   // 7. Render
@@ -82,11 +85,9 @@ ComponentName.Slot = function ComponentNameSlot({
   children,
 }: ComponentNameProps) {
   return (
-    <div className={cn('flex items-center gap-2', className)}>
-      {children}
-    </div>
+    <div className={cn("flex items-center gap-2", className)}>{children}</div>
   );
 };
 
 // 9. Display Name (for debugging)
-ComponentName.displayName = 'ComponentName';
+ComponentName.displayName = "ComponentName";

package/.agent/skills/orchestrator/scripts/parallel-run.sh

@@ -126,7 +126,7 @@ parse_inline_tasks() {
 
         # Spawn in background
         (
-            "$SPAWN_SCRIPT" "$agent" "$task" "$workspace" $VENDOR_FLAG \
+            oh-my-ag agent:spawn "$agent" "$task" "parallel-${TIMESTAMP}" "$workspace" \
                 > "${RUN_DIR}/${agent}-${idx}.log" 2>&1
         ) &
 

package/.agent/skills/workflow-guide/SKILL.md

@@ -6,16 +6,19 @@ description: Guide for coordinating PM, Frontend, Backend, Mobile, and QA agents
 # Multi-Agent Workflow Guide
 
 ## When to use
+
 - Complex feature spanning multiple domains (full-stack, mobile)
 - Coordination needed between frontend, backend, mobile, and QA
 - User wants step-by-step guidance for multi-agent coordination
 
 ## When NOT to use
+
 - Simple single-domain task -> use the specific agent directly
 - User wants automated execution -> use orchestrator
 - Quick bug fixes or minor changes
 
 ## Core Rules
+
 1. Always start with PM Agent for task decomposition
 2. Spawn independent tasks in parallel (same priority tier)
 3. Define API contracts before frontend/mobile tasks
@@ -27,31 +30,38 @@ description: Guide for coordinating PM, Frontend, Backend, Mobile, and QA agents
 ## Workflow
 
 ### Step 1: Plan with PM Agent
+
 PM Agent analyzes requirements, selects tech stack, creates task breakdown with priorities.
 
 ### Step 2: Spawn Agents by Priority
+
 Spawn agents via CLI:
+
 1. Use spawn-agent.sh for each task
 2. CLI selection follows agent_cli_mapping in user-preferences.yaml
 3. Spawn all same-priority tasks in parallel using background processes
 
 ```bash
 # Example: spawn backend and frontend in parallel
-.agent/skills/orchestrator/scripts/spawn-agent.sh backend "task description" ./backend &
-.agent/skills/orchestrator/scripts/spawn-agent.sh frontend "task description" ./frontend &
+oh-my-ag agent:spawn backend "task description" session-id ./backend &
+oh-my-ag agent:spawn frontend "task description" session-id ./frontend &
 wait
 ```
 
 ### Step 3: Monitor & Coordinate
+
 - Use memory read tool to poll `progress-{agent}.md` files
 - Verify API contracts align between agents
 - Ensure shared data models are consistent
 
 ### Step 4: QA Review
+
 Spawn QA Agent last to review all deliverables. Address CRITICAL issues by re-spawning agents.
 
 ## Automated Alternative
+
 For fully automated execution without manual spawning, use the **orchestrator** skill instead.
 
 ## References
+
 - Workflow examples: `resources/examples.md`

package/.agent/skills/workflow-guide/resources/examples.md

@@ -5,14 +5,15 @@
 **Input**: "JWT 인증이 있는 TODO 앱을 만들어줘"
 
 **Workflow**:
+
 ```
 Step 1: PM Agent plans the project
   -> 5 tasks: auth API, CRUD API, login UI, todo UI, QA review
 
 Step 2: Spawn Priority 1 agents via CLI
   # Run in parallel using background processes
-  .agent/skills/orchestrator/scripts/spawn-agent.sh backend "JWT authentication API + TODO CRUD" ./backend &
-  .agent/skills/orchestrator/scripts/spawn-agent.sh frontend "Login/Register UI" ./frontend &
+  oh-my-ag agent:spawn backend "JWT authentication API + TODO CRUD" session-id ./backend &
+  oh-my-ag agent:spawn frontend "Login/Register UI" session-id ./frontend &
   wait
 
 Step 3: Monitor progress
@@ -35,19 +36,20 @@ Step 6: Address QA findings
 **Input**: "블로그에 댓글 기능을 추가해줘"
 
 **Workflow**:
+
 ```
 Step 1: PM Agent analyzes existing codebase and plans
   -> 2 tasks: Comments API, Comment Section UI
 
 Step 2: Spawn Backend Agent first (API-first)
-  .agent/skills/orchestrator/scripts/spawn-agent.sh backend "Comments API with nested replies, pagination" ./backend
+  oh-my-ag agent:spawn backend "Comments API with nested replies, pagination" session-id ./backend
 
 Step 3: After backend completes, spawn Frontend Agent
-  .agent/skills/orchestrator/scripts/spawn-agent.sh frontend "Comment section UI using the new API endpoints" ./frontend
+  oh-my-ag agent:spawn frontend "Comment section UI using the new API endpoints" session-id ./frontend
   (Sequential because frontend depends on API contracts)
 
 Step 4: QA review
-  .agent/skills/orchestrator/scripts/spawn-agent.sh qa "Security: XSS in comments, rate limiting; Performance: Pagination, N+1 queries" .
+  oh-my-ag agent:spawn qa "Security: XSS in comments, rate limiting; Performance: Pagination, N+1 queries" session-id .
 ```
 
 ## Example 3: When to Use Orchestrator Instead
@@ -55,6 +57,7 @@ Step 4: QA review
 **User**: "자동으로 실행해줘" / "Run everything automatically"
 
 **Response**:
+
 ```
 "You want fully automated execution. Let me switch to the
 orchestrator skill instead, which will:

package/README.ko.md

@@ -3,14 +3,17 @@
 Google Antigravity IDE용 전문 에이전트 스킬 모음. PM, Frontend, Backend, Mobile, QA, Debug 전문 에이전트가 Agent Manager, CLI 기반 SubAgent Orchestrator, 실시간 Serena Memory 대시보드를 통해 협업합니다.
 
 > **마음에 드셨나요?** 스타 눌러주세요!
+>
 > ```bash
 > gh repo star first-fluke/oh-my-ag
 > ```
 >
 > **풀스택 개발이 처음이신가요?** 최적화된 스타터 템플릿으로 시작필보세요:
+>
 > ```bash
 > git clone https://github.com/first-fluke/fullstack-starter
 > ```
+>
 > 이 스킬들이 미리 설정되어 있어 바로 멀티 에이전트 협업이 가능합니다.
 
 ## 목차
@@ -22,7 +25,7 @@ Google Antigravity IDE용 전문 에이전트 스킬 모음. PM, Frontend, Backe
 - [프로젝트 구조](#프로젝트-구조)
 - [스킬 아키텍처](#스킬-아키텍처)
 - [스킬 개요](#스킬-개요)
-- [사전 요구 사항](#사전-요구-사항)
+
 - [CLI 명령어](#cli-명령어)
 - [문제 해결](#문제-해결)
 - [라이선스](#라이선스)
@@ -45,7 +48,48 @@ Google Antigravity IDE용 전문 에이전트 스킬 모음. PM, Frontend, Backe
 
 ## 빠른 시작
 
-### 1. 클론 & 열기
+### 사전 요구 사항
+
+- **Google Antigravity** (2026+)
+- **Bun** (CLI 및 대시보드용)
+
+### 옵션 1: 대화형 CLI (권장)
+
+```bash
+# bun이 없으면 먼저 설치:
+# curl -fsSL https://bun.sh/install | bash
+
+bunx oh-my-ag
+```
+
+프로젝트 타입을 선택하면 `.agent/skills/`에 스킬이 설치됩니다.
+
+| 프리셋 | 스킬 |
+|--------|--------|
+| ✨ All | 전체 |
+| 🌐 Fullstack | frontend, backend, pm, qa, debug, commit |
+| 🎨 Frontend | frontend, pm, qa, debug, commit |
+| ⚙️ Backend | backend, pm, qa, debug, commit |
+| 📱 Mobile | mobile, pm, qa, debug, commit |
+
+### 옵션 2: 전역 설치 (Orchestrator용)
+
+SubAgent Orchestrator를 사용하거나 도구를 전역에서 사용하려면:
+
+```bash
+bun install --global oh-my-ag
+```
+
+최소 1개의 CLI 도구가 필요합니다:
+
+| CLI | 설치 | 인증 |
+|-----|------|------|
+| Gemini | `bun install --global @anthropic-ai/gemini-cli` | `gemini auth` |
+| Claude | `bun install --global @anthropic-ai/claude-code` | `claude auth` |
+| Codex | `bun install --global @openai/codex` | `codex auth` |
+| Qwen | `bun install --global @qwen-code/qwen` | `qwen auth` |
+
+### 옵션 3: 클론 & 열기
 
 ```bash
 git clone <repository-url>
@@ -55,25 +99,36 @@ antigravity open .
 
 Antigravity가 `.agent/skills/`의 스킬을 자동 감지합니다.
 
-### 기존 프로젝트에 통합하기
+### 옵션 4: 기존 프로젝트에 통합하기
+
+**권장 방법 (CLI):**
 
-이미 Antigravity 프로젝트가 있다면 스킬만 복사하면 됩니다:
+기존 프로젝트의 루트 디렉토리에서 다음 명령어를 실행하면 스킬과 워크플로우가 자동으로 설치됩니다:
 
 ```bash
-# 옵션 1: 스킬만 복사
-cp -r oh-my-ag/.agent/skills /path/to/your-project/.agent/
+bunx oh-my-ag
+```
 
-# 옵션 2: 스킬 + 대시보드
+> **팁:** 설치 후 `bunx oh-my-ag doctor`를 실행하여 모든 설정(전역 워크플로우 포함)이 올바른지 확인하세요.
+
+**수동 방법 (파일 복사):**
+
+이미 oh-my-ag 저장소를 클론했다면 파일 복사로도 가능합니다:
+
+```bash
+# 1. 스킬 복사
 cp -r oh-my-ag/.agent/skills /path/to/your-project/.agent/
 
-cp oh-my-ag/package.json /path/to/your-project/  # 의존성 병합
+# 2. 워크플로우 복사
+cp -r oh-my-ag/.agent/workflows /path/to/your-project/.agent/
 
-# 옵션 3: 특정 스킬만
-cp -r oh-my-ag/.agent/skills/backend-agent /path/to/your-project/.agent/skills/
-cp -r oh-my-ag/.agent/skills/frontend-agent /path/to/your-project/.agent/skills/
+# 3. 설정 복사 (선택)
+cp -r oh-my-ag/.agent/config /path/to/your-project/.agent/
+cp oh-my-ag/package.json /path/to/your-project/  # 의존성 병합
 ```
 
 본인 프로젝트에서:
+
 ```bash
 cd /path/to/your-project
 npm install  # 대시보드 사용할 경우
@@ -94,24 +149,28 @@ antigravity open .
 ### 3. 채팅으로 사용
 
 **간단한 작업** (단일 에이전트 자동 활성화):
+
 ```
 "Tailwind CSS로 로그인 폼 만들어줘"
 → frontend-agent 자동 활성화
 ```
 
 **복잡한 프로젝트** (workflow-guide가 조율):
+
 ```
 "사용자 인증이 있는 TODO 앱 만들어줘"
 → workflow-guide → PM Agent 기획 → Agent Manager에서 에이전트 생성
 ```
 
 **명시적 조율** (유저가 워크플로우 호출):
+
 ```
 /coordinate
 → 단계별: PM 기획 → 에이전트 생성 → QA 검토
 ```
 
 **변경사항 커밋** (Conventional Commits):
+
 ```
 /commit
 → 변경 분석, 커밋 타입/스코프 제안, Co-Author 포함 커밋 생성
@@ -133,6 +192,7 @@ bunx oh-my-ag dashboard:web  # 웹 대시보드 (브라우저 UI)
 ### Progressive Disclosure (점진적 공개)
 
 스킬을 수동으로 선택할 필요 없습니다. Antigravity가 자동으로:
+
 1. 채팅 요청을 분석
 2. `.agent/skills/`의 스킬 설명과 매칭
 3. 필요한 스킬만 컨텍스트에 로드
@@ -141,6 +201,7 @@ bunx oh-my-ag dashboard:web  # 웹 대시보드 (브라우저 UI)
 ### Agent Manager UI
 
 복잡한 프로젝트에는 Antigravity **Agent Manager** (Mission Control)를 사용합니다:
+
 1. PM Agent가 기획서 작성
 2. Agent Manager UI에서 에이전트 생성
 3. 에이전트들이 별도 워크스페이스에서 병렬 작업
@@ -153,11 +214,11 @@ bunx oh-my-ag dashboard:web  # 웹 대시보드 (브라우저 UI)
 
 ```bash
 # 단일 에이전트
-./scripts/spawn-subagent.sh backend "인증 API 구현" ./backend
+oh-my-ag agent:spawn backend "인증 API 구현" session-01 ./backend
 
-# 병렬 에이전트
-./scripts/spawn-subagent.sh backend "인증 API 구현" ./backend &
-./scripts/spawn-subagent.sh frontend "로그인 폼 생성" ./frontend &
+# 병렬 실행 (orchestrator 스킬 사용 시)
+oh-my-ag agent:spawn backend "인증 API 구현" session-01 ./backend &
+oh-my-ag agent:spawn frontend "로그인 폼 생성" session-01 ./frontend &
 wait
 ```
 
@@ -185,6 +246,7 @@ agent_cli_mapping:
 ```
 
 **CLI 우선순위**:
+
 1. `--vendor` 명령줄 인자
 2. `user-preferences.yaml`의 `agent_cli_mapping`
 3. `user-preferences.yaml`의 `default_cli`
@@ -246,6 +308,7 @@ bunx oh-my-ag dashboard:web
 ```
 
 기능:
+
 - WebSocket 실시간 푸시 (폴링 없음)
 - 연결 끊김 시 자동 재연결
 - 볼라색 Serena 테마 UI
@@ -300,9 +363,6 @@ bunx oh-my-ag dashboard:web
 │       #     └── snippets.md           (코드 스니펫)
 ├── .serena/
 │   └── memories/                   # 런타임 상태 (gitignore 처리됨)
-├── scripts/
-│   ├── spawn-subagent.sh           # 서브에이전트 실행기
-│   └── poll-status.sh              # 상태 폴링
 ├── package.json
 ├── README.md                       # 영문 가이드
 ├── README.ko.md                    # 한글 가이드 (이 파일)
@@ -352,56 +412,51 @@ bunx oh-my-ag dashboard:web
 ## 스킬 개요
 
 ### workflow-guide
+
 **발동 조건**: 복잡한 멀티 도메인 요청
 **역할**: PM, Frontend, Backend, Mobile, QA 에이전트 조율 안내
 
 ### pm-agent
+
 **발동 조건**: "기획해줘", "분석해줘", "뭘 만들어야 할까"
 **산출물**: `.agent/plan.json` (태스크, 우선순위, 의존성)
 
 ### frontend-agent
+
 **발동 조건**: UI, 컴포넌트, 스타일링, 클라이언트 로직
 **기술 스택**: Next.js 14, TypeScript, Tailwind CSS, shadcn/ui
 
 ### backend-agent
+
 **발동 조건**: API, 데이터베이스, 인증
 **기술 스택**: FastAPI, SQLAlchemy, PostgreSQL, Redis, JWT
 
 ### mobile-agent
+
 **발동 조건**: 모바일 앱, iOS/Android
 **기술 스택**: Flutter 3.19+, Dart, Riverpod
 
 ### qa-agent
+
 **발동 조건**: "보안 검토해줘", "성능 확인", "감사해줘"
 **검사 항목**: OWASP Top 10, Lighthouse, WCAG 2.1 AA
 
 ### debug-agent
+
 **발동 조건**: 버그 리포트, 에러 메시지, 크래시
 **산출물**: 수정된 코드, 회귀 테스트, 버그 문서
 
 ### orchestrator
+
 **발동 조건**: 프로그래밍 방식의 서브에이전트 실행
 **지원 CLI**: Gemini, Claude, Codex, Qwen (설정 가능)
 
 ### commit
+
 **발동 조건**: "커밋해줘", "commit", "변경사항 저장"
 **형식**: Conventional Commits + Co-Author 태그
 **설정**: `.agent/skills/commit/config/commit-config.yaml`
 
-## 사전 요구 사항
-
-- **Google Antigravity** (2026+)
-- **Bun** (CLI 및 대시보드용)
-
-SubAgent Orchestrator를 사용하려면 최소 1개의 CLI 도구 필요:
-
-| CLI | 설치 | 인증 |
-|-----|------|------|
-| Gemini | `bun install --global @anthropic-ai/gemini-cli` | `gemini auth` |
-| Claude | `bun install --global @anthropic-ai/claude-code` | `claude auth` |
-| Codex | `bun install --global @openai/codex` | `codex auth` |
-| Qwen | `bun install --global @qwen-code/qwen` | `qwen auth` |
-
 ## CLI 명령어
 
 ```bash
@@ -414,20 +469,25 @@ bunx oh-my-ag stats --reset  # 메트릭 초기화
 bunx oh-my-ag retro          # 세션 회고 (배운 점 & 다음 단계)
 bunx oh-my-ag dashboard      # 터미널 실시간 대시보드
 bunx oh-my-ag dashboard:web  # 웹 대시보드 (http://localhost:9847)
+bunx oh-my-ag dashboard:web  # 웹 대시보드 (http://localhost:9847)
+bunx oh-my-ag bridge         # MCP stdio - SSE 브릿지 (Serena용)
 bunx oh-my-ag help           # 도움말 표시
 ```
 
 ## 문제 해결
 
 ### 대시보드에 "No agents detected" 표시
+
 메모리 파일이 아직 생성되지 않았습니다. Orchestrator를 실행하거나 `.serena/memories/`에 수동으로 파일을 생성하세요.
 
 ### Antigravity에서 스킬이 로드되지 않음
+
 1. `antigravity open .`으로 프로젝트 열기
 2. `.agent/skills/` 폴더와 `SKILL.md` 파일 확인
 3. Antigravity IDE 재시작
 
 ### 에이전트 간 코드 불일치
+
 1. `.gemini/antigravity/brain/`에서 산출물 검토
 2. 다른 에이전트의 산출물을 참조하여 재생성
 3. QA Agent로 최종 일관성 검사