CCAR-P 개념 카드

■ orchestrator-worker 위임

orchestrator-worker delegation : 목표·형식·도구·경계 · 노력 배분 · 결과 압축1.4 본편

표시가 없는 문장은 공식 문서에서 확인한 내용이에요. 다른 표시는 읽는 법

왜 배우나 — 시험이 요구하는 것

시험 목표 1.4 멀티 에이전트와 조율 · D1 설계 17%
Design multi-agent systems and orchestration strategies

이 개념으로 푸는 판단 (할 수 있어야 하는 것)

  • 1.4② orchestrator 는 subagent 에게 무엇을 넘겨야 하나? — 위임 지시와 일의 양 배분
  • 1.5① 미리 쪼갤 수 있나, 실행하며 쪼개야 하나? — 정적 분해(코드가 미리 나눔 — 체이닝·나눠 돌리기) vs 동적 분해(orchestrator 가 입력을 보고 나눔)
  • 2.4② 긴 에이전트 작업에서 창이 차오른다 — 무엇을 남기고 무엇을 밖으로 빼나? — 컨텍스트 관리 수단 (사전 로드 vs 그때 가져오기 · 컴팩션 · 구조화 메모 · 서브에이전트 요약)

한눈에

멀티로 가기로 했으면 "어떻게 맡기나" 를 정한다. orchestrator(lead agent)가 질문을 쪼개 subagent 마다 지시를 적어 준다. subagent 는 자기 컨텍스트에서 찾은 뒤 압축해 돌려준다

쓸지 말지는 ◆ 단일 vs 멀티 에이전트 에서 다룬다. 여기서는 지시·개수·결과 받기를 다룬다

비유 Jira 티켓에 완료 조건·범위·산출물 형식을 적는 것과 같다. "알아서 조사" 티켓은 중복 작업이 된다

orchestrator 가 subagent 에게 목표·출력 형식·쓸 도구와 출처·작업 경계를 적어 맡기고, subagent 는 압축 요약만 돌려준다는 그림. 한 줄 지시면 일이 겹치거나 빈다.
그림으로 보기 (AI 생성 · Codex · 누르면 크게)

ELI5

반장이 친구들에게 모둠 숙제를 나눠 주는 거예요.

  • "숙제 해 와" 한마디면 둘이 같은 걸 해 와요.
  • "너는 무엇을, 어떤 모양으로, 어디서 찾아, 여기까지만" 이라고 말해 줘야 해요.
  • 쉬운 숙제에 친구 열 명을 부르면 시끄럽기만 해요.
  • 친구들은 찾은 걸 한 장으로 줄여서 줘요. 큰 그림은 사물함에 두고 "사물함 3번"이라고만 말해요.

개념 설명

영상 — subagent 는 무엇을 보고 일할까? (약 47초 · 소리 없음 · 자막). subagent 12개 · 요약 1,500 토큰(흔히 1천~2천의 가운데) · 창 20만(연구 글 기준)은 설명의 계산 예 작은 화면에서는 전체화면(⛶)으로 보세요.

원리

왜 지시를 적어야 하나

  • subagent 는 orchestrator 의 대화를 못 본다. 받는 것은 orchestrator 가 쓴 지시뿐이다 (Agent SDK 에서는 Agent 도구 프롬프트 문자열뿐이다).
  • 그래서 지시의 질이 곧 subagent 의 성능이다. 목표·출력 형식·도구와 출처·경계 중 하나가 빠지면 일이 겹치거나 빈다.

왜 개수를 정해 줘야 하나

  • 에이전트는 알맞은 노력을 스스로 잘 못 정한다. 그래서 단순 질문에 subagent 50개 같은 과잉이 생긴다.
  • 멀티는 토큰을 채팅의 약 15배 쓴다. 그래서 subagent 수가 곧 비용이다. 난도별 규모 규칙을 프롬프트에 박아 둔다.

왜 압축해서 받나

  • 검색의 본질은 압축이다. subagent 가 각자 컨텍스트 창에서 수만 토큰을 뒤지고 핵심만 돌려줘야 orchestrator 컨텍스트 창이 버틴다.
  • orchestrator 컨텍스트 창도 유한하다 (연구 글 : 20만을 넘으면 잘린다. 그래서 계획은 메모리에 저장한다).
  • 코드·보고서처럼 요약하면 망가지는 것은 파일로 두고 참조만 넘긴다. 그러면 orchestrator 를 거치며 생기는 전달 손실(거쳐 갈수록 내용이 빠진다)을 피한다.

규칙과 판단

단순 사실 찾기는 subagent 1개·도구 3~10회, 직접 비교는 2~4개·각 10~15회, 복잡한 조사는 10개 넘게로 질문 난도에 맞춰 띄우고, 큰 산출물은 파일과 가벼운 참조로 받는다는 그림.
그림으로 보기 (AI 생성 · Codex · 누르면 크게)

갈림길

① 지시에 무엇을 [1.4②]

네 가지가 다 있나?목표 · 출력 형식 · 도구와 출처 · 경계
예

맡긴다

각 subagent 의 성능은 곧 그 지시의 질이다

한 줄뿐 (네 가지가 없다)

겹치거나 비게 된다

일이 겹치거나 비거나 필요한 것을 못 찾는다

예, 그런데 부모가 본 파일 경로·오류를 안 적었다 (Agent SDK)

프롬프트에 직접 적는다

부모 대화는 넘어가지 않는다. 넘어가는 것은 Agent 도구 프롬프트 문자열뿐이다. 그래서 파일 경로·오류 메시지·결정은 프롬프트에 직접 적는다

② 몇 개 띄우나 [1.4②]

질문 난도가 어떤가?
단순 사실 찾기

1개

도구 호출은 3~10회다

직접 비교

2~4개

각 10~15회다

복잡한 조사

10개 넘게

책임을 뚜렷이 나눈다

③ 결과를 어떻게 [1.4②] [2.4②]

무엇을 돌려주나?
찾은 내용

압축 요약

압축 요약만 돌려준다(흔히 1천~2천 토큰)

코드·보고서처럼 큰 산출물
검증도 해야 하나?
아니오

파일 + 참조

외부 저장소에 직접 저장한다. 가벼운 참조만 넘긴다

예

검증 서브에이전트

산출물, 뚜렷한 성공 기준(success criteria), 검증 도구를 준다. "전체 테스트를 반드시 돌려라" 를 명시한다

흐름

그림 속 이름·금액·시간·토큰 수는 예시예요. 공식 한도·동작은 카드 본문 값이 기준.

장면 글로 보기

칸 : orchestrator → subagents → 파일 저장소

규칙 (subagents) : 목표 · 출력 형식 · 쓸 도구와 출처 · 작업 경계

질문 : subagent 에게 무엇을 적어 줘야 할까?

① 네 가지를 적어 맡긴다 ✓

  1. 시작 : orchestrator — 말 : “반도체 부족 사태를 정리해 줘”
  2. 위임 : orchestrator → subagents : 네 가지를 적는다 — 쪽지 : 목표: 2025 공급망 병목 / 형식: 표 5행 + 출처 / 도구: 웹 검색 · 공시 / 경계: 2021 자동차 칩 제외
  3. 조사 : subagents : 자기 컨텍스트에서 수만 토큰을 탐색한다 — 쪽지 : 검색 12회 / 읽은 양 35,000 토큰
  4. 요약 : subagents → orchestrator : 압축 요약만 돌려준다 — 쪽지 : 요약 1,500 토큰 / 병목 3곳 + 출처 4개
  5. 끝 : subagent 는 자기 컨텍스트에서 찾은 뒤 압축해 돌려준다(흔히 1천~2천 토큰)

② 한 줄 지시 ≠

  1. 시작 : orchestrator — 말 : “반도체 부족 사태를 정리해 줘”
  2. 위임 : orchestrator → subagents : 세 subagent 에게 같은 한 줄을 보낸다 — 쪽지 : "research the / semiconductor shortage" / 목표·형식·경계 없음
  3. 조사 : subagents : 셋 중 둘이 같은 것을 조사한다 — 쪽지 : A: 2021 자동차 칩 위기 / B: 2025 공급망 / C: 2025 공급망 (B와 겹침)
  4. 요약 : subagents → orchestrator : 겹친 요약이 온다 — 쪽지 : 요약 3개 중 2개가 같은 내용 / 빠진 쪽은 아무도 안 봄
  5. 끝 : 한 줄 지시면 일이 겹치거나 비거나 필요한 것을 못 찾는다

③ 큰 산출물은 파일로 ✓

  1. 시작 : orchestrator — 말 : “공급망 비교 보고서도 만들어 줘”
  2. 위임 : orchestrator → subagents : 산출물 형식까지 적는다 — 쪽지 : 목표: 공급망 비교 보고서 / 형식: 파일로 저장
  3. 저장 : subagents → 파일 저장소 : 외부 저장소에 직접 저장한다 — 쪽지 : report.md (18쪽) / chart.png
  4. 참조 : subagents → orchestrator : 가벼운 참조만 넘긴다 — 쪽지 : files/report.md / "병목 3곳 · 18쪽"
  5. 끝 : 전달 손실(거쳐 갈수록 내용이 빠진다)과 복사에 드는 토큰을 줄인다
규칙 원문 ①②③ (갈림길로 그린 규칙)

  1. 위임 지시 네 가지 : 지시에는 네 가지를 적는다. 없으면 일이 겹치거나 비거나 필요한 것을 못 찾는다 [1.4②]

    • 목표
    • 출력 형식
    • 쓸 도구와 출처
    • 작업 경계

    예 : 'research the semiconductor shortage' 한 줄만 보냈다. 그러자 하나는 2021 자동차 칩 위기를 조사했다. 둘은 2025 공급망을 똑같이 조사했다

    각 subagent 의 성능은 곧 그 지시의 질이다. 단일 에이전트 프롬프트 요령이 subagent 시스템 프롬프트에도 그대로 통한다

    지시는 경직된 규칙보다 좋은 경험칙(heuristics)으로 쓴다. 최선의 프롬프트는 분업·문제 푸는 법·노력 예산을 정한 협업 틀이다

    orchestrator 는 extended thinking 으로 먼저 계획한다

    • 맞는 도구
    • 질문 난도
    • subagent 수
    • subagent 마다 역할

    Agent SDK : 서브에이전트는 새 컨텍스트로 시작한다. 부모 대화는 넘어가지 않는다. 넘어가는 것은 Agent 도구 프롬프트 문자열뿐이다. 그래서 파일 경로·오류 메시지·결정은 프롬프트에 직접 적는다. fork 는 예외다. fork 는 부모 대화를 물려받는다

  2. 노력 배분 : 에이전트는 알맞은 노력을 스스로 잘 못 정한다. 그래서 질문 난도별 규모 규칙을 프롬프트에 넣는다 [1.4②]

    질문subagent도구 호출
    단순 사실 찾기1개3~10회
    직접 비교2~4개각 10~15회
    복잡한 조사10개 넘게 (책임을 뚜렷이 나눈다)—

    초기 실패는 셋이다

    • 단순 질문에 subagent 50개를 띄웠다
    • 없는 출처를 끝없이 찾았다
    • 과한 업데이트로 서로 방해했다

    병렬 : orchestrator 는 subagent 3~5개를 동시에 띄운다. subagent 는 도구 3개+ 를 동시에 부른다. 그래서 복잡한 질문의 조사 시간을 최대 90% 줄인다

    모델 조합 예는 orchestrator Opus 4 + subagent Sonnet 4 다 (연구 글)

    Agent SDK 상한은 셋이다 (2026-09-28 조회)

    • 서브 깊이 : 기본 3층
    • 동시 실행 : 20개
    • 비용 상한 : max_budget_usd(기본값은 없다)

  3. 결과 받기 : subagent 는 자기 컨텍스트에서 수만 토큰을 탐색한다. 그리고 압축 요약만 돌려준다(흔히 1천~2천 토큰). 검색의 본질은 압축이다 [1.4②] [2.4②]

    1천~2천은 "흔히"(경험치)다. 고정 한도가 아니다

    코드·보고서·시각화처럼 큰 산출물은 subagent 가 외부 저장소에 직접 저장한다. orchestrator 로는 가벼운 참조만 보낸다. 그러면 전달 손실과 복사에 드는 토큰이 줄어든다

    orchestrator 계획은 메모리에 저장한다. 컨텍스트가 20만 토큰을 넘으면 잘리기 때문이다

    검증 서브에이전트에는 산출물, 뚜렷한 성공 기준, 검증 도구를 준다. 한두 개 테스트만 돌리고 통과로 적는 지름길이 있다. 그래서 "전체 테스트를 반드시 돌려라" 를 명시한다

    Managed Agents 는 이렇다

    • 샌드박스·파일시스템·vault 는 공유한다. 도구·MCP·컨텍스트는 공유하지 않는다
    • 스레드는 영속이다. 전에 부른 subagent 에게 후속 메시지를 보내면 앞 턴이 유지된다
    • 명단(roster)의 고유 에이전트는 최대 20 이다
    • 위임은 1단계만 된다
더 깊이 : 판단 규칙 · 상황 변수 (설명)

판단 규칙

조건답근거
subagent 에게 일을 맡긴다목표 · 출력 형식 · 도구와 출처 · 작업 경계를 적는다multi-agent-research-system
subagent 둘이 같은 검색을 되풀이한다 · 빈 곳이 생긴다위임(delegation) 지시(특히 경계)를 자세히 쓴다multi-agent-research-system
단순 사실 질문이다subagent 1개 · 도구 호출 3~10회multi-agent-research-system
직접 비교다subagent 2~4개 · 각 10~15회multi-agent-research-system
복잡한 조사다subagent 10개 넘게 띄우고, 책임을 뚜렷이 나눈다multi-agent-research-system
subagent 결과를 orchestrator 에게 넘긴다압축 요약으로 넘긴다 (흔히 1천~2천 토큰)effective-context-engineering
결과가 코드·보고서·시각화다외부 저장소에 쓰고 참조만 넘긴다multi-agent-research-system
서브에이전트가 알아야 할 경로·오류·결정이 있다Agent 도구 프롬프트에 직접 적는다agent-sdk-subagents
산출물을 따로 검증한다검증 서브에이전트에 산출물·성공 기준(success criteria)·도구를 주고 "전체 테스트 필수" 를 적는다building-multi-agent-systems

상황 변수

변수값답 쪽등급근거
질문 난도단순 / 비교 / 복잡1개 / 2~4개 / 10개+판단 규칙 3~5
subagent 탐색량subagent 당 수만 토큰요약만 받아야 orchestrator 컨텍스트 창이 버틴다계산뒤집히는 때 1
결과 모양짧은 찾은 내용orchestrator 로 요약을 보낸다effective-context-engineering
결과 모양코드·보고서처럼 길고 구조가 있다파일과 참조multi-agent-research-system
orchestrator 모델유능하다(Opus 4.5 급)subagent 결과를 직접 평가해도 된다뒤집히는 때 3
orchestrator 모델덜 유능하다 · 검증에 특수 도구가 필요하다 · 명시 검증 지점이 필요하다검증 서브에이전트building-multi-agent-systems
속도순차 검색이 너무 느리다subagent 3~5개를 동시에 띄운다. subagent 는 도구 3개+ 를 동시에 부른다multi-agent-research-system
권한부모가 bypassPermissions 다서브도 bypass 다. 서브 정의로 못 좁힌다agent-sdk-permissions (2026-09-28 조회)

연습 문제

조사 에이전트의 orchestrator 가 "반도체 부족 사태" 질문을 subagent 3개에 나눠 맡기며 셋 모두에게 'research the semiconductor shortage' 한 줄만 보낸다한 줄 지시. 팀은 "유능한 모델이니 알아서 나눠 할 것" 이라고 본다. 이 위임(delegation)의 결과는 무엇인가?

시험 대비

함정

  • "subagent 지시는 짧게 두고 알아서 판단하게 한다" 는 함정이다. 한 줄 지시면 일이 겹치거나 빈다
  • "subagent 결과를 전부 orchestrator 대화로 복사한다" 는 함정이다. 압축 요약을 받는다. 큰 산출물은 외부 저장소에 두고 가벼운 참조만 받는다
  • "subagent 가 많을수록 철저하다" 는 함정이다. 단순 사실은 1개·3~10회다. 초기의 50개가 실패 사례다
  • "서브에이전트는 부모가 본 것을 다 안다" 는 함정이다. 부모 대화는 넘어가지 않는다. 넘어가는 것은 Agent 도구 프롬프트 문자열뿐이다
  • "요약 한도는 1~2천 토큰이다" 는 함정이다. "흔히" 일 뿐이다
  • "부모가 bypassPermissions 여도 서브는 AgentDefinition 의 permissionMode 로 좁힌다" 는 함정이다. 부모가 bypass 면 서브도 bypass 다. 좁히는 것은 부모가 default·dontAsk·plan 일 때만 된다 (2026-09-28 조회)
  • 역할별로 나눠 맡기기(기획·구현·테스트·리뷰)는 ◆ 단일 vs 멀티 에이전트 의 나누는 법에서 다룬다

신호

"Each subagent needs an objective, an output format, guidance on the tools and sources to use, and clear task boundaries."

"Without detailed task descriptions, agents duplicate work, leave gaps, or fail to find necessary information."

"Scale effort to query complexity."

"Simple fact-finding requires just 1 agent with 3-10 tool calls, direct comparisons might need 2-4 subagents with 10-15 calls each, and complex research might use more than 10 subagents with clearly divided responsibilities."

"returns only a condensed, distilled summary of its work (often 1,000-2,000 tokens)."

"Subagents call tools to store their work in external systems, then pass lightweight references back to the coordinator."

"The only content you pass from parent to subagent is the Agent tool’s prompt string"

보통은 지시를 자세히 쓰고 결과를 요약으로 받지만, 절차까지 못 박지 말고, 요약하면 망가지는 산출물은 파일과 참조로, orchestrator 가 직접 평가하면 검증 서브에이전트는 뺀다.
그림으로 보기 (AI 생성 · Codex · 누르면 크게) — 자세한 조건은 아래 '더 깊이'에 있어요
더 깊이 : 뒤집히는 때 · 오답 재료 (설명)

뒤집히는 때

1. 요약 대신 원문을 넘기면 orchestrator 가 터질 때

  • 조건 : 복잡한 조사에 subagent 12개를 띄운다. subagent 마다 3만 5천 토큰을 읽는다.
  • 계산 : 원문을 복사하면 12 × 3만 5천 = 42만 토큰이다. orchestrator 컨텍스트 창 20만을 넘긴다(연구 글 기준에서는 잘린다). 요약(subagent 당 1천 5백)이면 1만 8천 토큰이다.
  • 판단 : "정보를 잃지 않게 전부 넘기기" 가 오히려 orchestrator 컨텍스트 창을 넘겨 계획을 잃는다. 압축이 기본이다. 요약하면 망가지는 산출물만 파일과 참조로 넘긴다.
  • 전제 : 1천 5백은 공식 "흔히 1천~2천" 의 가운데 값을 고른 것이다. 20만은 연구 글 시점의 컨텍스트 창이다.
  • 등급 : 계산
  • 근거 : multi-agent-research-system · effective-context-engineering

2. "자세한 지시"가 오히려 나쁠 때

  • 조건 : orchestrator 가 subagent 마다 검색어 순서와 출처 목록을 한 줄씩 못 박아 고정한다.
  • 판단 : 공식이 요구하는 것은 목표·형식·도구 안내·경계다. 경직된 절차가 아니다. 공식 전략은 경직된 규칙보다 좋은 경험칙("넓게 시작해서 좁혀라" 등)이다. 과하게 고정하면 subagent 가 새 발견에 맞춰 방향을 못 바꾼다.
  • 등급 : (경험칙 원칙) · "고정하면 방향을 못 바꾼다"는 추론
  • 근거 : multi-agent-research-system

3. 검증 서브에이전트가 필요 없을 때

  • 조건 : orchestrator 가 Opus 4.5 급 이상이다. 검증에 특수 도구가 필요 없다.
  • 판단 : 유능한 orchestrator 는 subagent 결과를 직접 평가할 수 있다. 검증 서브에이전트는 세 경우에 쓴다. orchestrator 가 덜 유능할 때, 특수 도구가 필요할 때, 명시적 검증 지점을 강제할 때다.
  • 근거 : building-multi-agent-systems

4. subagent 수를 늘려야 할 때 — 비용으로 본 경계

  • 조건 : 직접 비교 질문(제품 3개 비교)에 subagent 3개 × 도구 12회 = 36회다. 같은 질문을 subagent 1개로 돌리면 한 컨텍스트 창에 36회 결과가 쌓인다.
  • 판단 : 규모 규칙은 난도가 정한다. 비교 질문은 2~4개가 공식 범위다. 1개로 줄이면 한 컨텍스트 창에 다 쌓인다. 10개로 늘리면 조율 비용만 늘어난다.
  • 등급 : (범위) · 36회 예는 새로 고른 것
  • 근거 : multi-agent-research-system

오답 재료

오답왜 끌리나왜 틀리나근거
"subagent 지시는 짧게 두고 알아서 판단하게"유능한 모델은 알아서 할 듯하다한 줄 지시면 일이 겹치고 빈틈이 생긴다 (반도체 예)multi-agent-research-system
"subagent 결과를 전부 orchestrator 대화로 복사"정보 손실이 없을 듯하다압축이 핵심이다. 큰 산출물은 파일과 참조로 넘긴다multi-agent-research-system
"subagent 가 많을수록 철저"병렬이 곧 철저라고 느낀다단순 사실은 1개다. 초기의 50개가 실패 사례다multi-agent-research-system
"서브에이전트는 부모 대화를 물려받는다"같은 세션 안이니 그래 보인다fork 가 아니면 새 컨텍스트다. 받는 것은 프롬프트 문자열뿐이다agent-sdk-subagents
"요약 상한은 2천 토큰으로 고정"숫자가 구체적이다"often" 이다. 경험치다effective-context-engineering
"서브 정의에 permissionMode 를 적었으니 부모가 bypass 여도 좁혀진다"서브마다 설정이 있으니 그래 보인다부모가 bypass 면 서브도 bypass 다agent-sdk-permissions
"Managed Agents 에선 subagent 가 또 subagent 를 부려 여러 단계로"트리 구조가 자연스럽다위임은 1단계만 된다 (명단 가진 에이전트를 참조하면 오류가 난다)managed-agents multi-agent
"subagent 수·도구·범위 한도는 강의가 만든 말"공식 표현과 다르다공식 규모 규칙(1개·3~10회 등)이 있다. 방향은 같다multi-agent-research-system

참고

함께 보기

더 깊이 : CCA-F · 출처 · 상태 · 미해결 (참고)

CCA-F

겹칠 수 있다 (Agent SDK 서브에이전트 정의 · 넘기는 것은 프롬프트 문자열뿐 · 마지막 메시지만 돌아온다). 여기서는 orchestrator 가 무엇을 적어 주고, 몇 개 띄우고, 결과를 어떤 모양으로 받나를 설계로 묻는다

출처

상태

  • 모든 줄을 공식 문서에서 확인

미해결

  1. 목록 1.4② 의 영어 신호 2개("Each subagent needs…", "Scale effort to query complexity.")는 원문에서 찾았다. 이상 없다.
  2. Agent SDK 서브에이전트 상한(깊이 3 · 동시 20)과 권한 상속 규칙은 Claude Code 버전에 딸린 값이다(v2.1.219·v2.1.267 이후). 시험(2026-07 기준 가이드)이 이 숫자를 물을지는 모른다.
  3. 1.5① 의 "미리 쪼갤 수 있나" 판단(static vs dynamic decomposition · 정적 vs 동적 분해)은 이 카드 밖이다. 이 카드는 dynamic decomposition 을 하기로 한 뒤 "어떻게 맡기나" 만 다룬다.
  4. Skilljar "Introduction to subagents" 과정은 미등록이라 읽지 않았다.