Claude Code 서브에이전트 마스터리 스택 2026: 하나의 대화에서 협업하는 에이전트 협의회로
Claude Code 멀티 에이전트 워크플로를 마스터하기 위한 완전한 학습 + 도구 스택: 5가지 서브에이전트 패턴 + 커스텀 에이전트 작성 + 스킬/서브에이전트/MCP 의사결정 프레임워크 + 오케스트레이션 실패 모드 + 스킬 작성. 단일 스레드 코딩에서 신뢰할 수 있는 에이전트 파이프라인으로 가는 전체 경로.
- Claude Code
- Agent SDK
- MCP
- Bash
- Markdown
- Proprietary
- 업데이트 2026-05-30
단일 스레드 AI 코딩은 2025년 말에 벽에 부딪혔습니다. 하나의 거대한 Claude 대화가 30개의 파일을 읽고, 탐색으로 컨텍스트 윈도를 가득 채운 뒤, 정작 편집을 시작할 때는 필요한 작업 메모리의 절반밖에 남아 있지 않습니다. 2026년의 해답은 위임된 전문화(delegated specialization) 입니다. 과부하된 단일 두뇌 대신, 엄격한 정보 경계를 가진 소규모 서브에이전트 협의회를 두는 것입니다.
이 컬렉션은 그곳에 도달하기 위한 완전한 경로를 한데 모았습니다. 다섯 편의 심층 가이드 + 도구를, 학습해야 할 순서대로 정리했습니다. 이론이 아닙니다. 이것들은 우리가 dibi8 자체를 만들 때 사용하는 바로 그 패턴입니다(우리는 실제로 병렬 번역 서브에이전트를 사용해 이 스택의 문서들을 만들었습니다).
TL;DR — 한눈에 보는 마스터리 스택 #
| # | 구성 요소 | 계층 | 역할 | 심층 가이드 |
|---|---|---|---|---|
| 1 | 5가지 서브에이전트 패턴 | 기초 | 다섯 가지 워크플로: 병렬 팬아웃, 워크트리 격리, 전문가 위임, 컨텍스트 보호, 파이프라인 오케스트레이션 | 서브에이전트 패턴 |
| 2 | 커스텀 에이전트 작성 | 구축 | .claude/agents/*.md 작성법 — 프런트매터, 시스템 프롬프트, 도구 허용 목록 | 커스텀 에이전트 작성 |
| 3 | 서브에이전트 vs MCP vs 스킬 | 결정 | 3축 프레임워크 — 지식(스킬), 컨텍스트(서브에이전트), 능력(MCP) | 서브에이전트 vs MCP vs 스킬 |
| 4 | 스킬 작성 | 구축 | Claude가 관련 있을 때만 로드하는 절차를 패키징 — SKILL.md, 점진적 공개 | 스킬 작성 |
| 5 | 오케스트레이션 사후 분석 | 회피 | 파이프라인이 실패하는 5가지 방식: 신뢰의 함정, 컨텍스트 누출, 폭주하는 팬아웃, 조용한 잘림, 고아가 된 워크트리 | 파이프라인 사후 분석 |
| + | MCP 도구 빌더 | 도구 | 에이전트 능력을 확장하는 MCP 도구 스캐폴드 생성 | MCP 도구 빌더 |
학습 순서 (그리고 그 이유) #
다섯 가지 패턴(1)부터 시작하세요. 무언가 커스텀한 것을 만들기 전에, 애초에 언제 서브에이전트를 띄워야 하는지를 체득하세요. 병렬 리서치 팬아웃은 진입 마찰이 가장 낮은 출발점이며 그 이득이 즉각적입니다. 그 밑바탕에 깔린 원리는 다른 모든 것을 관통합니다. 당신의 부모 대화는 희소한 자원이며, 서브에이전트는 그것을 고갈시키지 않고 지출하는 방법입니다.
그다음 커스텀 에이전트 작성법(2)을 배우세요. 패턴을 알게 되면, 그것을 코드로 굳히세요. 커스텀 에이전트는 실행 가능한 제도적 지식입니다 — 당신의 리뷰 체크리스트, 보안 게이트, 또는 마이그레이션 감사자를 버전 관리되는 .md 파일로 만든 것이죠. 성패를 가르는 디테일은 description(라우팅 신호)과 도구 허용 목록입니다(최소 권한 원칙은 리뷰어가 검토하기로 되어 있던 코드를 “친절하게” 편집하는 것을 막아줍니다).
한 걸음 물러나 의사결정 프레임워크(3)를 보세요. 이것이 핵심 주춧돌입니다. 또 다른 에이전트를 만들기 전에 자문하세요: 내가 부족한 것이 지식인가(→ 스킬을 작성), 컨텍스트인가(→ 서브에이전트를 띄움), 아니면 능력인가(→ MCP 서버를 구축)? 대부분의 팀은 마크다운 파일 한 장이면 점심 전에 똑같은 결과를 낼 수 있는데도 MCP 서버에 과하게 손을 뻗습니다.
스킬 축(4)을 마스터하세요. 스킬은 가장 과소평가된 확장 수단입니다 — 관련 있을 때만 로드되는 적시(just-in-time) 전문성으로, 기본 컨텍스트를 가볍게 유지해줍니다. 그 기술은 트리거 description과 점진적 공개에 있습니다.
그다음 이 모든 것이 어떻게 망가지는지(5)를 연구하세요. 사후 분석은 데모와 프로덕션을 가르는 차이입니다. 모든 실패는 하나의 뿌리를 공유합니다: 에이전트의 주장을 검증된 현실로 신뢰하는 것. 모든 이음새에 검증(git diff, 테스트 종료 코드)과 한계(중단 조건, 예산)를 심으세요.
왜 이 스택이 임기응변식 학습을 이기는가 #
흩어진 블로그 글들은 서브에이전트가 존재한다는 사실을 가르칩니다. 이 스택은 전체 루프를 가르칩니다: 언제 위임할 것인가 → 어떻게 작업자를 만들 것인가 → 어떤 확장 수단을 집을 것인가 → 어떻게 재사용 가능한 전문성을 패키징할 것인가 → 어떻게 그것이 조용히 실패하지 않게 할 것인가. 이것은 우리가 dibi8에서 매일 돌리는 바로 그 루프입니다 — 재탕한 문서가 아니라, 직접 겪은 경험이라는 해자(moat)입니다.
프로덕션급 Claude Code 환경 구축 #
멀티 에이전트 파이프라인을 대규모로 돌리려면 안정적인 인프라가 필요합니다: 긴 세션과 CI 게이트를 위한 신뢰할 수 있는 호스트(HTStack — 홍콩 VPS, dibi8.com을 호스팅하는 바로 그 IDC), 그리고 병렬 팬아웃을 위한 클라우드 여유 공간(DigitalOcean — $200 무료 크레딧). 쓰러지지 않는 에이전트를 작성하는 것이 처음이신가요? 우리의 Gumroad $19 스킬 번들은 실전에서 검증된 다섯 가지 스킬과 이 패턴들 뒤에 있는 오케스트레이터 프롬프트를 함께 제공합니다.
결론 #
서브에이전트를 다섯 개의 단절된 트릭으로 배우지 마세요. 스택을 순서대로 밟으세요 — 패턴 → 작성 → 의사결정 프레임워크 → 스킬 → 실패 모드 — 그러면 “하나의 거대한 대화"에서 프로덕션에서 실제로 신뢰할 수 있는, 협업하는 에이전트 협의회로 졸업하게 됩니다. 오늘 패턴 1부터 시작하세요. 세션이 길어지고 작업이 무거워질수록 나머지를 한 층씩 쌓아 올리면 됩니다.
💬 댓글 토론