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

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

- Canonical: https://learning.reopt.ai/en/courses/claude-code-agent-orchestration/lessons/ccao-m1-concept
- Language: en
- HTML: https://learning.reopt.ai/en/courses/claude-code-agent-orchestration/lessons/ccao-m1-concept

---

[Agent orchestration](/en/courses/claude-code-agent-orchestration) 1. 서브에이전트는 반환 계약이다 1 / 9

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

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

서브에이전트는 고유한 컨텍스트 윈도우 와 자체 시스템 프롬프트, 제한된 도구를 갖고 혼자 일한 뒤 요약 결과만 메인 대화로 돌려줍니다. 그래서 이득은 격리 자체가 아니라 돌려받는 요약이 작을 때 생깁니다. 반대로 중간 판단을 계속 봐야 하는 작업을 넘기면 요약이 사실상 전체 로그가 되어 메인 컨텍스트가 더 빨리 찹니다. 내장 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) 허용 목록으로 만들 수 있는 타입을 좁힙니다.

실무에 남길 기준

- 서브에이전트의 이득은 격리가 아니라 작은 반환물에서 나온다
- Explore와 Plan은 CLAUDE.md와 git status를 건너뛰므로 팀 규칙 준수가 필요한 수정에는 맞지 않는다
- 중첩은 최대 3단계까지 허용되므로 단계마다 허용 타입과 차단 도구를 명시한다

Got it · Continue

---

Site guide for agents: https://learning.reopt.ai/llms.txt · Sitemap: https://learning.reopt.ai/sitemap.xml · Contact: https://learning.reopt.ai/contact
