에이전트 오케스트레이션
1. 서브에이전트는 반환 계약이다1 / 9

나눌 수 있는 작업과 나눌 수 없는 작업

독립 컨텍스트·도구 제한·반환 요약이 만드는 경계

개념 학습 45 XP 9분

서브에이전트는 고유한 컨텍스트 윈도우와 자체 시스템 프롬프트, 제한된 도구를 갖고 혼자 일한 뒤 요약 결과만 메인 대화로 돌려줍니다. 그래서 이득은 격리 자체가 아니라 돌려받는 요약이 작을 때 생깁니다. 반대로 중간 판단을 계속 봐야 하는 작업을 넘기면 요약이 사실상 전체 로그가 되어 메인 컨텍스트가 더 빨리 찹니다. 내장 Explore는 Haiku·읽기 전용이고 Plan은 메인 모델을 상속하며, 둘 다 빠른 리서치를 위해 CLAUDE.md와 부모 세션의 git status를 건너뜁니다. 나누기 전에 무엇을 돌려받을지부터 적어야 하는 이유입니다.

위임 방식중간 과정이 남는 곳고르는 기준
메인 세션에서 직접메인 컨텍스트중간 판단을 계속 봐야 할 때
Explore 서브에이전트서브에이전트 컨텍스트읽기만으로 끝나는 코드 탐색
커스텀 서브에이전트서브에이전트 컨텍스트반복 역할을 계약으로 굳힐 때
fork (실험 기능)포크 컨텍스트배경 재설명 비용이 클 때
dynamic workflow스크립트 변수단계가 정해진 대량 처리
fork는 CLAUDE_CODE_FORK_SUBAGENT=1일 때만 켜지는 실험 기능입니다.
  1. 반환물 먼저 정의메인으로 돌려받을 요약의 형식과 필수 항목을 위임 전에 적습니다.
  2. 도구 경계 지정tools 허용 목록과 disallowedTools로 그 역할이 넘지 못할 선을 고정합니다.
  3. 격리 수준 결정isolation: worktree가 필요한지, 공유 체크아웃으로 충분한지 판단합니다.
  4. 생성 권한 제한오케스트레이터에는 Agent(agent_type) 허용 목록으로 만들 수 있는 타입을 좁힙니다.