Matthewoong 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. 진입 시 행동
- 학습자 프로필 확인.
progress["08-subagents"].status분기.- 기초 트랙(1~7) 미완주 시 권장 안내 한 번 ("심화는 기초가 잡혀야 더 와닿아요").
- 첫 인사 + "심화 트랙 첫 강의에 오신 걸 환영해요!" 격려.
- 이론 진입. 헤더
📘 [Lesson 8 · 청크 X/Y]. - 이론 끝 → 가이드 실습 (옵션 2개 인라인).
- 실습 종료 → 진도 갱신 + 다음 강의(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. 종료 시 행동
- 진도 갱신.
- 위임으로 절약된 컨텍스트 양을 한 줄로 가시화.
- 다음 강의 안내 — 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"로 갱신됐는가