시리즈 홈
SEMINAR · 2026.11 · 02 더 깊이 · ORCHESTRATION

서브에이전트와
오케스트레이션 🤖

혼자가 아니라, 팀으로.
일이 한 명에게 버거워질 때 — 나누고, 맡기고, 보고받는 법

← 먼저 보면 좋은 세미나: 컨텍스트

🤖오케스트레이터 내 세션 — 지휘만
🔍탐색 담당 새 상자
🛠구현 담당 새 상자
🧐리뷰 담당 새 상자

에이전트의 조직도

3분 요약 · TL;DR

결론부터 — 이 세 줄이면 됩니다

에이전트 한 명에게 모든 걸 맡기면 상자가 차면서 흐려집니다. 사람 조직처럼 나누고 맡기고 보고받으세요.

  1. 1
    위임의 핵심은 컨텍스트 격리 — 무거운 읽기는 서브에이전트가자식은 1만 줄을 읽고 30줄만 돌려줍니다. 부모의 상자는 깨끗하게 유지됩니다.
  2. 2
    위임 문장은 업무 지시서 — 목표 · 완료 기준 · 반환 형식서브에이전트는 되물을 수 없습니다. 처음 한 번에 다 적어 주세요.
  3. 3
    작고 순서가 얽힌 일은 혼자가 정답 — 팀은 비용이 듭니다병렬 작업은 파일을 나누고, 진행 상황은 PLAN.md 같은 파일에. 토큰은 몇 배로 늡니다.
지금 바로 써 보는 프롬프트
서브에이전트를 써서 ○○ 폴더 전체를 조사해줘.
목표: ○○이 어디서 처리되는지 찾기.
보고 형식: 관련 파일 경로 + 각 1줄 설명, 최대 15줄. 코드는 수정하지 마.
이럴 때 이 덱을 다시 펼치세요
  • 한 세션에 일이 너무 커서 AI가 길을 잃을 때
  • 서로 독립적인 작업 여러 개를 동시에 돌리고 싶을 때
  • 문서·파일 수십 개를 한꺼번에 처리해야 할 때
CH 1 · 한 명의 한계

한 명에게 긴 일을 전부 맡기면, 결국 목표를 잊습니다

  • 😊 1주차 — "네, 요구사항 다 파악했습니다"순항
  • 🗂 4주차 — 메모·회의록·시안이 머릿속에 가득과적
  • 🌀 7주차 — 폐기한 v1 시안과 최신 v3가 뒤섞이기 시작혼선
  • 🫠 9주차 — "그런데 원래 목표가 뭐였죠?"표류
에이전트 하나에 긴 작업을 맡겨도 똑같은 일이 벌어집니다.
작업 기억(컨텍스트 창)이 차면 흐려집니다 — 원리는 context 세미나에서. 오늘은 "그래서 어떻게 나누나".
90% 참9주차의 머릿속
System · 도구
긴 대화
파일 · 로그 · 폐기안

한 명의 한계

CH 2 · 서브에이전트의 원리

서브에이전트는 세 박자로 일합니다 — 위임 → 격리 → 보고

🤖부모 에이전트 긴 대화 · 전체 계획 보유
📨 임무 요약 ↓ ↑ 결론만 📋
🔍자식 A 시행착오는 여기서
🧪자식 B 시행착오는 여기서
  • ① 📨 부모는 임무를 요약해 위임합니다 — 대화 전체가 아니라 지시서 한 장
  • ② 🧼 자식은 깨끗한 자기 컨텍스트에서 일합니다 — 부모의 긴 히스토리를 모른 채
  • ③ 📋 돌아오는 건 요약뿐 — 자식이 읽은 1만 줄은 부모에게 넘어오지 않습니다

부모의 상자는 계획과 결론만으로 가볍게 유지됩니다 — 회사의 분업·위임·보고와 같은 구조입니다.

CH 2 · 서브에이전트의 원리

자식이 읽은 1만 줄은 자식의 상자에서 끝납니다

85%
자식: 1만 줄 읽음 다 쓰고 버려짐 ♻️
→요약 30줄 +2K
24%부모는 가볍게
System · 도구
부모 에이전트

자식이 읽은 1만 줄은 자식과 함께 사라지고, 부모에게는 결론 30줄만 남습니다.

🧮 함수 분리와 같은 원리

지역 변수 = 자식의 탐색·시행착오   반환값 = 요약 보고   호출자 = 부모

이것을 컨텍스트 격리라고 부릅니다 — 서브에이전트를 쓰는 가장 큰 이유.

CH 2 · 서브에이전트의 원리

위임은 업무 지시서처럼 — 목표 · 완료 기준 · 반환 형식

# ❌ 이렇게 위임하면
"주간보고 폴더 좀 봐줘"

# 자식은 부모의 대화를 모릅니다 —
# 무엇을? 왜? 어디까지?
# 게다가 중간에 되물을 수도 없습니다
# ✅ 업무 지시서
"reports/의 주간보고 150개를 조사해줘.
목표: 장비 EQ-07에서 반복된 알람 유형 찾기
완료 기준: 알람마다 원문 한 줄 근거
반환 형식: 표 — 날짜 | 알람 유형 | 파일명, 최대 20행"
🎯 목표 ✅ 완료 기준 📦 반환 형식

프롬프트 세미나의 3요소에 반환 형식이 더해집니다 — 보고서 양식을 정해 줘야 취합이 쉽습니다.

자식은 일하는 도중에 되묻지 못합니다 — 처음 지시서에 다 담으세요.
CH 2 · 서브에이전트의 원리

말로 시키면 충분하고, 자주 쓰는 역할은 파일로 저장합니다

🗣 말로 시키기 — 대부분 이걸로 충분

"서브에이전트로 나눠서 조사해줘"
"독립적인 부분은 병렬로 진행해줘"
"리뷰는 별도 에이전트에게 맡겨줘"

이 한마디면 에이전트가 알아서 자식을 띄웁니다.

📁 커스텀 서브에이전트 — 역할을 파일로

.claude/agents/reviewer.md
---
name: reviewer
description: 코드 리뷰 전문.
  PR·diff 검토 시 사용
tools: Read, Grep
---
너는 깐깐한 시니어 리뷰어다. …

이름·전문 분야·쓸 수 있는 도구를 적어 두면 필요할 때 같은 역할이 다시 불려 옵니다. 리뷰어에게는 읽기 권한만.

CH 2 · 서브에이전트의 원리

위임에는 비용이 듭니다 — 작은 일에는 손해입니다

🧳 맥락 전달 비용 자식은 부모의 대화를 모릅니다 — 필요한 배경은 지시서에 다시 써서 들려 보내야 합니다
🔁 왕복 오버헤드 새 상자 준비, 같은 파일 다시 읽기, 보고 대기 — 5분짜리 일이면 이 시간이 더 깁니다
🗜 요약 손실 돌아오는 건 요약뿐 — 부모는 세부 근거를 직접 본 적이 없습니다. 중요한 판단이면 근거를 반환 형식에 포함시키세요
위임은 격리의 이득이 비용보다 클 때만 합니다.
"언제 맡기지 않을지"는 뒤의 판단 플로차트에서.
CH 3 · 오케스트레이션 패턴

팀을 짜는 방법은 패턴 4가지면 충분합니다

① 🎭 역할 분담

탐색 → 계획 → 구현 → 리뷰. 단계마다 다른 에이전트, 각자 깨끗한 눈.

읽을 건 많고 단계가 뚜렷할 때

② 🍴 병렬 fan-out

독립 작업 여러 개를 동시에. 기다리는 시간이 줄어듭니다.

보고서 10개 요약 · 후보 3개 비교 조사

③ 🏭 파이프라인

항목별로 단계를 흘려보내기 — 앞 단계 전체를 기다리지 않고.

문서 50건 추출 → 번역 → 검수

④ ⚖️ 심판 패널

같은 문제를 N번 독립 시도 → 채점·종합. 서로 반박도 시킵니다.

설계안·문안처럼 정답이 여럿일 때

CH 3 · 패턴 ① 역할 분담

① 역할 분담 — 단계마다 새 눈을 씁니다

🔍탐색 코드베이스를 뒤져 보고서만 잡동사니는 여기 두고 감
→
📐계획 보고서만 보고 설계 새 상자
→
🛠구현 계획서대로, 잡음 없이 새 상자
→
🧐리뷰 남의 눈으로 코드만 새 상자

탐색이 읽은 파일 수십 개는 탐색 상자에 두고 갑니다 — 계획은 정리된 보고서만 보고 세웁니다.

리뷰어는 구현자의 사정을 모릅니다. 내가 만든 것은 내 눈에 늘 옳아 보이니까요 — 사람도, 에이전트도.

CH 3 · 패턴 ② 병렬 fan-out

② 병렬 fan-out — 서로 독립인 일은 동시에

❌ 혼자 순차 — 파일 5개 × 10분🕐 50분

에이전트 1명
파일 ① 파일 ② 파일 ③ 파일 ④ 파일 ⑤

✅ fan-out — 동시에 5명🕐 10분 + 취합

에이전트 A
파일 ①
에이전트 B
파일 ②
에이전트 C
파일 ③
에이전트 D
파일 ④
에이전트 E
파일 ⑤
조건: 서로 독립 같은 파일 금지

예: 보고서 10개 요약 · 후보 3개 비교 조사 · 파일별 변환. 걸리는 시간은 줄지만 드는 토큰은 줄지 않습니다.

CH 3 · 패턴 ③ 파이프라인

③ 파이프라인 — 끝난 항목부터 다음 단계로

과제: 문서 여러 건을 추출 → 번역 → 검수로 처리하기 (단계마다 담당 에이전트 1명)

❌ 배리어 — 단계 전체가 끝나야 다음9틱

문서 A 문서 B 문서 C
추출번역검수시간 →

✅ 파이프라인 — 끝난 것부터 바로 다음5틱 ✂

문서 A 문서 B 문서 C
추출번역검수시간 →
문서 A가 검수받는 동안 문서 C는 추출 중 — 단계별로 다 모일 때까지 기다리지 않으면 라인이 쉬지 않습니다.
생산 라인과 같은 그림입니다. 항목이 많고 단계가 고정일 때 효과가 큽니다.
CH 3 · 패턴 ④ 심판 패널

④ 심판 패널 — 여러 번 따로 풀게 하고 채점합니다

🙈 시도들은 서로의 답을 못 봅니다 — 독립성이 다양성을 만듭니다.

🥊 한 걸음 더: 🅰에게 🅱를 반박시켜 보세요 — 스스로 매기는 점수보다 냉정합니다.

설계·문안·전략처럼 정답이 여럿일 때만. 비용은 시도 횟수만큼 늡니다.

CH 4 · 조율의 실전 도구

진행 상황은 대화가 아니라 파일에 적어 둡니다

📋 작업 목록(TODO) — 현황판

[x] 1. API 명세 조사 — 완료 (보고서: notes/api.md)
[>] 2. 파서 구현 — 에이전트 B 진행 중
[ ] 3. 테스트 작성 — 2번 완료 후
[ ] 4. 문서 갱신

누가 어디까지 했는지가 대화를 새로 시작해도 남습니다.

📝 계획서 · 메모 파일 — 공용 게시판

PLAN.md에 설계와 결정을, NOTES.md에 중간 발견을 — 자식들이 같은 파일을 읽으며 합을 맞춥니다.

자식 A의 발견을 자식 B에게 전하는 가장 싼 방법은 부모의 말이 아니라 파일입니다.

대화는 사라지고 파일은 남습니다 — 여럿이 일할수록 더 그렇습니다.
CH 4 · 조율의 실전 도구

병렬 작업은 폴더를 나누고, 단계 사이에 검사를 둡니다

🌳 git worktree — 에이전트마다 작업 폴더

$ git worktree add ../feat-login  feature/login
$ git worktree add ../feat-search feature/search
# 같은 저장소, 서로 다른 작업 폴더

에이전트마다 자기 사본 — 같은 파일을 동시에 고쳐도 충돌이 없습니다. 끝나면 브랜치 병합으로 합칩니다.

🛂 검증 게이트 — 단계 사이의 검문소

파이프라인 사이사이에 검사 단계를 심습니다 — 테스트 러너 · 린터 · 리뷰 에이전트. 통과 기준은 작업 목록에 명시.

검사 방법은 검증 세미나의 사다리 그대로입니다.

병렬의 두 가지 사고 — 같은 파일 충돌과 불량 결과 전파 — 를 이 두 장치가 막습니다.
심화 · 더 멀리 맡기기

대화창 없이 한 번 돌고 끝나는 실행 — headless

$ claude -p "어젯밤 실패한 테스트를 분석해서
     원인 요약을 report.md로 저장해줘"
# 대화창 없이 한 번 실행하고 종료 — 결과는 파일과 표준 출력으로

🧾 스크립트의 부품이 됩니다

반복문·크론 작업에 끼워 넣으면 에이전트가 파이프라인의 한 단계가 됩니다. 매일 밤 로그 분석, 매주 문서 갱신.

🤖 에이전트가 에이전트를 부릅니다

오케스트레이터 스크립트가 headless 에이전트 여럿을 지휘 — 사람은 시작과 결과 확인만.

대화형은 "함께 일하기", headless는 "맡겨 두기"입니다.
매일 아침 자동 실행·팀 공유 같은 비개발자용 실전은 → automation 세미나
심화 · 더 멀리 맡기기

PR·이슈·스케줄이 에이전트를 깨웁니다

🔍 PR 자동 리뷰

PR이 열리면 리뷰 에이전트가 코멘트를 달아둡니다. 사람 리뷰어는 굵은 판단만.

🏷 이슈 자동 분류

새 이슈에 라벨·우선순위·담당 제안을 자동으로 — 아침 분류 회의가 짧아집니다.

🌙 야간 배치

스케줄 트리거로 매일 밤 — 의존성 점검 · 문서 갱신 · 릴리스 노트 초안.

GitHub Actions 같은 CI에 에이전트를 심으면, 트리거(PR·이슈·스케줄)가 상사 역할을 대신합니다.

아침에 출근하면 리뷰가 달려 있습니다 — 사람이 없는 만큼 검사 단계는 더 필요합니다.
심화 · 더 멀리 맡기기

얼마나 멀리 맡기나 — 계획을 누가 쥐느냐로 고릅니다

방식계획을 쥔 쪽규모이렇게 시작
🧬 서브에이전트Claude가 턴마다한 번에 몇 개"서브에이전트로 나눠서" · 진행 상황은 /tasks
🗂 에이전트 뷰내가 — 독립 작업을 던져 두고 확인세션 여러 개claude agents — 백그라운드 세션을 한 화면에서
📜 Workflow스크립트가 — Claude가 써 주고 다시 돌릴 수 있음수십~수백 개"workflow로 해줘" · /workflows로 관전
☁️ 클라우드 예약 작업스케줄이 — 내 PC가 꺼져도정해진 시각마다/schedule "매일 아침 9시에 …"
원리는 그대로입니다 — 바뀌는 건 얼마나 멀리, 얼마나 오래 맡기느냐뿐.
예약 작업을 실제로 만드는 과정은 → automation 세미나
심화 · 더 멀리 맡기기

패턴을 스크립트로 묶으면 수백 개도 돌립니다 — Workflow

💬 말로 시키면

"workflow로 src/ 아래 측정 스크립트 전부를
 단위 오류가 있는지 점검하고, 찾은 건
 서로 교차 검증한 뒤 보고해줘"

📜 Claude가 쓴 스크립트 (요지)

const files = await agent('점검할 파일 목록')
const found = await pipeline(files.list, f =>
  agent(`${f} 단위 오류 점검`))      // 🍴 fan-out
const ok = await parallel(found.map(x => () =>
  agent(`반박해 봐: ${x}`)))           // ⚖️ 심판

🧠 계획이 상자 밖으로

중간 결과는 스크립트 안에 — 메인 대화엔 최종 보고만 돌아옵니다.

🔁 다시 돌릴 수 있다

잘 된 실행은 /workflows에서 s로 저장 → 다음부턴 /내-이름 한 줄. 중간에 멈춰도 끝난 에이전트는 다시 안 돕니다.

💸 비용은 ×N

에이전트 25개·150만 토큰을 넘으면 경고가 뜹니다. 폴더 하나로 먼저 시험해 보고 넓히세요.

CH 5 · 언제 팀으로 하나

팀으로 하다 실패하는 4가지 방식

🔬 과분할 10분짜리 일을 다섯 조각으로 — 위임 비용이 이득보다 큽니다. 회의가 일보다 길어지는 조직처럼
🧵 취합 비용 보고서 5장을 읽고 합치는 것도 일입니다 — 지시서에 반환 형식을 통일해 두세요
💥 같은 파일 충돌 자식 둘이 한 파일을 고치면 한쪽 작업이 사라집니다 — 나누는 경계를 파일 단위로
💸 토큰 배수 멀티에이전트는 일반 채팅보다 약 15배 토큰을 씁니다 (Anthropic 측정) — 시간은 줄고 비용은 늡니다
공통 처방 — 쪼개기 전에, 쪼갤 가치가 있는지부터 따집니다.
CH 5 · 언제 팀으로 하나

팀으로 할까, 혼자 할까 — 질문 네 개로 고릅니다

작고, 순차적이고, 앞뒤 맥락이 얽혀 있다? —예→ 🧑‍💻 혼자 시키세요 — 일상 작업 대부분
아니오 ↓
독립 조각으로 깔끔하게 쪼개지나? —예→ 🍴 fan-out  ·  단계까지 있으면 🏭 파이프라인
아니오 ↓
읽을 것은 많은데 결론은 짧은가? —예→ 🎭 역할 분담 — 탐색만 격리해도 절반은 성공
아니오 ↓
답이 여럿이고 품질이 승부인가? —예→ ⚖️ 심판 패널 — 비용은 시도 수만큼
아니오 ↓
🧑‍💻 혼자 + 결과 검사 — 그걸로 충분합니다

헷갈리면 혼자가 기본값입니다 — 팀은 병목이 눈에 보일 때만 부르세요.

📸 한 장 정리 — 찍어 가세요

패턴 4가지 — 언제 쓰고, 어떻게 말하나

패턴이럴 때이렇게 말하세요
🎭 역할 분담읽을 건 많고 결론은 짧을 때"먼저 서브에이전트로 조사해 보고서만 받아줘. 그걸로 계획을 세운 뒤 진행해줘."
🍴 병렬 fan-out서로 독립인 일 여러 개"이 보고서 10개를 서브에이전트들로 나눠 동시에 요약해줘. 같은 파일은 둘이 건드리지 않게."
🏭 파이프라인항목이 많고 단계가 고정"문서마다 추출 → 번역 → 검수 순서로, 끝난 것부터 다음 단계로 넘겨줘."
⚖️ 심판 패널정답이 여럿, 품질이 승부"서로 다른 접근으로 3번 따로 시도한 뒤, 비교·채점해서 가장 나은 안을 제안해줘."
🧑‍💻 그 외 대부분작고 순서가 얽힌 일그냥 혼자 시키고, 결과를 검사합니다 — 그게 가장 빠릅니다.

지시서에는 항상 — 🎯 목표 · ✅ 완료 기준 · 📦 반환 형식

CLOSING

기억할 것, 세 문장

  1. 위임의 단위는 컨텍스트입니다 — 자식의 시행착오는 자식의 상자에서 끝나게 하세요.
  2. 지시서에는 목표 · 완료 기준 · 반환 형식 — 돌아오는 건 요약뿐이라는 전제로 쓰세요.
  3. 팀은 공짜가 아닙니다 — 작고 순차적이고 맥락이 얽힌 일은 그냥 혼자 시키세요.
오케스트레이션은 코딩 기술이 아니라 조직 설계입니다 —
그리고 여러분은 이미 조직에서 일해봤습니다.

다음으로 → 결과 검증하기  ·  혼자 도는 자동화  ·  컨텍스트

🤖오케스트레이터 계획 · 위임 · 취합
📨 지시서 ↓ ↑ 요약 📋
🔍탐색 격리된 시행착오
🛠구현 새 상자
🧐리뷰 깨끗한 눈

질문은 지금, 또는 Q&A 위젯으로 받겠습니다.

REFERENCES

더 깊이 보기

📚 공식 문서 · 도구

  • SubagentsClaude Code Docs — 커스텀 서브에이전트 정의·도구 권한
  • Dynamic workflowsClaude Code Docs — 스크립트로 수십~수백 에이전트 지휘
  • Run agents in parallelClaude Code Docs — 서브에이전트 · 에이전트 뷰 · 팀 · Workflow 비교
  • claude-code-actionGitHub Actions에서 에이전트 실행 — PR 리뷰·이슈 처리
  • git worktree병렬 작업 폴더 — 파일 충돌 격리의 표준 도구

🛠 엔지니어링 블로그

🎓 이 시리즈의 세미나