단계	부스팅 스킬	용도
Step 3 (AI 자동 완성)	`/oh-my-claudecode:research`	도메인 지식 리서치로 에이전트 구성 힌트 정확도 향상
Step 4 (사용자 확인)	`/oh-my-claudecode:review`	생성된 팀 기획서 품질 검토
기타 단계	`ulw` 매직 키워드	범용 병렬 실행 폴백

Top

에이전트 호출 규칙

이 스킬은 에이전트를 호출하지 않음. 요구사항 분석, 에이전트 구성 힌트 추천, 공유 자원 매칭 등 모든 분석은 스킬 프롬프트 내에서 직접 수행함.

Top

워크플로우

Step1: 대상 프로젝트 디렉토리 확인, {DMAP_PLUGIN_DIR} 변수 설정

대상 프로젝트 디렉토리 확인

새 플러그인을 생성할 프로젝트 디렉토리를 생성하였고
플러그인 프로젝트 디렉토리에서 {AI_RUNTIME}을 수행하였는지 AskUserQuestion 도구로 문의함.

Yes: AGENTS.md에 현재 디렉토리의 절대 경로를 {PLUGIN_DIR}로 저장
No: 플러그인 프로젝트 디렉토리를 생성하고 그 디렉토리로 이동하여 {AI_RUNTIME}을 수행하도록 안내

{DMAP_PLUGIN_DIR} 변수 설정

{PLUGIN_DIR}/AGENTS.md 파일에 {DMAP_PLUGIN_DIR} 변수가 설정되어 있는지 확인함.
미설정 시 아래 수행 사용자에게 DMAP 플러그인 디렉토리 경로를 입력받아 {PLUGIN_DIR}/AGENTS.md의 {DMAP_PLUGIN_DIR} 변수에 설정합니다.

{"title":"DMAP 플러그인 디렉토리","questions":[ {"question":"DMAP 플러그인 디렉토리 경로를 입력해주세요.","type":"text"} ]}

`{PLUGIN_DIR}/AGENTS.md` 에 다음 변수를 기록하여 이후 중복 계산 방지

## 플러그인 변수 설정 
- AI_RUNTIME: 런타임 종류. (Claude Code, Claude Cowork, Cursor, AntiGravity, Codex 등)
- DMAP_PLUGIN_DIR: DMAP 플러그인의 루트 절대 경로 
- PLUGIN_DIR: 생성할 플러그인의 루트 절대 경로 
- PLUGIN_NAME: 생성할 플러그인 이름. Step4-3에서 결정하여 등록

Step 2: 입력 모드 판별 (`ulw` 활용)

사용자 메시지를 분석하여 Interview 모드 또는 Direct 모드를 결정함.

Direct 모드 활성화 조건 (하나라도 충족 시):

사용자 메시지에 팀 기획서의 필수 항목(플러그인명, 목적, 핵심기능) 중 2개 이상 포함

조건	분기
Direct 모드 조건 충족	Step 4으로 이동
조건 미충족	Step 3 (Interview 모드)로 이동

Step 3: 사용자 인터뷰 -- Interview 모드 (`ulw` 활용)

사용자에게 아래 양식과 샘플을 제공하고 기본정보, 핵심기능, 사용자플로우를 입력하도록 요청함
1)작성양식:

# 팀 기획서

## 기본 정보
- 플러그인명: {영문 kebab-case. 예: my-plugin}
- 목표: {플러그인이 해결하는 문제 또는 달성 목표. 한 줄 요약}
- 대상 도메인: {예: 교육, 개발 자동화, 비즈니스 프로세스, 콘텐츠 제작}
- 대상 사용자: {예: 개발자, 기획자, 디자이너, 도메인 전문가}

## 핵심기능
- {핵심기능1}: {기능 설명}
- {핵심기능2}: {기능 설명}
...

## 사용자 플로우
### {업무명1}
- Step 1. {작업명}: {작업 설명}
- Step 2. {작업명}: {작업 설명}

### {업무명2}
- Step 1. {작업명}: {작업 설명}
- Step 2. {작업명}: {작업 설명}

## 에이전트 구성 힌트 (선택)
- {역할1}: {역할 설명. 예: "코드 작성 전문가", "문서 리뷰어"}
  - {세부역할1-1}: {세부역할 설명}    ← 세부역할이 있는 경우만 (선택)
  - {세부역할1-2}: {세부역할 설명}
- {역할2}: {역할 설명}

2)샘플

# 팀 기획서

## 기본 정보
- 플러그인명: code-reviewer
- 목적: PR(Pull Request) 코드 리뷰를 자동화하여 리뷰 품질과 속도 향상
- 대상 도메인: 소프트웨어 개발
- 대상 사용자: 개발팀 리더, 시니어 개발자

## 핵심기능
- PR 분석: PR의 변경 파일, 커밋 히스토리, 영향 범위 자동 분석
- 코드 리뷰: 코드 품질, 보안, 성능 관점에서 리뷰 코멘트 생성
- 리뷰 보고서: 리뷰 결과를 구조화된 보고서로 출력

## 사용자 플로우
### 코드리뷰
- Step 1. PR 지정: 리뷰할 PR 번호 또는 브랜치 지정
- Step 2. 리뷰 실행: 자동 분석 및 리뷰 수행
- Step 3. 결과 확인: 리뷰 보고서 확인 및 코멘트 반영

## 에이전트 구성 힌트
- 분석가: PR 변경사항과 영향 범위 분석 전문가
  - PR 분석: PR의 변경 파일과 커밋 히스토리 분석
  - 영향도 분석: 변경사항의 영향 범위와 의존성 파악
- 리뷰어: 코드 품질/보안/성능 관점 리뷰 전문가

Step 4: AI 자동 완성 (`ulw` 활용)

수집된 필수 항목을 기반으로 선택 항목(에이전트 구성 힌트, 참고 공유 자원)을 자동 완성함.
이 단계의 모든 분석은 스킬 프롬프트가 직접 수행함.

Step4-1. 에이전트 구성 힌트 추천

핵심기능과 사용자 플로우를 분석하여 적절한 에이전트 역할을 추천함.

각 핵심기능이 필요로 하는 역할 유형 매칭
사용자 플로우의 Step 간 역할 전환 패턴 분석으로 에이전트 분리 필요성 판단
동일 역할의 연속 Step은 하나의 에이전트로 통합 가능 제안
통합된 에이전트 내에서 작업 성격이 구분되면 세부역할(sub-roles)로 분리 제안
- 세부역할 판단 기준: 동일 전문 영역 내에서 워크플로우가 독립적으로 분리되는 경우
- 세부역할 표현: 에이전트 구성 힌트에서 들여쓰기로 표현
각 추천 에이전트에 적합한 4-Tier 모델 제안

참조 가이드:

# 기본 유형
플러그인에서 가장 빈번하게 사용되는 핵심 유형.

| 유형 | 역할 | 권장 티어 | 적합한 작업 |
|------|------|----------|------------|
| **architect** | 분석·설계 전문가 | HIGH | 구조 분석, 설계 결정, 영향 범위 평가, 코드 리뷰 |
| **executor** | 구현 전문가 | MEDIUM | 코드 작성·수정, 기능 구현, 리팩터링 |
| **explorer** | 탐색 전문가 | LOW~MEDIUM | 코드베이스 탐색, 파일 검색, 패턴 파악 |

# 확장 유형
도메인 또는 워크플로우 특성에 따라 추가 선택.

| 유형 | 역할 | 권장 티어 | 적합한 작업 |
|------|------|----------|------------|
| **planner** | 계획 수립 전문가 | HIGH | 전략 수립, 요구사항 분석, 작업 분해 |
| **reviewer** | 검토·비평 전문가 | HIGH | 품질 검증, 계획 비평, 산출물 검토 |
| **researcher** | 조사·수집 전문가 | MEDIUM | 외부 문서 조사, API 문서 검색, 기술 리서치 |
| **writer** | 문서 작성 전문가 | LOW | README, API 문서, 사용자 가이드 작성 |
| **designer** | UI/UX 전문가 | MEDIUM~HIGH | 컴포넌트 설계, 스타일링, 사용자 경험 개선 |
| **tester** | 테스트 전문가 | MEDIUM | 테스트 작성, QA 검증, 버그 재현 |

# 도메인 특화 유형

플러그인 고유 도메인에 맞춰 자유롭게 정의 가능.

| 예시 | 역할 | 설명 |
|------|------|------|
| **scenario-analyst** | 시나리오 분석가 | 비즈니스 시나리오 분석, 위험/기회 요소 도출 |
| **dsl-generator** | DSL 생성기 | 도메인 특화 DSL 코드 자동 생성 |
| **data-processor** | 데이터 처리기 | 데이터 변환, 정제, 통계 분석 |
| **{자유 정의}** | {역할 설명} | 요구사항에 맞는 커스텀 에이전트 |

> 도메인 특화 유형은 이름과 역할을 자유롭게 정의함.
> 에이전트 설계 원칙(역할 단일성, 자율성, 캡슐화)을 준수할 것.

# 유형 선택 가이드

| 질문 | 예 → 유형 |
|------|----------|
| 코드를 작성/수정해야 하는가? | executor |
| 구조를 분석하거나 설계 결정이 필요한가? | architect |
| 코드베이스를 탐색/검색해야 하는가? | explorer |
| 전략적 계획이 필요한가? | planner |
| 산출물을 검토/비평해야 하는가? | reviewer |
| 외부 문서/자료를 조사해야 하는가? | researcher |
| 문서를 작성해야 하는가? | writer |
| 위 유형에 해당하지 않는 도메인 고유 작업인가? | 도메인 특화 유형 정의 |

# 4-Tier 모델
표준 참조: `{DMAP_PLUGIN_DIR}/standards/plugin-standard-agent.md`의 "4-Tier 모델".   
동일 유형을 비용-역량 트레이드오프에 따라 티어별 변형으로 분리 가능.

| 티어 | 모델 등급 | 특성 | 적합한 작업 |
|------|----------|------|------------|
| LOW | Haiku | 빠르고 저비용 | 단건 조회, 간단한 수정 |
| MEDIUM | Sonnet | 균형 | 기능 구현, 일반 분석 |
| HIGH | Opus | 최고 역량 | 복잡한 의사결정, 심층 분석 |
| HEAVY | Opus (대규모) | 최고 역량 + 대규모 예산 | 장시간 추론, 대규모 멀티파일 작업 |

> 하나의 역할에 대해 티어별 변형 에이전트를 만들 수 있음.
> 예: `executor` (MEDIUM) + `executor-high` (HIGH)

Step4-2. 공유 자원 매칭

{DMAP_PLUGIN_DIR}/resources/plugin-resources.md 카탈로그를 읽어 필요한 자원을 선정함.
{DMAP_PLUGIN_DIR}/resources/guides/combine-prompt.md는 반드시 추가
자원유형 파악: 가이드, 템플릿, 샘플, 도구로 구분하여 필요한 자원 유형 결정
자원명 파악:
- 가이드: '가이드명' 컬럼
- 템플릿: '템플릿명' 컬럼
- 샘플: '샘플명' 컬럼
- 도구: '도구명' 컬럼
자원 경로 파악:
- 가이드, 템플릿, 샘플: {DMAP_PLUGIN_DIR}/resources/{상세컬럼 경로}가 자원 경로임
- 도구:
  - {DMAP_PLUGIN_DIR}/resources/tools/{상세컬럼 경로}에 있는 도구 설명서 읽음
  - {DMAP_PLUGIN_DIR}/resources/tools/{도구 설명서의 '## 기본 정보' 섹션 '소스 경로'}가 자원경로임

공유자원 매핑 테이블 작성

| 자원 유형 | 자원명 | 자원 경로 |
|----------|--------|------------|
| {자원유형} | {자원명} | {자원경로} |

예제)

| 자원 유형 | 자원명 | 자원 경로 |
|----------|--------|------------|
| 가이드 | dify-workflow-dsl-guide | {DMAP_PLUGIN_DIR}/resources/guides/dify/dify-workflow-dsl-guide.md |
| 템플릿 | dsl-generation-prompt | {DMAP_PLUGIN_DIR}/resources/templates/dify/dsl-generation-prompt.md |
| 샘플 | README | {DMAP_PLUGIN_DIR}/resources/samples/plugin/README.md |
| 도구 | generate_image | {DMAP_PLUGIN_DIR}/resources/tools/generate_image.py |

매칭 결과 없음 시:

"해당 자원 없음 -- 플러그인 개발 시 직접 작성 필요" 안내
유사한 자원이 있으면 참고용으로 제안

Step4-2-A. MS-Office 산출물 형식 감지·자동 매칭

## 핵심기능, ## 사용자 플로우, 산출물·결과물 항목을 스캔하여 다음 키워드가 1개 이상 포함되면 office 카테고리 자원을 자동 등록함.

형식	감지 키워드
pptx	"PPT", "프리젠테이션", "파워포인트", "발표 자료", "슬라이드", ".pptx", "PowerPoint"
xlsx	"엑셀", "스프레드시트", "강의계획서", "보고 양식", ".xlsx", "Excel"
docx	"워드", "보고서", "문서", "제안서", ".docx", "Word"

감지된 형식별 자동 매칭 (공유자원 매핑 테이블에 자동 추가):

감지 형식	가이드	템플릿	샘플
pptx	pptx-build-guide (스타일+빌드규칙 통합)	pptx-spec-writer-AGENT, pptx-builder-SKILL	pptx-build-sample
xlsx	xlsx-build-guide	xlsx-builder-SKILL	xlsx-build-sample
docx	docx-build-guide	docx-builder-SKILL	docx-build-sample

에이전트 구성 힌트 자동 보강:

pptx 감지 시: 에이전트 구성에 pptx-spec-writer 역할 자동 추가 (시각 명세 작성 전담, 티어 MEDIUM)
xlsx/docx: 별도 spec-writer 에이전트 추가 안 함 (빌더 스킬이 입력 직수신)

감지 결과 사용자 보고 (필수):

"MS-Office 산출물 감지: {형식 목록}. 형식별 표준 패턴(pptx 2단계 / xlsx·docx 1단계)에 따라 가이드·템플릿·샘플 N건을 공유자원에 자동 등록함. develop-plugin이 이 매핑을 그대로 활용하여 빌더 스킬과 (해당 시) spec-writer 에이전트를 구성함."

감지 안 됨 처리:

키워드 미감지 시 본 단계 건너뜀 (무동작, 기존 Step4-2 결과 그대로)
사용자가 수동으로 office 산출물 의도를 표현하면 AskUserQuestion으로 확인 후 매핑 추가 가능

Step4-3. 기획서 초안 생성

수집된 필수 항목 + 자동 완성된 선택 항목을 조합하여
팀 기획서 초안을 {PLUGIN_DIR}/output/team-plan-{플러그인명}.md에 생성함.

# 팀 기획서

## 기본 정보
- 플러그인명: {영문 kebab-case. 예: my-plugin}
- 목표: {플러그인이 해결하는 문제 또는 달성 목표. 한 줄 요약}
- 대상 도메인: {예: 교육, 개발 자동화, 비즈니스 프로세스, 콘텐츠 제작}
- 대상 사용자: {예: 개발자, 기획자, 디자이너, 도메인 전문가}

## 핵심기능
- {핵심기능1}: {기능 설명}
- {핵심기능2}: {기능 설명}
...

## 사용자 플로우
### {업무명1}
- Step 1. {작업명}: {작업 설명}
- Step 2. {작업명}: {작업 설명}

### {업무명2}
- Step 1. {작업명}: {작업 설명}
- Step 2. {작업명}: {작업 설명}

## 에이전트 구성
- {역할1}: {역할 설명. 예: "코드 작성 전문가", "문서 리뷰어"}
  - {세부역할1-1}: {세부역할 설명}    ← 세부역할이 있는 경우만 (선택)
  - {세부역할1-2}: {세부역할 설명}
- {역할2}: {역할 설명}

## 공유자원 
  | 자원 유형 | 자원명 | 자원 경로 |
  |----------|--------|------------|
  | {자원유형} | {자원명} | {자원경로} |

(중요) AGENTS.md에 {PLUGIN_NAME} 변수 등록

Step 5: 사용자 확인 및 수정 (`ulw` 활용)

생성된 기획서 초안을 사용자에게 제시하고 확인을 요청함.

에이전트 구성 힌트의 추천 근거를 함께 설명
참고 공유 자원의 매칭 이유를 함께 설명
수정 요청 시 해당 부분을 반영하고 재확인
사용자가 승인하면 Step 6으로 진행

Step 6: 기획서 저장 (`ulw` 활용)

사용자의 피드백을 추가하여 완성된 팀 기획서를 파일로 저장함.

{PLUGIN_DIR}/output/team-plan-{PLUGIN_NAME}.md 파일을 덮어씀
사용자에게 완료 안내 및 플러그인 개발 전환 문의:
- 저장 경로 안내
- 사용자에게 "바로 플러그인 개발을 시작할까요?" 문의
- 동의 시: CHAIN>>>/dmap:develop-plugin 출력으로 스킬 전환 (팀 기획서 경로 전달)
- 거절 시: "나중에 /dmap:develop-plugin으로 언제든 개발 시작 가능합니다" 안내

Top

에러 처리

상황	대응
필수 항목 입력이 불완전	부족한 항목을 구체적으로 안내하고 재질문
인터뷰 중 취소 요청	수집된 내용을 `{PLUGIN_DIR}/output/team-plan-draft.md`에 임시 저장 후 안내

Top

품질 기준

에이전트 구성 힌트 추천 시 근거(기능 특성 → 유형 매칭)를 명시할 것
공유 자원 매칭 시 적합성 이유를 명시할 것
모든 필수 항목이 빠짐없이 포함될 것

Top

계획 저장

결과 파일: {PLUGIN_DIR}/output/team-plan-{PLUGIN_NAME}.md

Top

MUST 규칙

#	규칙
1	필수 항목(플러그인명, 목적, 핵심기능, 사용자 플로우) 누락 시 반드시 문의
2	에이전트 구성 힌트 추천 시 근거(기능 특성 → 유형 매칭)를 명시
3	공유 자원 매칭 시 적합성 이유를 명시
5	기획서 저장 전 반드시 사용자 확인(승인) 획득

Top

MUST NOT 규칙

#	금지 사항
1	에이전트를 호출하지 않음 — 모든 분석은 스킬 프롬프트 내에서 직접 수행
2	사용자가 입력하지 않은 필수 항목을 임의로 추정/생성하지 않음

Top

검증 체크리스트

Interview 모드와 Direct 모드 분기 로직이 명확한가
AskUserQuestion 도구 활용이 명시되어 있는가
에이전트 구성 힌트 추천에 4-Tier 모델 참조가 포함되는가

Top

name	team-planner
description	팀 기획서 작성 지원 (AI 자동 완성)
user-invocable	true
type	orchestrator

Team Planner

목표

Top

활성화 조건

슬래시 명령: /dmap:team-planner
자연어 키워드: "AI팀 기획", "AI 팀기획서 작성"

Top

참조

문서	경로	용도
리소스 마켓플레이스	`{DMAP_PLUGIN_DIR}/resources/plugin-resources.md`	공유 자원 카탈로그

Top

스킬 부스팅

단계	부스팅 스킬	용도
Step 3 (AI 자동 완성)	`/oh-my-claudecode:research`	도메인 지식 리서치로 에이전트 구성 힌트 정확도 향상
Step 4 (사용자 확인)	`/oh-my-claudecode:review`	생성된 팀 기획서 품질 검토
기타 단계	`ulw` 매직 키워드	범용 병렬 실행 폴백

Top

에이전트 호출 규칙

이 스킬은 에이전트를 호출하지 않음. 요구사항 분석, 에이전트 구성 힌트 추천, 공유 자원 매칭 등 모든 분석은 스킬 프롬프트 내에서 직접 수행함.

Top

워크플로우

Step1: 대상 프로젝트 디렉토리 확인, {DMAP_PLUGIN_DIR} 변수 설정

대상 프로젝트 디렉토리 확인

새 플러그인을 생성할 프로젝트 디렉토리를 생성하였고
플러그인 프로젝트 디렉토리에서 {AI_RUNTIME}을 수행하였는지 AskUserQuestion 도구로 문의함.

Yes: AGENTS.md에 현재 디렉토리의 절대 경로를 {PLUGIN_DIR}로 저장
No: 플러그인 프로젝트 디렉토리를 생성하고 그 디렉토리로 이동하여 {AI_RUNTIME}을 수행하도록 안내

{DMAP_PLUGIN_DIR} 변수 설정

{"title":"DMAP 플러그인 디렉토리","questions":[ {"question":"DMAP 플러그인 디렉토리 경로를 입력해주세요.","type":"text"} ]}

`{PLUGIN_DIR}/AGENTS.md` 에 다음 변수를 기록하여 이후 중복 계산 방지

## 플러그인 변수 설정 
- AI_RUNTIME: 런타임 종류. (Claude Code, Claude Cowork, Cursor, AntiGravity, Codex 등)
- DMAP_PLUGIN_DIR: DMAP 플러그인의 루트 절대 경로 
- PLUGIN_DIR: 생성할 플러그인의 루트 절대 경로 
- PLUGIN_NAME: 생성할 플러그인 이름. Step4-3에서 결정하여 등록

Step 2: 입력 모드 판별 (`ulw` 활용)

사용자 메시지를 분석하여 Interview 모드 또는 Direct 모드를 결정함.

Direct 모드 활성화 조건 (하나라도 충족 시):

사용자 메시지에 팀 기획서의 필수 항목(플러그인명, 목적, 핵심기능) 중 2개 이상 포함

조건	분기
Direct 모드 조건 충족	Step 4으로 이동
조건 미충족	Step 3 (Interview 모드)로 이동

Step 3: 사용자 인터뷰 -- Interview 모드 (`ulw` 활용)

사용자에게 아래 양식과 샘플을 제공하고 기본정보, 핵심기능, 사용자플로우를 입력하도록 요청함
1)작성양식:

# 팀 기획서

## 기본 정보
- 플러그인명: {영문 kebab-case. 예: my-plugin}
- 목표: {플러그인이 해결하는 문제 또는 달성 목표. 한 줄 요약}
- 대상 도메인: {예: 교육, 개발 자동화, 비즈니스 프로세스, 콘텐츠 제작}
- 대상 사용자: {예: 개발자, 기획자, 디자이너, 도메인 전문가}

## 핵심기능
- {핵심기능1}: {기능 설명}
- {핵심기능2}: {기능 설명}
...

## 사용자 플로우
### {업무명1}
- Step 1. {작업명}: {작업 설명}
- Step 2. {작업명}: {작업 설명}

### {업무명2}
- Step 1. {작업명}: {작업 설명}
- Step 2. {작업명}: {작업 설명}

## 에이전트 구성 힌트 (선택)
- {역할1}: {역할 설명. 예: "코드 작성 전문가", "문서 리뷰어"}
  - {세부역할1-1}: {세부역할 설명}    ← 세부역할이 있는 경우만 (선택)
  - {세부역할1-2}: {세부역할 설명}
- {역할2}: {역할 설명}

2)샘플

# 팀 기획서

## 기본 정보
- 플러그인명: code-reviewer
- 목적: PR(Pull Request) 코드 리뷰를 자동화하여 리뷰 품질과 속도 향상
- 대상 도메인: 소프트웨어 개발
- 대상 사용자: 개발팀 리더, 시니어 개발자

## 핵심기능
- PR 분석: PR의 변경 파일, 커밋 히스토리, 영향 범위 자동 분석
- 코드 리뷰: 코드 품질, 보안, 성능 관점에서 리뷰 코멘트 생성
- 리뷰 보고서: 리뷰 결과를 구조화된 보고서로 출력

## 사용자 플로우
### 코드리뷰
- Step 1. PR 지정: 리뷰할 PR 번호 또는 브랜치 지정
- Step 2. 리뷰 실행: 자동 분석 및 리뷰 수행
- Step 3. 결과 확인: 리뷰 보고서 확인 및 코멘트 반영

## 에이전트 구성 힌트
- 분석가: PR 변경사항과 영향 범위 분석 전문가
  - PR 분석: PR의 변경 파일과 커밋 히스토리 분석
  - 영향도 분석: 변경사항의 영향 범위와 의존성 파악
- 리뷰어: 코드 품질/보안/성능 관점 리뷰 전문가

Step 4: AI 자동 완성 (`ulw` 활용)

수집된 필수 항목을 기반으로 선택 항목(에이전트 구성 힌트, 참고 공유 자원)을 자동 완성함.
이 단계의 모든 분석은 스킬 프롬프트가 직접 수행함.

Step4-1. 에이전트 구성 힌트 추천

핵심기능과 사용자 플로우를 분석하여 적절한 에이전트 역할을 추천함.

각 핵심기능이 필요로 하는 역할 유형 매칭
사용자 플로우의 Step 간 역할 전환 패턴 분석으로 에이전트 분리 필요성 판단
동일 역할의 연속 Step은 하나의 에이전트로 통합 가능 제안
통합된 에이전트 내에서 작업 성격이 구분되면 세부역할(sub-roles)로 분리 제안
- 세부역할 판단 기준: 동일 전문 영역 내에서 워크플로우가 독립적으로 분리되는 경우
- 세부역할 표현: 에이전트 구성 힌트에서 들여쓰기로 표현
각 추천 에이전트에 적합한 4-Tier 모델 제안

참조 가이드:

# 기본 유형
플러그인에서 가장 빈번하게 사용되는 핵심 유형.

| 유형 | 역할 | 권장 티어 | 적합한 작업 |
|------|------|----------|------------|
| **architect** | 분석·설계 전문가 | HIGH | 구조 분석, 설계 결정, 영향 범위 평가, 코드 리뷰 |
| **executor** | 구현 전문가 | MEDIUM | 코드 작성·수정, 기능 구현, 리팩터링 |
| **explorer** | 탐색 전문가 | LOW~MEDIUM | 코드베이스 탐색, 파일 검색, 패턴 파악 |

# 확장 유형
도메인 또는 워크플로우 특성에 따라 추가 선택.

| 유형 | 역할 | 권장 티어 | 적합한 작업 |
|------|------|----------|------------|
| **planner** | 계획 수립 전문가 | HIGH | 전략 수립, 요구사항 분석, 작업 분해 |
| **reviewer** | 검토·비평 전문가 | HIGH | 품질 검증, 계획 비평, 산출물 검토 |
| **researcher** | 조사·수집 전문가 | MEDIUM | 외부 문서 조사, API 문서 검색, 기술 리서치 |
| **writer** | 문서 작성 전문가 | LOW | README, API 문서, 사용자 가이드 작성 |
| **designer** | UI/UX 전문가 | MEDIUM~HIGH | 컴포넌트 설계, 스타일링, 사용자 경험 개선 |
| **tester** | 테스트 전문가 | MEDIUM | 테스트 작성, QA 검증, 버그 재현 |

# 도메인 특화 유형

플러그인 고유 도메인에 맞춰 자유롭게 정의 가능.

| 예시 | 역할 | 설명 |
|------|------|------|
| **scenario-analyst** | 시나리오 분석가 | 비즈니스 시나리오 분석, 위험/기회 요소 도출 |
| **dsl-generator** | DSL 생성기 | 도메인 특화 DSL 코드 자동 생성 |
| **data-processor** | 데이터 처리기 | 데이터 변환, 정제, 통계 분석 |
| **{자유 정의}** | {역할 설명} | 요구사항에 맞는 커스텀 에이전트 |

> 도메인 특화 유형은 이름과 역할을 자유롭게 정의함.
> 에이전트 설계 원칙(역할 단일성, 자율성, 캡슐화)을 준수할 것.

# 유형 선택 가이드

| 질문 | 예 → 유형 |
|------|----------|
| 코드를 작성/수정해야 하는가? | executor |
| 구조를 분석하거나 설계 결정이 필요한가? | architect |
| 코드베이스를 탐색/검색해야 하는가? | explorer |
| 전략적 계획이 필요한가? | planner |
| 산출물을 검토/비평해야 하는가? | reviewer |
| 외부 문서/자료를 조사해야 하는가? | researcher |
| 문서를 작성해야 하는가? | writer |
| 위 유형에 해당하지 않는 도메인 고유 작업인가? | 도메인 특화 유형 정의 |

# 4-Tier 모델
표준 참조: `{DMAP_PLUGIN_DIR}/standards/plugin-standard-agent.md`의 "4-Tier 모델".   
동일 유형을 비용-역량 트레이드오프에 따라 티어별 변형으로 분리 가능.

| 티어 | 모델 등급 | 특성 | 적합한 작업 |
|------|----------|------|------------|
| LOW | Haiku | 빠르고 저비용 | 단건 조회, 간단한 수정 |
| MEDIUM | Sonnet | 균형 | 기능 구현, 일반 분석 |
| HIGH | Opus | 최고 역량 | 복잡한 의사결정, 심층 분석 |
| HEAVY | Opus (대규모) | 최고 역량 + 대규모 예산 | 장시간 추론, 대규모 멀티파일 작업 |

> 하나의 역할에 대해 티어별 변형 에이전트를 만들 수 있음.
> 예: `executor` (MEDIUM) + `executor-high` (HIGH)

Step4-2. 공유 자원 매칭

{DMAP_PLUGIN_DIR}/resources/plugin-resources.md 카탈로그를 읽어 필요한 자원을 선정함.
{DMAP_PLUGIN_DIR}/resources/guides/combine-prompt.md는 반드시 추가
자원유형 파악: 가이드, 템플릿, 샘플, 도구로 구분하여 필요한 자원 유형 결정
자원명 파악:
- 가이드: '가이드명' 컬럼
- 템플릿: '템플릿명' 컬럼
- 샘플: '샘플명' 컬럼
- 도구: '도구명' 컬럼
자원 경로 파악:
- 가이드, 템플릿, 샘플: {DMAP_PLUGIN_DIR}/resources/{상세컬럼 경로}가 자원 경로임
- 도구:
  - {DMAP_PLUGIN_DIR}/resources/tools/{상세컬럼 경로}에 있는 도구 설명서 읽음
  - {DMAP_PLUGIN_DIR}/resources/tools/{도구 설명서의 '## 기본 정보' 섹션 '소스 경로'}가 자원경로임

공유자원 매핑 테이블 작성

| 자원 유형 | 자원명 | 자원 경로 |
|----------|--------|------------|
| {자원유형} | {자원명} | {자원경로} |

예제)

| 자원 유형 | 자원명 | 자원 경로 |
|----------|--------|------------|
| 가이드 | dify-workflow-dsl-guide | {DMAP_PLUGIN_DIR}/resources/guides/dify/dify-workflow-dsl-guide.md |
| 템플릿 | dsl-generation-prompt | {DMAP_PLUGIN_DIR}/resources/templates/dify/dsl-generation-prompt.md |
| 샘플 | README | {DMAP_PLUGIN_DIR}/resources/samples/plugin/README.md |
| 도구 | generate_image | {DMAP_PLUGIN_DIR}/resources/tools/generate_image.py |

매칭 결과 없음 시:

"해당 자원 없음 -- 플러그인 개발 시 직접 작성 필요" 안내
유사한 자원이 있으면 참고용으로 제안

Step4-2-A. MS-Office 산출물 형식 감지·자동 매칭

## 핵심기능, ## 사용자 플로우, 산출물·결과물 항목을 스캔하여 다음 키워드가 1개 이상 포함되면 office 카테고리 자원을 자동 등록함.

형식	감지 키워드
pptx	"PPT", "프리젠테이션", "파워포인트", "발표 자료", "슬라이드", ".pptx", "PowerPoint"
xlsx	"엑셀", "스프레드시트", "강의계획서", "보고 양식", ".xlsx", "Excel"
docx	"워드", "보고서", "문서", "제안서", ".docx", "Word"

감지된 형식별 자동 매칭 (공유자원 매핑 테이블에 자동 추가):

감지 형식	가이드	템플릿	샘플
pptx	pptx-build-guide (스타일+빌드규칙 통합)	pptx-spec-writer-AGENT, pptx-builder-SKILL	pptx-build-sample
xlsx	xlsx-build-guide	xlsx-builder-SKILL	xlsx-build-sample
docx	docx-build-guide	docx-builder-SKILL	docx-build-sample

에이전트 구성 힌트 자동 보강:

pptx 감지 시: 에이전트 구성에 pptx-spec-writer 역할 자동 추가 (시각 명세 작성 전담, 티어 MEDIUM)
xlsx/docx: 별도 spec-writer 에이전트 추가 안 함 (빌더 스킬이 입력 직수신)

감지 결과 사용자 보고 (필수):

"MS-Office 산출물 감지: {형식 목록}. 형식별 표준 패턴(pptx 2단계 / xlsx·docx 1단계)에 따라 가이드·템플릿·샘플 N건을 공유자원에 자동 등록함. develop-plugin이 이 매핑을 그대로 활용하여 빌더 스킬과 (해당 시) spec-writer 에이전트를 구성함."

감지 안 됨 처리:

키워드 미감지 시 본 단계 건너뜀 (무동작, 기존 Step4-2 결과 그대로)
사용자가 수동으로 office 산출물 의도를 표현하면 AskUserQuestion으로 확인 후 매핑 추가 가능

Step4-3. 기획서 초안 생성

수집된 필수 항목 + 자동 완성된 선택 항목을 조합하여
팀 기획서 초안을 {PLUGIN_DIR}/output/team-plan-{플러그인명}.md에 생성함.

# 팀 기획서

## 기본 정보
- 플러그인명: {영문 kebab-case. 예: my-plugin}
- 목표: {플러그인이 해결하는 문제 또는 달성 목표. 한 줄 요약}
- 대상 도메인: {예: 교육, 개발 자동화, 비즈니스 프로세스, 콘텐츠 제작}
- 대상 사용자: {예: 개발자, 기획자, 디자이너, 도메인 전문가}

## 핵심기능
- {핵심기능1}: {기능 설명}
- {핵심기능2}: {기능 설명}
...

## 사용자 플로우
### {업무명1}
- Step 1. {작업명}: {작업 설명}
- Step 2. {작업명}: {작업 설명}

### {업무명2}
- Step 1. {작업명}: {작업 설명}
- Step 2. {작업명}: {작업 설명}

## 에이전트 구성
- {역할1}: {역할 설명. 예: "코드 작성 전문가", "문서 리뷰어"}
  - {세부역할1-1}: {세부역할 설명}    ← 세부역할이 있는 경우만 (선택)
  - {세부역할1-2}: {세부역할 설명}
- {역할2}: {역할 설명}

## 공유자원 
  | 자원 유형 | 자원명 | 자원 경로 |
  |----------|--------|------------|
  | {자원유형} | {자원명} | {자원경로} |

(중요) AGENTS.md에 {PLUGIN_NAME} 변수 등록

Step 5: 사용자 확인 및 수정 (`ulw` 활용)

생성된 기획서 초안을 사용자에게 제시하고 확인을 요청함.

에이전트 구성 힌트의 추천 근거를 함께 설명
참고 공유 자원의 매칭 이유를 함께 설명
수정 요청 시 해당 부분을 반영하고 재확인
사용자가 승인하면 Step 6으로 진행

Step 6: 기획서 저장 (`ulw` 활용)

사용자의 피드백을 추가하여 완성된 팀 기획서를 파일로 저장함.

{PLUGIN_DIR}/output/team-plan-{PLUGIN_NAME}.md 파일을 덮어씀
사용자에게 완료 안내 및 플러그인 개발 전환 문의:
- 저장 경로 안내
- 사용자에게 "바로 플러그인 개발을 시작할까요?" 문의
- 동의 시: CHAIN>>>/dmap:develop-plugin 출력으로 스킬 전환 (팀 기획서 경로 전달)
- 거절 시: "나중에 /dmap:develop-plugin으로 언제든 개발 시작 가능합니다" 안내

Top

에러 처리

상황	대응
필수 항목 입력이 불완전	부족한 항목을 구체적으로 안내하고 재질문
인터뷰 중 취소 요청	수집된 내용을 `{PLUGIN_DIR}/output/team-plan-draft.md`에 임시 저장 후 안내

Top

품질 기준

에이전트 구성 힌트 추천 시 근거(기능 특성 → 유형 매칭)를 명시할 것
공유 자원 매칭 시 적합성 이유를 명시할 것
모든 필수 항목이 빠짐없이 포함될 것

Top

계획 저장

결과 파일: {PLUGIN_DIR}/output/team-plan-{PLUGIN_NAME}.md

Top

MUST 규칙

#	규칙
1	필수 항목(플러그인명, 목적, 핵심기능, 사용자 플로우) 누락 시 반드시 문의
2	에이전트 구성 힌트 추천 시 근거(기능 특성 → 유형 매칭)를 명시
3	공유 자원 매칭 시 적합성 이유를 명시
5	기획서 저장 전 반드시 사용자 확인(승인) 획득

Top

MUST NOT 규칙

#	금지 사항
1	에이전트를 호출하지 않음 — 모든 분석은 스킬 프롬프트 내에서 직접 수행
2	사용자가 입력하지 않은 필수 항목을 임의로 추정/생성하지 않음

Top

검증 체크리스트

Interview 모드와 Direct 모드 분기 로직이 명확한가
AskUserQuestion 도구 활용이 명시되어 있는가
에이전트 구성 힌트 추천에 4-Tier 모델 참조가 포함되는가

Top

team-planner

이 저장소의 다른 Skills

이 저장소의 다른 Skills

Team Planner

목표

활성화 조건

참조

스킬 부스팅

에이전트 호출 규칙

워크플로우

Step1: 대상 프로젝트 디렉토리 확인, {DMAP_PLUGIN_DIR} 변수 설정

대상 프로젝트 디렉토리 확인

{DMAP_PLUGIN_DIR} 변수 설정

{PLUGIN_DIR}/AGENTS.md 에 다음 변수를 기록하여 이후 중복 계산 방지

Step 2: 입력 모드 판별 (ulw 활용)

Step 3: 사용자 인터뷰 -- Interview 모드 (ulw 활용)

Step 4: AI 자동 완성 (ulw 활용)

Step4-1. 에이전트 구성 힌트 추천

Step4-2. 공유 자원 매칭

Step4-2-A. MS-Office 산출물 형식 감지·자동 매칭

Step4-3. 기획서 초안 생성

Step 5: 사용자 확인 및 수정 (ulw 활용)

Step 6: 기획서 저장 (ulw 활용)

에러 처리

품질 기준

계획 저장

MUST 규칙

MUST NOT 규칙

검증 체크리스트

Team Planner

목표

활성화 조건

참조

스킬 부스팅

에이전트 호출 규칙

워크플로우

Step1: 대상 프로젝트 디렉토리 확인, {DMAP_PLUGIN_DIR} 변수 설정

대상 프로젝트 디렉토리 확인

{DMAP_PLUGIN_DIR} 변수 설정

{PLUGIN_DIR}/AGENTS.md 에 다음 변수를 기록하여 이후 중복 계산 방지

Step 2: 입력 모드 판별 (ulw 활용)

Step 3: 사용자 인터뷰 -- Interview 모드 (ulw 활용)

Step 4: AI 자동 완성 (ulw 활용)

Step4-1. 에이전트 구성 힌트 추천

Step4-2. 공유 자원 매칭

Step4-2-A. MS-Office 산출물 형식 감지·자동 매칭

Step4-3. 기획서 초안 생성

Step 5: 사용자 확인 및 수정 (ulw 활용)

Step 6: 기획서 저장 (ulw 활용)

에러 처리

품질 기준

계획 저장

MUST 규칙

MUST NOT 규칙

검증 체크리스트

`{PLUGIN_DIR}/AGENTS.md` 에 다음 변수를 기록하여 이후 중복 계산 방지

Step 2: 입력 모드 판별 (`ulw` 활용)

Step 3: 사용자 인터뷰 -- Interview 모드 (`ulw` 활용)

Step 4: AI 자동 완성 (`ulw` 활용)

Step 5: 사용자 확인 및 수정 (`ulw` 활용)

Step 6: 기획서 저장 (`ulw` 활용)

`{PLUGIN_DIR}/AGENTS.md` 에 다음 변수를 기록하여 이후 중복 계산 방지

Step 2: 입력 모드 판별 (`ulw` 활용)

Step 3: 사용자 인터뷰 -- Interview 모드 (`ulw` 활용)

Step 4: AI 자동 완성 (`ulw` 활용)

Step 5: 사용자 확인 및 수정 (`ulw` 활용)

Step 6: 기획서 저장 (`ulw` 활용)