diff --git a/.agents/skills/multi-agent-mux-delegate-job/DELEGATION_TYPES.md b/.agents/skills/multi-agent-mux-delegate-job/DELEGATION_TYPES.md new file mode 100644 index 0000000..e7fdfad --- /dev/null +++ b/.agents/skills/multi-agent-mux-delegate-job/DELEGATION_TYPES.md @@ -0,0 +1,116 @@ +# Task Delegation Types (작업 위임 타입) Design Specification + +이 문서는 `multi-agent-mux-delegate-job` 스킬에 **작업 위임 타입 (Task Delegation Types)**을 정의하고, 단일 에이전트 실행을 넘어 에이전트 협업 구조(루프, 토론 등)를 체계적으로 오케스트레이션하기 위한 설계 명세입니다. + +--- + +## 1. 개요 및 필요성 + +기존의 잡 위임 시스템은 단일 에이전트에 지시사항(Prompt)을 전달하고 완료(`completed`) 또는 에러(`error`) 이벤트를 수신하면 작업을 종료하는 **단방향 직접 위임(Direct)** 구조였습니다. + +하지만 실제 협업 환경에서는 다음과 같은 유형의 고도화된 협업 흐름이 필요합니다: +1. **자료조사 및 토론 (Research & Discussion)**: 계획 수립 또는 개념 검토를 위해 여러 에이전트가 협의에 이를 때까지 논의를 주고받음. +2. **작업자-리뷰어 루프 (Worker-Reviewer Loop)**: 작업자(Worker)가 코드를 수정하면, 리뷰어(Reviewer)가 검토하여 `PASS`를 줄 때까지 피드백 반영 및 수정을 반복함. + +이러한 협업 워크플로우를 개별 에이전트의 내부 코드 수정 없이 **오케스트레이터(위임 스크립트) 레이어에서 제어**할 수 있도록 작업 타입을 도입합니다. + +--- + +## 2. 작업 위임 타입 정의 + +| 타입명 (`--type`) | 설명 | 워크플로우 흐름 | +|------------------|------|----------------| +| `direct` (기본값) | 단일 에이전트에 대한 직접 위임 | 지시 → 에이전트 수행 → 완료/에러 수신 후 종료 | +| `loop` | 작업자-리뷰어 피드백 루프 | 작업자 실행 → 완료 시 리뷰어 자동 호출 → 리뷰 통과 시 종료, 실패 시 피드백과 함께 작업자 재호출 (반복) | +| `discuss` | 자료조사 및 상호 토론 | 에이전트 A(초안 작성) → 에이전트 B(검토 및 의견 제시) → 에이전트 A(반영 및 수정) → 합의 도달 시 종료 | + +--- + +## 3. CLI 명세 확장 + +`multi-agent-mux-delegate-job submit` 명령어에 다음 옵션들이 추가됩니다. + +```bash +multi-agent-mux-delegate-job submit \ + --prompt \ + --agent \ + --agent-session \ + [--type ] \ + [--reviewer ] \ + [--reviewer-session ] \ + [--max-iterations ] \ + [--validate