--- name: agent-dispatch description: > This skill should be used when the user asks "에이전트 투입해줘", "ORACLE 한테 조사시켜", "CIPHER 요구사항 분석 시작", "AEGIS 정합성 검증해", "병렬로 돌려", "팀원 배치", or when dispatching subagents for parallel or sequential tasks. Defines the 14+2 cybertic agent team structure and dispatch protocols, based on SSoT `규칙/프로세스/에이전트-구성-역할-정의.md`. version: 0.2.0 --- # Agent Dispatch 14 업무별 서브에이전트 + 2 메타 에이전트 (총 16) 디스패치 표준 절차. 본 스킬은 [`규칙/프로세스/에이전트-구성-역할-정의.md`](../../../../../Workspace/douzone-forge/규칙/프로세스/에이전트-구성-역할-정의.md) SSoT 의 디스패치 운영본이다. 표준 정의·이론·매트릭스는 SSoT 인용, 본 SKILL 은 디스패치 절차에 집중한다. ## 에이전트 팀 구성 ### 계층 2 — 14 업무별 서브에이전트 | # | 코드 | 명명 | 한글 음역 | 본문 영역 | |---|------|------|----------|----------| | 1 | A1 | **ORACLE** | 오라클 | 시장조사·벤치마킹 | | 2 | A2 | **CIPHER** | 사이퍼 | 요구사항 접수·분석 | | 3 | A3 | **MATRIX** | 매트릭스 | IA 설계 | | 4 | A4 | **VECTOR** | 벡터 | 화면설계·와이어프레임 | | 5 | A5 | **PRISM** | 프리즘 | 디자인 시스템 | | 6 | A6 | **WEAVER** | 위버 | 퍼블리싱 | | 7 | A7 | **CORE** | 코어 | 백엔드 개발 | | 8 | A8 | **NOVA** | 노바 | 프론트엔드 개발 | | 9 | A9 | **SYNAPSE** | 시냅스 | MCP 개발 | | 10 | A10 | **TRACE** | 트레이스 | 검수 시나리오 | | 11 | A11 | **PROBE** | 프로브 | 검수 진행 | | 12 | A12 | **LAUNCH** | 런치 | 배포 | | 13 | A13 | **AEGIS** | 이지스 | 정합성 검증 | | 14 | A14 | **HELM** | 헬름 | 운영 거버넌스 | ### 계층 3 — 2 메타 에이전트 | # | 코드 | 명명 | 한글 음역 | 본문 영역 | |---|------|------|----------|----------| | M1 | M1 | **AVATAR** | 아바타 | 사용자 자비스 (사용자별 분신) | | M2 | M2 | **NEXUS** | 넥서스 | {이름} 자비스 (중추) | 상세 AgentDefinition 표준 필드 매트릭스는 [SSoT §3 14 업무별 서브에이전트 매트릭스](../../../../../Workspace/douzone-forge/규칙/프로세스/에이전트-구성-역할-정의.md) + [SSoT §4 2 메타 에이전트](../../../../../Workspace/douzone-forge/규칙/프로세스/에이전트-구성-역할-정의.md) 참조. 각 에이전트별 상세 SKILL: `~/Workspace/_plugin/douzone-forge/skills/dz-{명명-소문자}-agent/SKILL.md` ## 호환 매트릭스 (변천사) 기존 5-agent 명명 (하준·서연·도윤·지호·수아) 은 본 14 에이전트로 다음과 같이 호환된다. 변천사 보존을 위한 본 매트릭스이며, 신규 디스패치는 14+2 명명으로 진행한다. | 기존 명명 | 기존 역할 | 1:1 매핑 | 추가 호환 영역 (영역 확장) | |---|---|---|---| | A1 하준 | Researcher | **ORACLE** | — | | A2 서연 | Planner | **CIPHER** | — | | A3 도윤 | Designer | **VECTOR** | +PRISM (디자인 시스템) | | A4 지호 | Architect | **CORE** | +NOVA (프론트엔드) +SYNAPSE (MCP 통합) | | A5 수아 | Validator | **AEGIS** | +TRACE (검수 시나리오) +PROBE (검수 진행) | 본 호환 매트릭스는 SSoT §3.3 의 동일 매트릭스를 인용한다. ## 디스패치 규칙 본 디스패치 4 규칙은 SSoT §8.1 디스패치 규칙 인용 + Subagent 4 핵심 가치 (§8.2) 정합 보강이다. ### 4 규칙 1. **한 에이전트에 한 가지 목표만** — 복합 목표 금지. Subagent §전문화 가치 일관 2. **병렬 가능하면 병렬로** — 독립 작업은 동시 투입. Subagent §병렬화 가치 일관 3. **프롬프트에 반드시 포함**: - 최신 의사결정 사항 (`프로젝트/PRJ-NNNN_*/06_의사결정/` 또는 `decision_log.md` 발췌) - 작업 배경과 목적 - 출력 파일 경로와 형식 (Forge 폴더 표준) - **"계획 수립이나 확인 요청 없이 바로 실행하세요"** 문구 4. **결과물은 supervisor 가 취합** — 에이전트 산출을 그대로 전달하지 않고 supervisor (NEXUS 또는 사용자) 가 검토 후 보고 ### 보강 규칙 (Subagent 4 가치) - **도구 제한 명시** — 각 디스패치 시 에이전트별 `tools` 필드 일치 확인 (의도치 않은 동작 위험 감소) - **컨텍스트 격리 보장** — 부모 컨텍스트 누설 회피 (작업지시서 + 산출 위치만 prompt 에 포함) ## 표준 프롬프트 템플릿 에이전트 투입 시 다음 구조를 따른다. 각 에이전트 영역 인스턴스화 가능. ``` 당신은 프로젝트의 {에이전트 명명} ({한글 음역}) 에이전트입니다. 영역: {본문 영역} 계획 수립이나 확인 요청 없이 바로 실행하세요. ## 배경 {프로젝트 배경과 현재 진행 상태} ## 최신 의사결정 (반드시 반영) {decision_log 또는 06_의사결정/ 에서 관련 항목 발췌} ## 임무 {구체적인 작업 내용} ## 입력 {본 에이전트가 받는 입력 자산 경로} ## 산출 {파일 경로와 형식 — Forge 폴더 표준 일관} ## AC 검증 {본 작업의 합격 기준 매트릭스} ``` 본 템플릿은 각 에이전트 SKILL.md 의 AgentDefinition `prompt` 필드 본문을 인스턴스화한 형태이다. ## 출력 경로 매트릭스 (Forge 폴더 표준) 각 에이전트별 표준 출력 위치. 기존 `docs/01~05` 구조는 v0.1.0 변천사 보존만, 신규는 Forge 폴더 표준을 사용한다. | 영역 | 에이전트 | Forge 출력 경로 | |------|---------|-----------------| | 시장조사·벤치마킹 | ORACLE | `프로젝트/PRJ-NNNN_*/01_기획/{날짜}-{주제}-시장조사.md` | | 요구사항 접수·분석 | CIPHER | `프로젝트/PRJ-NNNN_*/01_기획/{날짜}-{주제}-요구사항.md` | | IA 설계 | MATRIX | `프로젝트/PRJ-NNNN_*/02_설계/{날짜}-{주제}-IA.md` | | 화면설계·와이어프레임 | VECTOR | `프로젝트/PRJ-NNNN_*/02_설계/{날짜}-{주제}-화면설계.md` | | 디자인 시스템 | PRISM | `프로젝트/PRJ-NNNN_*/02_설계/{날짜}-{주제}-디자인시스템.md` | | 퍼블리싱 | WEAVER | `프로젝트/PRJ-NNNN_*/03_개발/{날짜}-{주제}-퍼블리싱.md` | | 백엔드 개발 | CORE | `프로젝트/PRJ-NNNN_*/03_개발/{날짜}-{주제}-백엔드.md` | | 프론트엔드 개발 | NOVA | `프로젝트/PRJ-NNNN_*/03_개발/{날짜}-{주제}-프론트엔드.md` | | MCP 개발 | SYNAPSE | `프로젝트/PRJ-NNNN_*/03_개발/{날짜}-{주제}-MCP.md` | | 검수 시나리오 | TRACE | `프로젝트/PRJ-NNNN_*/05_산출물/{날짜}-{주제}-검수시나리오.md` | | 검수 진행 | PROBE | `프로젝트/PRJ-NNNN_*/05_산출물/{날짜}-{주제}-검수결과.md` | | 배포 | LAUNCH | `프로젝트/PRJ-NNNN_*/05_산출물/{날짜}-{주제}-배포.md` | | 정합성 검증 | AEGIS | `프로젝트/PRJ-NNNN_*/05_산출물/{날짜}-{주제}-정합성검증.md` | | 운영 거버넌스 | HELM | `프로젝트/PRJ-NNNN_*/05_산출물/{날짜}-{주제}-거버넌스.md` | ## 호출 예시 ### 시장조사 — ORACLE 단독 ``` 당신은 프로젝트의 ORACLE (오라클) 에이전트입니다. 영역: 시장조사·벤치마킹 계획 수립이나 확인 요청 없이 바로 실행하세요. ## 배경 PRJ-2026-XXX — A10 신규 모듈 검토. ## 최신 의사결정 2026-05-12 기술위원회 — Claude Enterprise 단일 시트 도입 확정. ## 임무 A10 신규 모듈 후보 3건의 시장 동향 조사. ## 입력 모듈 후보 명세 (작업지시서 §2). ## 산출 프로젝트/PRJ-2026-XXX/01_기획/20260512-시장동향-3후보.md (Forge 표준) ## AC 검증 - 후보 3건 각 5 항목 이상 - 출처 10건 이상 - ISO 42001 정합성 검토 1건 포함 ``` ### 다중 병렬 — ORACLE + CIPHER + AEGIS 3 에이전트 독립 작업이라 동시 투입. - ORACLE: 시장조사 - CIPHER: 요구사항 분석 - AEGIS: 두 산출 정합성 검증 (ORACLE·CIPHER 종료 후 순차) → ORACLE · CIPHER 병렬 실행 후 AEGIS 순차 실행. ## 교훈 (실전에서 배운 것) 1. **"바로 실행" 명시 의무** — 에이전트에게 "계획 세워서 확인 받아라" 패턴을 쓰면 불필요한 대기 발생 → "바로 실행"을 반드시 명시 2. **최신 결정 인라인 삽입** — 의사결정 사항을 누락하면 잘못된 가정으로 작업함 → 최신 결정 사항을 프롬프트에 인라인 삽입 3. **하네스 본질 (Initializer + Coding) 적용** — 모든 작업 항목 진입 시 ① Initializer 단계 명시 (작업지시서·INDEX·진행 로그 셋업) + ⑤ Coding 단계 점진 진행 (단일 작업 항목 + AC 검증). 자비스 운영 룰 학습 #20 + SSoT §5 인용 ## 마크다운 링크 규칙 (필수) 마크다운 파일 작성·업데이트 시 **모든 경로·파일 참조는 클릭 가능한 상대 링크**로 작성한다. ```markdown # 나쁜 예 (클릭 불가) 규칙/프로세스/에이전트-구성-역할-정의.md 인용 # 좋은 예 (클릭 가능) [규칙/프로세스/에이전트-구성-역할-정의.md](../../../../../Workspace/douzone-forge/규칙/프로세스/에이전트-구성-역할-정의.md) 인용 ``` - 상대 경로는 현재 파일 위치 기준 - 코드블록 안의 폴더 구조 다이어그램은 예외 (링크 불필요) - 상세 규칙은 douzone-forge CLAUDE.md 의 "마크다운 링크 표기 규칙" 섹션 참조 ## 관련 자산 - SSoT (표준 정의): [`규칙/프로세스/에이전트-구성-역할-정의.md`](../../../../../Workspace/douzone-forge/규칙/프로세스/에이전트-구성-역할-정의.md) - 자비스 운영 룰 (학습 #20·#21·#22): [`규칙/프로세스/자비스-운영-룰.md`](../../../../../Workspace/douzone-forge/규칙/프로세스/자비스-운영-룰.md) - 협업 표준: [`규칙/프로세스/코워크-클로드코드-협업-표준.md`](../../../../../Workspace/douzone-forge/규칙/프로세스/코워크-클로드코드-협업-표준.md) - 14 에이전트별 SKILL.md: `~/Workspace/_plugin/douzone-forge/skills/dz-{명명-소문자}-agent/SKILL.md`