Claude Code의 서브 에이전트 병렬화 판단 기준은 '종속성 유무' 하나뿐

저는 Claude Code의 서브 에이전트 기능을 사용한 병렬 실행 핸즈온을 진행했습니다. 블로그 기사 작성이라는 구체적인 유스케이스를 통해, '무엇을 병렬화할 수 있는지'에 대한 판단 기준과 2026년 6월에 추가된 Dynamic Workflows의 위치를 정리합니다.

❌ 순차적으로 실행 (느림): 조사A 완료 대기 → 조사B 완료 대기 → 조사C 완료 대기 → 조사D 완료 대기
✅ 병렬로 실행 (최대 4배 속도): 조사A~D 동시 실행 → 모두 끝나면 다음 단계 진행

'조사A가 끝나지 않으면 조사B를 시작할 수 없다'와 같은 종속 관계가 없는 한, 모든 것을 동시에 실행할 수 있습니다. 반대로 '조사가 끝나지 않으면 집필을 할 수 없다'는 종속성이 있는 공정은 반드시 순차적으로 실행해야 합니다. 이 단 하나의 점만 의식하면 워크플로우 설계에 헤매지 않을 수 있습니다.

---
name: blog-researcher
description: 블로그 기사 리서치 전용 에이전트
...

YAML 프론트매터와 시스템 프롬프트 형식으로, tools 필드에서 사용 가능한 도구를 제한할 수 있습니다. 프로젝트 레벨(.claude/agents/)에 두면 팀원 전체에게 자동으로 적용되며, 사용자 레벨(~/.claude/agents/)이라면 모든 프로젝트에서 개인적으로 사용할 수 있습니다.

❌ '이 프로젝트의', '아까 말한'과 같은 전제는 통하지 않는다
✅ 파일 경로・조건을 프롬프트에 명시적으로 작성한다

각 서브 에이전트는 메인 세션과는 별도의 컨텍스트 창에서 작동합니다. 메인에서 나눈 내용을 암묵적인 전제로 전달할 수 없기 때문에, 필요한 정보는 매번 명시적으로 작성해야 합니다. 이것이 서브 에이전트 활용에서 가장 실수하기 쉬운 포인트입니다.

기존의 서브 에이전트: 사용자가 명시적으로 'A와 B를 병렬로' 지시
Dynamic Workflows: '이 프로젝트를 최적화해줘'라는 한마디만으로 Claude가
태스크 분해・스크립트 생성・병렬 실행까지 자동 수행

Dynamic Workflows는 Claude가 자율적으로 JavaScript 오케스트레이션 스크립트를 생성하여 대규모 태스크 그룹을 병렬 처리하는 메커니즘입니다. 최대 시작 수는 1,000이지만, 동시 실행 수는 16으로 제한되어 있습니다. /batch는 이 Dynamic Workflows의 '코드 변경'에 특화된 응용 구현이라는 위치를 가집니다.

2026년 6월 업데이트로, 포그라운드・백그라운드 모두
서브 에이전트의 중첩은 최대 5단계로 제한되었다

무제한으로 중첩되어 폭주하는 버그가 수정된 결과로서의 제한입니다. 서브 에이전트 중에서 또 다른 서브 에이전트를 호출하는 것과 같은 복잡한 구성을 만들 경우, 이 상한선을 의식하고 있어야 합니다.

'종속성 유무'라는 단순한 판단 기준으로 병렬화 가능 여부를 결정할 수 있다는 점과, 서브 에이전트마다 독립적인 컨텍스트를 가지므로 전제 공유가 효과적이지 않다는 점이 이번 핸즈온의 실질적인 핵심이었습니다. Dynamic Workflows를 통한 대규모 병렬화・중첩 깊이 제한까지 이해하고 있으면, 서브 에이전트 활용의 한계와 가능성 양쪽을 모두 파악할 수 있습니다.