🇰🇷 한국어 | 🇺🇸 English
DMAP 빌더
코드 없이 멀티에이전트 플러그인을 만드는 선언형 프레임워크
개요
DMAP (Declarative Multi-Agent Plugin) 은
코드 없이 Markdown(프롬프트)과 YAML(설정)만으로
멀티에이전트 시스템을 정의하는 선언형 플러그인 아키텍처 표준임.
문제: 기존 플러그인 개발의 불편함
Claude Code, Codex CLI와 같은 AI CLI 플러그인을 개발할 때,
코드 기반 구현은 다음과 같은 한계가 있음:
- 높은 진입장벽 -- 각 런타임별 SDK와 API를 학습해야 함
- 런타임 강결합 -- 비즈니스 로직이 특정 런타임에 종속되어 이식성이 낮음
- 유지보수 어려움 -- 요구사항 변경 시 코드 전체를 수정해야 함
"플러그인의 본질(비즈니스 로직)과 실행 방식(인프라)을 분리할 수는 없을까?"
DMAP의 해결 방식
Clean 아키텍처의 관심사 분리 원칙을 적용하여 비즈니스 로직과 인프라를 분리함.
1. 선언형 명세
"어떻게(HOW)" 대신 "무엇을(WHAT)"만 선언하는 방식임.
택시 기사에게 경로를 일일이 지시하는 대신 "강남역이요"라고 목적지만 말하는 것과 동일함.
2. 추상화 레이어
에이전트는 모델 등급(tier: HIGH)과 툴(file_search, code_edit)을 추상적으로 선언함.
구체적인 모델 이름(Claude Opus, GPT-4 등)이나 실제 도구 API는 에이전트가 알 필요 없음.
3. Gateway 레이어의 매핑
Gateway가 추상 선언을 실제 런타임 환경에 맞게 자동 변환함.
tier: HIGH → Claude Code에서는 claude-opus-4, Codex CLI에서는 gpt-4-turbofile_search → Claude Code에서는 Glob 도구, Codex CLI에서는 ripgrep 도구
이를 통해 에이전트 정의는 그대로 두고, Gateway 설정만 바꾸면 다른 런타임에서 실행 가능함.
핵심 가치
| 가치 | 설명 |
|---|
| 선언형 명세 | 코드 대신 Markdown + YAML로 에이전트 정의 |
| 런타임 중립 | Claude Code, Codex CLI 등 어떤 런타임에서든 동작 |
| 관심사 분리 | Skills(라우팅) -> Agents(실행) -> Gateway(매핑) 단방향 의존 |
| 비개발자 접근성 | Markdown 작성 가능하면 누구나 플러그인 구축 가능 |
| 도메인 범용 | 코드 생성, 교육, 문서화, 비즈니스 워크플로우 등 어떤 도메인에도 적용 가능 |
지원 런타임
DMAP이 생성하는 플러그인은 SSOT(agents/{name}/) + 런타임별 얇은 포인터 어댑터 방식으로 아래 4개 런타임을 모두 지원함.
에이전트 정의는 한 번만 작성하고 develop-plugin이 런타임별 스텁을 자동 생성함.
| 런타임 | 어댑터 경로 | 포맷 | 모델 예시 | 호출 방법 |
|---|
| Claude Code / CoWork | .claude/agents/{name}.md | Markdown + YAML frontmatter | opus, sonnet, haiku | Agent(subagent_type=FQN, ...) |
| Cursor | .cursor/agents/{name}.md | Markdown + YAML frontmatter | opus, sonnet, haiku | /{agent} 또는 자연어 위임 |
| Codex | .codex/agents/{name}.toml | TOML + developer_instructions | gpt-5.4, gpt-5.4-mini 등 | spawn_agents_on_csv 또는 자연어 |
| Antigravity | .antigravity/agents/{name}.md | Markdown + YAML frontmatter | opus, sonnet, haiku | Manager UI 수동 로드 (프로그래매틱 API 불확실) |
핵심 설계: SSOT는 agents/{name}/ 한 곳에만 존재하고, 각 런타임용 어댑터 스텁은
"SSOT 3파일을 읽어 그에 따라 행동하라"는 지시문만 포함하는 얇은 포인터임.
모델 버전은 gateway/runtime-mapping.yaml의 4런타임 tier 매핑에서 해결되어 스텁 frontmatter에 기록됨.
상세: agent-runtime-adapters.md
Top
빠른 시작
사전 요구사항
1. 기본 툴 설치
| 도구 | 최소 버전 | 용도 |
|---|
| Git | 2.x | 플러그인 마켓플레이스 (GitHub 저장소 클론) |
| Node.js | 18+ | MCP 서버 실행 (npx 명령 사용) |
| VS Code | 최신 | 코드 편집기 (code 명령 사용) |
2. PATH 설정
~/.local/bin 디렉토리를 PATH에 추가함:
# Mac 사용자
code ~/.zshrc
# Linux/Windows 사용자 (Windows는 Git Bash 터미널 사용)
code ~/.bashrc
아래 내용을 파일 끝에 추가:
export PATH=~/.local/bin:$PATH
(중요) 경로 추가 후 반드시 source ~/.bashrc 또는 source ~/.zshrc 실행
3. Claude Code 설치
# macOS/Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
설치 후 초기 구성:
claude
4. Oh My ClaudeCode (OMC) 설치
Claude Code 프롬프트에서 순차 수행:
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
Setup 시 MCP는 context7만 설치:
/oh-my-claudecode:omc-setup
DMAP 빌더는 OMC의 스킬 부스팅(ralplan, ralph 등)을 활용하므로 OMC 설치가 필수임.
DMAP 빌더 설치
소스 클론:
mkdir -p {작업디렉토리}
cd {작업디렉토리}
git clone https://github.com/unicorn-plugins/dmap.git
cd dmap
claude plugin marketplace add ./
claude plugin install dmap@dmap
Claude Code에서 사용
사용법 동영상 보기:
아래 링크의 압축파일 다운로드 후 압축 해제하여 각 일련번호별로 실행 하세요.
https://drive.google.com/file/d/1wabVv4Ioj3FcxSH_Lnd-BDsWzoKH7-W-/view?usp=drive_link
플러그인 디렉토리 생성:
mkdir -p {작업디렉토리}/{플러그인 디렉토리}
cd {작업디렉토리}/{플러그인 디렉토리}
Claude Code 실행 -> '/dmap:team-planner' 실행하여 팀 기획서 작성 부터 시작
