---
name: simple-orchestration
description: >
  여러 전문 작업을 연결된 서브에이전트에 나누고 결과를 통합할 때 쓴다.
  독립 작업은 지원되면 병렬로, 앞선 결과가 필요한 작업은 순차로 조정한다.
  위임 도구가 없거나 한 에이전트가 짧게 끝낼 요청은 직접 처리한다.
compatibility: >
  위임이 허용되고 실제 위임 도구와 적합한 에이전트가 제공돼야 한다.
  기능이 없거나 위임 비용이 큰 작업은 직접 수행한다.
---

# 단순 오케스트레이션

요청의 의존성과 완료 조건을 추적하고 서브에이전트 결과를 검증해 통합한다.
위임은 사용자가 요청한 작업과 권한 안에서만 수행한다.

## 판단

다음 조건에서 위임이 검증 품질이나 완료 시간을 개선하는지 판단한다. 조건만으로 위임을 강제하지 않는다.

- 서로 다른 전문 영역이 둘 이상 필요하다.
- 한 결과가 다음 단계의 입력이 되는 다단계 작업이다.
- 여러 서브에이전트 결과 사이의 의존성이나 충돌을 관리해야 한다.

한 에이전트가 짧게 해결할 수 있는 요청은 나누지 말고 직접 처리한다.

## 도구와 실행 환경

위임 허용 여부, 사용 가능한 에이전트, 동시 실행 수, context 전달, 결과·오류·취소 방식을
현재 환경에서 확인한다. 모든 런타임이 같은 도구 이름이나 공유 파일시스템을 갖는다고 가정하지 않는다.
호스트 앱의 `delegate_<name>`·`handoff_<name>`을 사용할 때만
[references/agent-studio.md](references/agent-studio.md)를 읽는다.

## 절차

1. 사용자의 최종 목표와 완료 조건을 한 문장으로 정리한다.
2. 작업을 결과물 기준으로 나누고, **서로 의존하는 것과 아닌 것을 가른다.**
3. 각 단위에 필요한 전문성, 입력, 기대 출력과 검증 기준을 정한다.
4. 연결된 서브에이전트의 description을 비교해 현재 agent보다 적합할 때만 위임한다.
   독립 작업은 지원되는 병렬 호출로, 앞 결과가 필요한 작업은 순차로 실행한다.
5. 결과를 원래 목표와 대조하고, 충돌·누락·근거 부족을 확인한다.
6. 사용자가 바로 쓸 수 있는 하나의 답변으로 통합한다.

## 위임 메시지

전달되는 대화·파일·이미지 범위를 확인하고 요청 자체는 자기완결적으로 작성한다.
공유 작업 공간이면 수정 파일의 담당을 나눠 충돌을 피한다. 순환 위임을 만들지 않으며
동시 실행·깊이·시간 한계에 도달하면 직접 수행하거나 완료하지 못한 범위를 밝힌다.

- 목표, 제약, 기대 출력, 기대 분량을 메시지 안에 담는다.
- 사용자의 전체 대화를 그대로 옮겨 적지는 마라. 필요한 사실만.
- 같은 일을 여러 에이전트에게 중복 요청하지 않는다.
- 결과가 부족하면 필요한 추가 근거나 새 입력을 명시한다. 같은 요청을 그대로 다시 보내지 않는다.
- 적합한 서브에이전트가 없으면 억지로 위임하지 않고 직접 처리한다.
- 실패 원인을 고치거나 직접 처리한다. 부족한 입력이 완료를 막을 때만 확인한다.

## 통합

- 서로 다른 결과가 충돌하면 각 근거를 비교하고 확정할 수 없는 부분을 밝힌다.
- 중간 위임 과정이나 에이전트별 답변을 장황하게 나열하지 않는다.
- 서브에이전트 결과를 검토 없이 그대로 전달하지 않는다.
- 최종 답변은 결론부터 제시하고, 필요한 근거와 남은 제한만 덧붙인다.
- 일부 작업만 완료됐다면 완료된 범위와 남은 작업을 구분한다.
- 통합 답변에 "다음은 통합 결과입니다", "종합하면", "결론적으로", "도움이 되셨기를" 같은
  도입·결산·마무리 문구를 넣지 않는다. 첫 문장이 결론이다.
- 결과는 에이전트 이름보다 사용자의 질문·작업별로 묶는다. 제목·목록·강조는 정보를 찾는 데
  필요한 만큼 쓰고 근거의 출처를 해당 주장에 붙인다.
- 장식적인 대구와 반복되는 완충 표현을 줄인다. 확인한 사실·추정·미확인을 구분하고
  가능성을 확정으로 바꾸지 않는다.

기본 작성은 위 인라인 규칙으로 충분하다. `korean-humanize`가 현재 연결돼 있고 상세
패턴·예시가 필요할 때만 `Skill(skill_name="korean-humanize", file_path="ai-tell-catalog.md")`로
카탈로그를 읽는다. 연결되지 않았으면 저장소 경로로 찾지 않고 인라인 규칙을 따른다.
카탈로그는 참고 기준이며 사용자가 지정한 형식·문체와 결과의 근거를 우선한다.