agent-dispatch

Agent Dispatch

14 업무별 서브에이전트 + 2 메타 에이전트 (총 16) 디스패치 표준 절차.

본 스킬은 규칙/프로세스/에이전트-구성-역할-정의.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 업무별 서브에이전트 매트릭스 + SSoT §4 2 메타 에이전트 참조.

각 에이전트별 상세 SKILL: ~/Workspace/_plugin/amaranth10-claude-forge/skills/a10-{명명-소문자}-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 인용

마크다운 링크 규칙 (필수)

마크다운 파일 작성·업데이트 시 모든 경로·파일 참조는 클릭 가능한 상대 링크로 작성한다.

# 나쁜 예 (클릭 불가)
규칙/프로세스/에이전트-구성-역할-정의.md 인용

# 좋은 예 (클릭 가능)
[규칙/프로세스/에이전트-구성-역할-정의.md](../../../../../Workspace/douzone-forge/규칙/프로세스/에이전트-구성-역할-정의.md) 인용

• 상대 경로는 현재 파일 위치 기준
• 코드블록 안의 폴더 구조 다이어그램은 예외 (링크 불필요)
• 상세 규칙은 douzone-forge CLAUDE.md 의 "마크다운 링크 표기 규칙" 섹션 참조

관련 자산

• SSoT (표준 정의): 규칙/프로세스/에이전트-구성-역할-정의.md
• 자비스 운영 룰 (학습 #20·#21·#22): 규칙/프로세스/자비스-운영-룰.md
• 협업 표준: 규칙/프로세스/코워크-클로드코드-협업-표준.md
• 14 에이전트별 SKILL.md: ~/Workspace/_plugin/amaranth10-claude-forge/skills/a10-{명명-소문자}-agent/SKILL.md