npx claudepluginhub unicorn-plugins/dmap선언형 멀티에이전트 플러그인(DMAP) 빌더
unicorn-pluginsShare bugs, ideas, or general feedback.
코드 없이 멀티에이전트 플러그인을 만드는 선언형 프레임워크
DMAP (Declarative Multi-Agent Plugin) 은 코드 없이 Markdown(프롬프트)과 YAML(설정)만으로 멀티에이전트 시스템을 정의하는 선언형 플러그인 아키텍처 표준임.
에이전트 1개는 괜찮지만, 여러 에이전트가 협업해야 하는 순간 복잡도가 폭발적으로 증가함. 기존 방식의 한계는 다음과 같음:
"에이전트를 정의하는 데 꼭 코드가 필요할까?"
"어떻게(HOW)" 대신 "무엇을(WHAT)"만 선언하는 방식임. 택시 기사에게 경로를 일일이 지시하는 대신 "강남역이요"라고 목적지만 말하는 것과 동일함.
| 가치 | 설명 |
|---|---|
| 선언형 명세 | 코드 대신 Markdown + YAML로 에이전트 정의 |
| 런타임 중립 | Claude Code, Codex CLI 등 어떤 런타임에서든 동작 |
| 관심사 분리 | Skills(라우팅) -> Agents(실행) -> Gateway(매핑) 단방향 의존 |
| 비개발자 접근성 | Markdown 작성 가능하면 누구나 플러그인 구축 가능 |
| 도메인 범용 | 코드 생성, 교육, 문서화, 비즈니스 워크플로우 등 어떤 도메인에도 적용 가능 |
현재 버전 안내 (2026.2월): 현재 DMAP 빌더는 Claude Code 전용으로 제공됨. DMAP 표준 자체는 런타임 중립적으로 설계되었으며, 향후 Codex CLI, Gemini CLI 등 멀티 런타임 지원으로 확장 예정임.
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 설치가 필수임.
claude plugin marketplace add unicorn-plugins/dmap
claude plugin install dmap@dmap
초기 설정: Claude Code 실행 후
/dmap:setup
'/dmap:team-planner' 실행하여 팀 기획서 작성 부터 시작
| 명령 | 설명 |
|---|---|
/dmap:develop-plugin | 4-Phase 워크플로우로 플러그인 개발 |
/dmap:team-planner | 팀 기획서 작성 지원 (AI 자동 완성) |
/dmap:publish | 개발 완료된 플러그인을 GitHub에 배포 |
/dmap:add-ext-skill | 외부호출 스킬(ext-{대상플러그인}) 추가 |
/dmap:remove-ext-skill | 외부호출 스킬(ext-{대상플러그인}) 제거 |
/dmap:setup | 설치 검증 (플러그인 구조 및 표준 문서 확인) |
/dmap:help | 사용 안내 |
기본 사용 흐름:
1. /dmap:setup -- 설치 상태 검증
2. /dmap:team-planner -- 팀 기획서 작성 (AI 자동 완성)
3. /dmap:develop-plugin -- 요구사항 -> 설계 -> 개발 -> 검증 자동 수행
4. /dmap:publish -- GitHub 배포 (저장소 생성, 커밋, 푸시)
End-to-End 자동화: 요구사항 정의부터 GitHub 배포까지 전 과정을 AI가 자동 수행함. 사용자는 각 단계의 승인만 하면 됨.
DMAP의 구조를 회사 조직에 비유하면 이해하기 쉬움.
일을 배분하는 부서장 역할.
사용자의 요청을 받아 어떤 에이전트에게 어떤 일을 시킬지 결정함.
SKILL.md 파일 하나로 워크플로우 전체를 선언.
| 항목 | 내용 |
|---|---|
| 핵심 파일 | skills/{name}/SKILL.md |
| 역할 | 라우팅 + 오케스트레이션 |
| 유형 | router, setup, orchestrator, planning |
실제 일을 수행하는 전문가. 각 에이전트는 3개 파일로 구성됨.
| 파일 | 역할 |
|---|---|
AGENT.md | 역할 정의 (목표, 워크플로우, 출력 형식) |
agentcard.yaml | 메타데이터 (이름, 버전, 티어, 제약) |
tools.yaml | 사용 가능한 도구 추상 선언 |
추상적인 선언을 구체적인 실행 환경으로 번역하는 통역사. 에이전트가 "파일 검색 도구"라고 선언하면, Gateway가 실제 런타임에서 어떤 도구를 쓸지 매핑함.
| 파일 | 역할 |
|---|---|
install.yaml | MCP/LSP 서버, 커스텀 도구 설치 선언 |
runtime-mapping.yaml | 티어 매핑, 도구 매핑, 액션 매핑 |
가이드, 템플릿, 샘플, 도구를 모아둔 공유 저장소. 여러 플러그인이 함께 사용할 수 있는 공용 자원 풀.