🇰🇷 한국어 | 🇺🇸 English

코드 없이 멀티에이전트 플러그인을 만드는 선언형 프레임워크

• DMAP 빌더
  • 개요
    • 문제: 기존 플러그인 개발의 불편함
    • DMAP의 해결 방식
    • 핵심 가치
    • 지원 런타임
  • 빠른 시작
    • 사전 요구사항
    • DMAP 빌더 설치
    • Claude Code에서 사용
  • 업그레이드
  • 핵심 개념
    • Skills = 부서장
    • Agents = 전문가
    • Gateway = 통역사
    • 리소스 마켓플레이스 = 사내 공유 드라이브
    • 아키텍처 (Clean Architecture)
  • 동작 원리
    • 프롬프트 조립
    • 4-Tier 모델 매핑
    • 스킬 활성화 경로
  • 플러그인 개발 워크플로우
  • 프로젝트 구조
  • 표준 문서
  • 로드맵
  • 라이선스

DMAP (Declarative Multi-Agent Plugin) 은 코드 없이 Markdown(프롬프트)과 YAML(설정)만으로 멀티에이전트 시스템을 정의하는 선언형 플러그인 아키텍처 표준임.

Claude Code, Codex CLI와 같은 AI CLI 플러그인을 개발할 때, 코드 기반 구현은 다음과 같은 한계가 있음:

• 높은 진입장벽 -- 각 런타임별 SDK와 API를 학습해야 함
• 런타임 강결합 -- 비즈니스 로직이 특정 런타임에 종속되어 이식성이 낮음
• 유지보수 어려움 -- 요구사항 변경 시 코드 전체를 수정해야 함

"플러그인의 본질(비즈니스 로직)과 실행 방식(인프라)을 분리할 수는 없을까?"

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-turbo
• file_search → Claude Code에서는 Glob 도구, Codex CLI에서는 ripgrep 도구

이를 통해 에이전트 정의는 그대로 두고, Gateway 설정만 바꾸면 다른 런타임에서 실행 가능함.

DMAP이 생성하는 플러그인은 SSOT(agents/{name}/) + 런타임별 얇은 포인터 어댑터 방식으로 아래 4개 런타임을 모두 지원함. 에이전트 정의는 한 번만 작성하고 develop-plugin이 런타임별 스텁을 자동 생성함.

핵심 설계: SSOT는 agents/{name}/ 한 곳에만 존재하고, 각 런타임용 어댑터 스텁은 "SSOT 3파일을 읽어 그에 따라 행동하라"는 지시문만 포함하는 얇은 포인터임. 모델 버전은 gateway/runtime-mapping.yaml의 4런타임 tier 매핑에서 해결되어 스텁 frontmatter에 기록됨. 상세: agent-runtime-adapters.md

Top

1. 기본 툴 설치

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 설치가 필수임.

소스 클론:

mkdir -p {작업디렉토리} 
cd {작업디렉토리}
git clone https://github.com/unicorn-plugins/dmap.git
cd dmap

claude plugin marketplace add ./
claude plugin install dmap@dmap

사용법 동영상 보기:
아래 링크의 압축파일 다운로드 후 압축 해제하여 각 일련번호별로 실행 하세요.
https://drive.google.com/file/d/1wabVv4Ioj3FcxSH_Lnd-BDsWzoKH7-W-/view?usp=drive_link

플러그인 디렉토리 생성:

mkdir -p {작업디렉토리}/{플러그인 디렉토리}
cd {작업디렉토리}/{플러그인 디렉토리}

Claude Code 실행 -> '/dmap:team-planner' 실행하여 팀 기획서 작성 부터 시작

기본 사용 흐름:

1. /dmap:setup                -- 설치 상태 검증
2. /dmap:team-planner         -- 팀 기획서 작성 (AI 자동 완성)
3. /dmap:develop-plugin       -- 요구사항 -> 설계 -> 개발 -> 검증 자동 수행
4. /dmap:publish              -- GitHub 배포 (저장소 생성, 커밋, 푸시)

End-to-End 자동화: 요구사항 정의부터 GitHub 배포까지 전 과정을 AI가 자동 수행함. 사용자는 각 단계의 승인만 하면 됨.

Top

# 1. 최신 코드 Pull
cd {dmap 클론 경로}
git pull origin main

# 2. 마켓플레이스 업데이트
claude plugin marketplace update dmap

# 3. 플러그인 재설치
claude plugin install dmap@dmap

갱신이 반영되지 않는 경우:

claude plugin remove dmap@dmap
claude plugin marketplace update dmap
claude plugin install dmap@dmap

업그레이드 후 새 도구가 추가된 경우 /dmap:setup을 재실행하여 누락된 도구를 설치할 것.

Top

DMAP의 구조를 회사 조직에 비유하면 이해하기 쉬움.

일을 배분하는 부서장 역할. 사용자의 요청을 받아 어떤 에이전트에게 어떤 일을 시킬지 결정함. SKILL.md 파일 하나로 워크플로우 전체를 선언.

실제 일을 수행하는 전문가. 각 에이전트는 3개 파일로 구성됨.

추상적인 선언을 구체적인 실행 환경으로 번역하는 통역사. 에이전트가 "파일 검색 도구"라고 선언하면, Gateway가 실제 런타임에서 어떤 도구를 쓸지 매핑함.

가이드, 템플릿, 샘플, 도구를 모아둔 공유 저장소. 여러 플러그인이 함께 사용할 수 있는 공용 자원 풀.

이 컴포넌트들은 Clean Architecture 원칙을 따름. Skills -> Agents -> Gateway 순서로 단방향 의존하므로, 각 부분을 독립적으로 수정하거나 교체 가능함.

위임형:  Input -> Skills(Controller) -> Agents(Service) -> Gateway -> Runtime
직결형:  Input -> Skills(Controller) ----------------------> Gateway -> Runtime

Top

스킬은 3단계 레이어로 프롬프트를 조립하여 에이젼트를 호출함.
이 조립과정에서 추상화된 모델등급과 도구가 실제 인프라와 매핑됨.

작업의 복잡도에 따라 4단계로 나누고, 각 단계에 적합한 AI 모델을 배정함. 간단한 파일 검색은 가벼운 모델이, 복잡한 아키텍처 설계는 강력한 모델이 담당함.

작업 중 난이도가 올라가면 자동으로 상위 모델로 에스컬레이션됨.

두 가지 경로로 스킬이 활성화됨:

1. 직접 호출 -- 슬래시 명령어(/dmap:develop-plugin)로 정확히 원하는 스킬을 호출
2. Router 경유 -- 모호한 요청이 들어오면 Router 스킬이 의도를 분석하여 적절한 스킬로 라우팅

런타임은 skills/ 디렉토리를 자동 스캔하여 사용 가능한 스킬을 발견함.

Top

요구사항 정의부터 GitHub 배포까지 End-to-End 자동화로 수행됨. /dmap:team-planner로 팀 기획서를 먼저 작성한 후, /dmap:develop-plugin으로 4-Phase 워크플로우를 자동 수행하고, /dmap:publish로 GitHub에 배포함. 각 Phase 완료 시 사용자 승인을 받아 다음 단계로 진행함.

/dmap:team-planner → /dmap:develop-plugin (Phase 1~4) → /dmap:publish

Phase 3 개발 순서:

1. 플러그인 스켈레톤 생성 (.claude-plugin/, 디렉토리 구조)
2. Gateway 설정 (install.yaml, runtime-mapping.yaml)
3. 공유자원 복사 (리소스 마켓플레이스 -> 플러그인 디렉토리)
4. 에이전트 개발 (AGENT.md, agentcard.yaml, tools.yaml)
5. 스킬 개발 (setup 필수, help 권장, 기능 스킬)
6. commands/ 진입점 생성
7. 커스텀 앱/CLI 개발 (필요 시)
8. README.md 작성

Top

dmap/
├── .claude-plugin/          # 플러그인 매니페스트
│   ├── plugin.json          #   플러그인 메타데이터
│   └── marketplace.json     #   마켓플레이스 등록 정보
├── standards/               # DMAP 표준 문서
│   ├── plugin-standard.md          # 메인 표준 (아키텍처, 디렉토리, 배포)
│   ├── plugin-standard-agent.md    # Agent 패키지 표준
│   ├── plugin-standard-skill.md    # Skill 작성 표준
│   └── plugin-standard-gateway.md  # Gateway 설정 표준
├── resources/               # 리소스 마켓플레이스 (공유 자원 풀)
│   ├── plugin-resources.md  #   리소스 카탈로그
│   ├── guides/              #   가이드 문서
│   ├── templates/           #   템플릿 파일
│   ├── samples/             #   샘플 파일
│   └── tools/               #   도구 (커스텀 앱/CLI)
├── skills/                  # DMAP 빌더 스킬
│   ├── develop-plugin/      #   플러그인 개발 (4-Phase)
│   ├── team-planner/        #   팀 기획서 작성 지원
│   ├── publish/             #   GitHub 배포
│   ├── add-ext-skill/       #   외부호출 스킬 추가 유틸리티
│   ├── remove-ext-skill/    #   외부호출 스킬 제거 유틸리티
│   ├── ext-{plugin}/        #   외부 플러그인 위임 (선언형 A2A)
│   ├── setup/               #   초기 설정
│   └── help/                #   사용 안내
├── commands/                # 슬래시 명령 진입점
│   ├── develop-plugin.md
│   ├── team-planner.md
│   ├── publish.md
│   ├── add-ext-skill.md
│   ├── remove-ext-skill.md
│   ├── ext-{plugin}.md
│   ├── setup.md
│   └── help.md
├── references/              # 참조 문서
└── docs/                    # 발표/논문 자료

Top

DMAP 표준은 4개의 핵심 문서와 리소스 카탈로그로 구성됨.

Top

Top

MIT License

Copyright (c) 2026 Unicorn Inc. https://github.com/unicorn-plugins/dmap

Top