글
oh-my-ag - 멀티에이전트 개발 스킬
Google Antigravity IDE를 위한 멀티에이전트 스킬. PM/Frontend/Backend/Mobile/QA/Debug 에이전트가 협업. 토큰 75% 절감 설계. Gemini/Claude/Codex/Qwen 등 모델 혼합 사용. 실시간 대시보드. bunx oh-my-ag로 설치.
배경 및 맥락
AI 코딩 어시스턴트 시대에 접어들면서 개발팀의 구성 방식이 근본적으로 변화하고 있습니다. Cursor, Claude Code, Windsurf 같은 도구들이 보편화되면서 "단일 AI가 모든 작업을 처리하는 방식"의 한계가 드러났습니다. 복잡한 기능 개발은 요구사항 분석, 백엔드 설계, 프론트엔드 구현, QA 검증이 유기적으로 연결되어야 하는데, 하나의 모델이 모든 도메인 지식을 동시에 보유하기는 비효율적입니다. 이런 배경에서 "실제 엔지니어링 팀의 역할 분담"을 AI에이전트로 재현하려는 움직임이 확산 중입니다.
Google Antigravity IDE 생태계가 오픈소스 에이전트 도구들을 수용하면서, 포타블하고 재사용 가능한 멀티에이전트 시스템에 대한 수요가 급증했습니다. oh-my-ag는 이런 요구에 응답하는 프로젝트로, "프로젝트와 함께 이동하는" 구조로 특정 IDE에 종속되지 않으면서도 강력한 에이전트 협업을 제공합니다.
핵심 내용
**oh-my-ag는 "포타블 멀티에이전트 하네스"**로, 14개의 전문화된 에이전트가 역할을 나누어 복잡한 개발 작업을 수행합니다. 각 에이전트는 .agents/ 디렉토리에 SKILL.md 형태로 정의되어 프로젝트와 함께 이동하므로, Antigravity, Claude Code, Cursor, Gemini CLI 등 어떤 IDE에서든 동일하게 작동합니다.
14개 핵심 에이전트:
- Brainstorm Agent: 구현 전 아이디어 탐색 및 기술적 실행 가능성 검증
- PM Agent: 사용자 요구사항을 기술 태스크로 분해, API 스펙 정의
- Frontend/Backend/DB/Mobile Agent: 각 도메인의 코딩 실행
- Design Agent: 디자인 시스템, 토큰, 접근성 검토
- QA Agent: OWASP 보안 취약점, 성능 최적화, 접근성 검증
- Debug Agent: 버그의 근본 원인 분석, 회귀 테스트 작성
- Infra Agent: Terraform 기반 IaC, 멀티클라우드 배포
- Dev-Workflow Agent: CI/CD, 릴리스 자동화, 모노레포 관리
- Translator Agent: 다국어 지원
- Orchestrator: 병렬/순차 에이전트 실행 조율
- Commit Agent: Conventional Commit 자동화
세 계층 아키텍처:
- 워크플로우 계층: /brainstorm, /plan, /coordinate, /orchestrate, /review, /debug, /design 등 9가지 슬래시 명령으로 사용자 의도에 따라 자동 라우팅
- 오케스트레이션 계층: PM과 Orchestrator가 에이전트 간 작업 흐름 관리, 의존성 해결
- 도메인 에이전트 계층: 전문 분야별 에이전트들이 병렬 또는 순차로 작업 실행
토큰 75% 절감 설계:
oh-my-ag는 "두 계층 스킬" 구조로 토큰 효율성을 극대화합니다. 각 에이전트가 자신의 도메인에 필요한 최소한의 지식만 보유하고, 전체 프로젝트 컨텍스트 대신 필요한 부분만 전달합니다. 예를 들어 Frontend 에이전트는 React/TypeScript/Tailwind 관련 지식에만 집중하고, Database 스키마 전체를 메모리에 로드하지 않습니다. 이렇게 되면 토큰 소비가 크게 줄어들면서도 각 에이전트는 전문적인 결과물을 생성합니다.
다중 LLM 지원:
에이전트별로 다른 모델을 할당 가능합니다. 복잡한 논리는 Claude, 빠른 응답이 필요한 부분은 Gemini, 코드 생성은 Codex처럼 유연하게 조합할 수 있습니다. 이를 통해 비용 대비 성능 최적화와 모델별 강점 활용이 가능합니다.
실시간 대시보드:
터미널에서 각 에이전트의 진행 상황을 실시간으로 추적하고, localhost:9847의 웹 UI에서 시각적으로 모니터링할 수 있습니다. "어떤 에이전트가 현재 작업 중인가?", "토큰은 얼마나 소비됐는가?"를 즉시 파악할 수 있습니다.
설치 및 사용:
bunx oh-my-ag
# Fullstack/Frontend/Backend/Mobile 선택 시 자동으로 .agents/ 디렉토리에 필요한 SKILL.md 생성
간단한 요청은 자동으로 관련 에이전트만 활성화되고, 복잡한 요청은 PM → 도메인 에이전트들 → QA → Commit의 전체 파이프라인이 작동합니다.
경쟁 구도 / 비교
기존 단일 에이전트 방식(Claude Code의 기본 사용법, Cursor의 basic mode)과 oh-my-ag의 차별점:
| 측면 | 단일 에이전트 | oh-my-ag 멀티에이전트 |
|---|---|---|
| 컨텍스트 관리 | 프로젝트 전체 로드, 토큰 낭비 | 도메인별 최소 필요 정보만 전달, 75% 절감 |
| QA/검증 | 사용자가 수동으로 테스트 | QA Agent 자동 보안/성능/접근성 검증 |
| 도메인 전문성 | 일반화된 답변 (때로 부정확) | 각 도메인 전문 에이전트 (깊이 있는 결과) |
| 속도 | 순차 처리 | 병렬 처리로 개발 시간 단축 |
| 비용 | 높음 (긴 컨텍스트 윈도우) | 낮음 (토큰 절감) |
| 이식성 | IDE 종속 | 프로젝트와 함께 이동, IDE 독립적 |
비슷한 시도로는 AutoGPT, Dify 같은 플랫폼이 있지만, oh-my-ag는 "IDE 통합"과 "프로젝트 포타블성"에 강점을 가집니다. 또한 Anthropic Claude Code와 Google Antigravity IDE의 네이티브 에이전트 SDK를 직접 활용하므로 추가 런타임 없이 경량으로 동작합니다.
의미
산업적 의미:
oh-my-ag는 "AI로 구성된 가상 개발팀"의 가능성을 보여줍니다. 스타트업이 풀스택 엔지니어 5명을 고용하는 대신, 1명의 개발자 + AI 에이전트 조합으로 유사한 속도의 개발을 진행할 수 있게 되는 지점이 다가오고 있습니다. 특히 보안 검증, 접근성 검토, 테스트 코드 작성 같이 "체계적이지만 반복적인 작업"을 에이전트가 담당하면서, 개발자는 아키텍처 결정, 비즈니스 로직 같이 "창의적 사고"가 필요한 부분에 집중할 수 있습니다.
기술적 의미:
- LLM 라우팅의 성숙화: 요청을 자동으로 올바른 에이전트에 전달하는 라우팅 메커니즘이 실무 수준에 도달했습니다.
- 토큰 효율성의 한계 돌파: 75% 토큰 절감은 멀티에이전트 설계의 경제성을 증명합니다.
- IDE 독립적 에이전트 정의: SKILL.md 형식으로 표준화된 에이전트 정의가 여러 IDE에서 호환되는 방향으로 진화 중입니다.
앞으로의 전망:
- 2026년 상반기: oh-my-ag 같은 멀티에이전트 프레임워크가 더 많은 오픈소스 프로젝트에 채택될 것으로 예상
- 개발 생산성: 현재 대비 2~3배 향상 가능성
- 팀 구성의 변화: 소규모팀도 엔터프라이즈 수준의 QA와 검증 프로세스 도입 가능
- 새로운 직무 등장: 에이전트 워크플로우를 설계하고 최적화하는 "AI 개발 아키텍트" 같은 역할이 새로 생성될 가능성