# Lesson 08 Subagents

> AI 에이전트 강의 패키지의 8강 (심화 트랙 1) — 비개발자가 큰 작업을 서브에이전트에 위임해 본인 컨텍스트를 보호하는 흐름을 익히고, 본인 작업 중 위임 가능한 1개를 직접 분리할 때 사용하는 30분 대화형 강의. 좋은 위임 vs 나쁜 위임 / 역할 정의 / 입출력 명확화를 한 청크씩 익힌다. 사용자가 "8강 시작", "subagent", "서브에이전트", "작업 위임", "큰 작업을 쪼개서 시키고 싶어요", "컨텍스트 보호", "에이전트 분리" 같은 표현을 쓰거나, 기초 트랙을 완주한 후 심화 트랙 첫 강의에 진입하려 할 때 반드시 이 스킬을 사용한다. 단순 서브에이전트 설명이 아니라, 한 청크씩 게임처럼 진행되는 30분짜리 가이드형 학습 흐름이라는 점이 핵심이다.

- Skill: `matthewoong/lesson-08-subagents` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add matthewoong/lesson-08-subagents`
- Raw SKILL.md: https://api.skillmd.com/api/skills/matthewoong/lesson-08-subagents/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Matthewoong (https://skillmd.com/u/matthewoong)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/matthewoong/lesson-08-subagents

---


# Lesson 08 — 서브에이전트 (심화 트랙 1)

> 학습자가 끝나면 큰 작업 1개를 서브에이전트에 위임해 본인 컨텍스트를 보호하는 흐름을 *직접* 만들어본다.

심화 트랙의 첫 강의입니다. 기초에서 만든 환경 위에 *작업 위임*이라는 새 도구를 더합니다.

---

## 0. 시작하기 전에

| 문서 | 언제 |
|---|---|
| `_shared/teaching-protocol.md` | 이론 청크 |
| `_shared/guided-practice-protocol.md` | 가이드 실습 |
| `_shared/learner-profile-schema.md` | 진도·draft |
| `_shared/style-guide.md` | 톤·분기·예시 |
| `_shared/menu-template.md` | 메뉴 |

---

## 1. 진입 시 행동

1. 학습자 프로필 확인.
2. `progress["08-subagents"].status` 분기.
3. **기초 트랙(1~7) 미완주 시** 권장 안내 한 번 ("심화는 기초가 잡혀야 더 와닿아요").
4. 첫 인사 + "심화 트랙 첫 강의에 오신 걸 환영해요!" 격려.
5. 이론 진입. 헤더 `📘 [Lesson 8 · 청크 X/Y]`.
6. 이론 끝 → 가이드 실습 (옵션 2개 인라인).
7. 실습 종료 → 진도 갱신 + 다음 강의(9강).

---

## 2. 진도 갱신 + draft 키 명세

| 시점 | 갱신 |
|---|---|
| 8강 첫 진입 | `status = "in_progress"`, `track = "advanced"` (아직 안 됐으면) |
| 청크 통과 | `current_chunk += 1` |
| 청크 3~4 답변 | `draft.parent_task = <전체 작업>`, `draft.subagent_role = <위임할 역할>` |
| 청크 5 답변 | `draft.input_format = <입력 형식>`, `draft.output_format = <출력 형식>` |
| 실습 통과 | `practice_status = "done"`, `status = "completed"` |

### 8강이 사용하는 `draft` 키

| 키 | 시점 | 형식 |
|---|---|---|
| `parent_task` | 청크 3 | string |
| `subagent_role` | 청크 4 | string |
| `input_format` | 청크 5 | string |
| `output_format` | 청크 5 | string |

---

## 3. 이론 lesson 흐름

청크 8개.

### 8강에서 *왜* 한 청크씩 가는가
서브에이전트는 *위임 사고*를 익히는 강의입니다. "이건 위임할 만, 이건 직접" 구분 감각을 한 번에 다 못 익혀요. 한 청크씩 *예시 → 결정 → 다음*으로 가야 본인 작업에서 위임 후보를 알아보는 눈이 생깁니다.

---

## 4. 가이드 실습 — 옵션 2개 인라인

### 4-0. 진입 시 draft 정리

```
🎉 이론 끝! 이제 진짜 위임 작업을 만들어볼 시간이에요.

📝 전체 작업: <draft.parent_task>
📝 위임할 역할: <draft.subagent_role>
📝 입력: <draft.input_format>
📝 출력: <draft.output_format>

이걸 토대로 진짜 서브에이전트를 정의해볼게요.
```

### 4-1. 옵션 제시

```
어떤 작업으로 실습하시겠어요?

  (1) {{name}}님 본인 작업 (이론에서 적어주신 것)
  (2) 가상 사례 (예: "긴 문서 → 요약 + 액션아이템 추출")

번호로 답해주세요.
```

### 4-2. 옵션 ① — 본인 작업

`draft` 그대로 사용. 도구별 서브에이전트 호출 방식(부록 박스) 안내.

### 4-3. 옵션 ② — 가상 사례

강의 제공 시나리오 (예: 긴 회의록 → 서브에이전트가 요약 → 부모가 액션 추출).

### 4-4. 검증 기준

| 항목 | 통과 기준 |
|---|---|
| `subagent_role`이 *명확히 한 가지 책임* | ✅ |
| `input/output_format`이 *재현 가능한* 형태 | ✅ |
| 부모 → 서브에이전트 호출이 *실제로 작동* (1번 시연) | ✅ |

3개 중 2개 이상 ✅.

---

## 5. 자리표시자 처리
1강 동일.

---

## 6. 도구 비종속
도구별 서브에이전트 지원 차이는 부록 박스. 일부 도구에 없으면 *순차 실행*으로 폴백 안내.

---

## 7. 종료 시 행동
1. 진도 갱신.
2. 위임으로 절약된 *컨텍스트 양*을 한 줄로 가시화.
3. 다음 강의 안내 — 9강(hooks).

---

## 8. 강의 작성자 메타

- **트랙**: 심화 (advanced) 1강
- **선행**: 기초 1~7강 (권장)
- **분량**: 약 30분
- **외부 자료**: 도구별 서브에이전트 기능
- **비용**: 부분적 (LLM 호출 추가)
- **학습 목표**:
  - 좋은 위임 vs 나쁜 위임을 *기준*으로 구분
  - 본인 작업에서 위임 후보 1개를 골라 정의
  - 부모-서브에이전트 호출 흐름을 직접 시연
- **다음 강의**: 09-hooks

---

## 9. 빠른 자기 점검
- [ ] 학습자 프로필 읽음
- [ ] `📘 [Lesson 8 · 청크 X/Y]`
- [ ] 한 청크만, 끝에 ❓/🛠/🔀
- [ ] 자리표시자 채움
- [ ] 도구명 노출 X
- [ ] 시도 전 답 X
- [ ] `progress["08-subagents"]` 갱신
- [ ] 8강 추가: `track`이 `"advanced"`로 갱신됐는가