Language Tutor — 외국어 학습 풀 파이프라인
레벨 테스트→커리큘럼 설계→레슨 생성→퀴즈 출제→복습 관리를 에이전트 팀이 협업하여 제공한다.
실행 모드
에이전트 팀 — 5명이 SendMessage로 직접 통신하며 교차 검증한다.
에이전트 구성
| 에이전트 |
파일 |
역할 |
타입 |
| level-assessor |
.claude/agents/level-assessor.md |
CEFR 기반 레벨 진단, 영역별 강약점 분석 |
general-purpose |
| curriculum-designer |
.claude/agents/curriculum-designer.md |
맞춤 커리큘럼, 주차별 계획, 학습 전략 |
general-purpose |
| lesson-tutor |
.claude/agents/lesson-tutor.md |
문법·어휘·회화·읽기·쓰기 레슨 생성 |
general-purpose |
| quiz-master |
.claude/agents/quiz-master.md |
다양한 유형 퀴즈, 난이도 조절, 채점 |
general-purpose |
| review-coach |
.claude/agents/review-coach.md |
간격 반복, 약점 보강, 진도 관리, 동기 부여 |
general-purpose |
워크플로우
Phase 1: 준비 (오케스트레이터 직접 수행)
- 사용자 입력에서 추출한다:
- 학습 언어: 어떤 외국어를 배우려는가
- 모국어: 학습자의 모국어 (기본: 한국어)
- 학습 경험: 이전 학습 경험과 현재 수준 자가 평가
- 학습 목표: 여행/업무/시험/이민/취미 등 구체적 목표
- 가용 시간: 주당 투입 가능한 학습 시간
- 기존 자료 (선택): 기존 학습 자료, 시험 점수 등
_workspace/ 디렉토리를 프로젝트 루트에 생성한다
- 입력을 정리하여
_workspace/00_input.md에 저장한다
Phase 2: 팀 구성 및 실행
| 순서 |
작업 |
담당 |
의존 |
산출물 |
| 1 |
레벨 평가 |
level-assessor |
없음 |
_workspace/01_level_assessment.md |
| 2 |
커리큘럼 설계 |
curriculum-designer |
작업 1 |
_workspace/02_curriculum.md |
| 3 |
첫 레슨 생성 |
lesson-tutor |
작업 2 |
_workspace/03_lesson_01.md |
| 4 |
첫 퀴즈 출제 |
quiz-master |
작업 3 |
_workspace/04_quiz_01.md |
| 5 |
복습 계획 수립 |
review-coach |
작업 2, 3, 4 |
_workspace/05_review_plan.md |
팀원 간 소통 흐름:
- level-assessor 완료 → curriculum-designer에게 영역별 레벨·강약점·학습 목표·가용 시간 전달
- curriculum-designer 완료 → lesson-tutor에게 Week 1 학습 주제·문법·어휘 전달, quiz-master에게 마일스톤 기준 전달
- lesson-tutor 완료 → quiz-master에게 핵심 학습 항목 전달, review-coach에게 학습 항목 전달
- quiz-master → review-coach에게 결과 전달 → 약점 보강 + 복습 스케줄 생성
연속 학습 사이클:
레슨→퀴즈→복습은 반복적으로 실행된다. 사용자가 추가 레슨을 요청하면:
- lesson-tutor가 다음 레슨 생성 (
03_lesson_02.md, 03_lesson_03.md, ...)
- quiz-master가 해당 레슨 퀴즈 출제 (
04_quiz_02.md, ...)
- review-coach가 복습 계획 업데이트 + 진도 보고서 생성
Phase 3: 진도 보고
review-coach가 주기적으로 진도 보고서를 생성한다:
_workspace/06_progress_report.md — 전체 진행률, 영역별 성장, 퀴즈 추이, 학습 패턴
작업 규모별 모드
| 사용자 요청 패턴 |
실행 모드 |
투입 에이전트 |
| "영어 공부 시작하고 싶어" |
풀 파이프라인 |
5명 전원 |
| "내 영어 레벨 테스트해줘" |
진단 모드 |
level-assessor 단독 |
| "영어 문법 레슨 해줘" |
레슨 모드 |
lesson-tutor (+ level-assessor 필요 시) |
| "이 단원 퀴즈 내줘" |
퀴즈 모드 |
quiz-master 단독 |
| "복습 계획 세워줘" |
복습 모드 |
review-coach 단독 |
| "TOEIC 준비 커리큘럼 만들어줘" |
시험 특화 모드 |
level-assessor + curriculum-designer + quiz-master |
레벨 자동 감지: 사용자가 레벨을 모르는 경우, 대화 중 사용하는 표현 수준으로 잠정 레벨을 추정하고 진단 테스트를 제안한다.
데이터 전달 프로토콜
| 전략 |
방식 |
용도 |
| 파일 기반 |
_workspace/ 디렉토리 |
주요 산출물 저장 및 공유 |
| 메시지 기반 |
SendMessage |
실시간 핵심 정보 전달, 난이도 조정 요청 |
| 태스크 기반 |
TaskCreate/TaskUpdate |
진행 상황 추적, 학습 사이클 관리 |
파일명 컨벤션: {순번}_{산출물}_{번호}.{확장자}
에러 핸들링
| 에러 유형 |
전략 |
| 학습 언어 미지정 |
영어를 기본으로 시작하되, 확인 요청 |
| 레벨 진단 거부 |
자가 평가 기반 잠정 레벨 설정, 첫 레슨에서 조정 |
| 에이전트 실패 |
1회 재시도 → 실패 시 해당 산출물 없이 진행 |
| 난이도 불일치 |
학습자 피드백 반영하여 즉시 조정, 커리큘럼 수정 |
| 특수 언어 지원 한계 |
지원 가능 범위 안내, 주요 언어(영/일/중/스/불/독)에 집중 |
테스트 시나리오
정상 흐름
프롬프트: "영어 회화를 잘하고 싶어. 해외 출장이 잦은 직장인이고, 주 5시간 정도 공부할 수 있어."
기대 결과:
- 레벨 평가: 적응형 진단 테스트 실시, 영역별 CEFR 레벨 판정
- 커리큘럼: 비즈니스 영어 중심 12주 계획, 회화+이메일+프레젠테이션
- 첫 레슨: 비즈니스 인사·자기소개 패턴 + 핵심 어휘 20개
- 퀴즈: Lesson 1 내용 기반 15문항
- 복습 계획: 간격 반복 스케줄 + 약점 보강 활동
기존 파일 활용 흐름
프롬프트: "이 토익 성적표를 기반으로 약점 보강 커리큘럼 만들어줘" + 성적표 파일 첨부
기대 결과:
- 성적표를
_workspace/01_level_assessment.md의 참고 자료로 복사
- level-assessor가 성적표 기반으로 영역별 레벨 판정 (별도 진단 테스트 간소화)
- curriculum-designer + lesson-tutor + quiz-master + review-coach 투입
에러 흐름
프롬프트: "외국어 좀 배워볼까"
기대 결과:
- 학습 언어 미지정 → 영어 기본 제안 + 다른 언어 선택지 안내
- 학습 목표 불명확 → 3가지 목표(여행/업무/취미) 제안 후 선택 요청
- 선택 완료 후 풀 파이프라인 실행
에이전트별 확장 스킬
에이전트의 도메인 전문성을 강화하는 확장 스킬:
| 에이전트 |
확장 스킬 |
역할 |
| review-coach |
spaced-repetition |
SM-2 알고리즘, 에빙하우스 망각곡선, 복습 세션 설계 |
| level-assessor |
cefr-assessment |
CEFR 6단계 기술자, 적응형 진단 테스트, CEFR-시험 매핑 |
1---2name: language-tutor-23description: 외국어 학습 풀 파이프라인. 레벨 테스트→커리큘럼 설계→레슨 생성→퀴즈 출제→복습 관리를 에이전트 팀이 협업하여 제공한다. '영어 공부', '일본어 학습', '외국어 배우기', '언어 학습', '영어 문법', '회화 연습', '레벨 테스트', '어휘 암기', '영어 독학', '중국어 입문', 'TOEIC 준비', '영어 회화' 등 외국어 학습 전반에 이 스킬을 사용한다. 특정 영역만 학습하는 것도 지원한다. 단, 실시간 음성 대화(STT/TTS), 원어민 매칭, 공인 시험 응시 대행은 이 스킬의 범위가 아니다.4---56# Language Tutor — 외국어 학습 풀 파이프라인78레벨 테스트→커리큘럼 설계→레슨 생성→퀴즈 출제→복습 관리를 에이전트 팀이 협업하여 제공한다.910## 실행 모드1112**에이전트 팀** — 5명이 SendMessage로 직접 통신하며 교차 검증한다.1314## 에이전트 구성1516| 에이전트 | 파일 | 역할 | 타입 |17|---------|------|------|------|18| level-assessor | `.claude/agents/level-assessor.md` | CEFR 기반 레벨 진단, 영역별 강약점 분석 | general-purpose |19| curriculum-designer | `.claude/agents/curriculum-designer.md` | 맞춤 커리큘럼, 주차별 계획, 학습 전략 | general-purpose |20| lesson-tutor | `.claude/agents/lesson-tutor.md` | 문법·어휘·회화·읽기·쓰기 레슨 생성 | general-purpose |21| quiz-master | `.claude/agents/quiz-master.md` | 다양한 유형 퀴즈, 난이도 조절, 채점 | general-purpose |22| review-coach | `.claude/agents/review-coach.md` | 간격 반복, 약점 보강, 진도 관리, 동기 부여 | general-purpose |2324## 워크플로우2526### Phase 1: 준비 (오케스트레이터 직접 수행)27281. 사용자 입력에서 추출한다:29 - **학습 언어**: 어떤 외국어를 배우려는가30 - **모국어**: 학습자의 모국어 (기본: 한국어)31 - **학습 경험**: 이전 학습 경험과 현재 수준 자가 평가32 - **학습 목표**: 여행/업무/시험/이민/취미 등 구체적 목표33 - **가용 시간**: 주당 투입 가능한 학습 시간34 - **기존 자료** (선택): 기존 학습 자료, 시험 점수 등352. `_workspace/` 디렉토리를 프로젝트 루트에 생성한다363. 입력을 정리하여 `_workspace/00_input.md`에 저장한다3738### Phase 2: 팀 구성 및 실행3940| 순서 | 작업 | 담당 | 의존 | 산출물 |41|------|------|------|------|--------|42| 1 | 레벨 평가 | level-assessor | 없음 | `_workspace/01_level_assessment.md` |43| 2 | 커리큘럼 설계 | curriculum-designer | 작업 1 | `_workspace/02_curriculum.md` |44| 3 | 첫 레슨 생성 | lesson-tutor | 작업 2 | `_workspace/03_lesson_01.md` |45| 4 | 첫 퀴즈 출제 | quiz-master | 작업 3 | `_workspace/04_quiz_01.md` |46| 5 | 복습 계획 수립 | review-coach | 작업 2, 3, 4 | `_workspace/05_review_plan.md` |4748**팀원 간 소통 흐름:**49- level-assessor 완료 → curriculum-designer에게 영역별 레벨·강약점·학습 목표·가용 시간 전달50- curriculum-designer 완료 → lesson-tutor에게 Week 1 학습 주제·문법·어휘 전달, quiz-master에게 마일스톤 기준 전달51- lesson-tutor 완료 → quiz-master에게 핵심 학습 항목 전달, review-coach에게 학습 항목 전달52- quiz-master → review-coach에게 결과 전달 → 약점 보강 + 복습 스케줄 생성5354**연속 학습 사이클:**55레슨→퀴즈→복습은 반복적으로 실행된다. 사용자가 추가 레슨을 요청하면:561. lesson-tutor가 다음 레슨 생성 (`03_lesson_02.md`, `03_lesson_03.md`, ...)572. quiz-master가 해당 레슨 퀴즈 출제 (`04_quiz_02.md`, ...)583. review-coach가 복습 계획 업데이트 + 진도 보고서 생성5960### Phase 3: 진도 보고6162review-coach가 주기적으로 진도 보고서를 생성한다:63- `_workspace/06_progress_report.md` — 전체 진행률, 영역별 성장, 퀴즈 추이, 학습 패턴6465## 작업 규모별 모드6667| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |68|----------------|----------|-------------|69| "영어 공부 시작하고 싶어" | **풀 파이프라인** | 5명 전원 |70| "내 영어 레벨 테스트해줘" | **진단 모드** | level-assessor 단독 |71| "영어 문법 레슨 해줘" | **레슨 모드** | lesson-tutor (+ level-assessor 필요 시) |72| "이 단원 퀴즈 내줘" | **퀴즈 모드** | quiz-master 단독 |73| "복습 계획 세워줘" | **복습 모드** | review-coach 단독 |74| "TOEIC 준비 커리큘럼 만들어줘" | **시험 특화 모드** | level-assessor + curriculum-designer + quiz-master |7576**레벨 자동 감지**: 사용자가 레벨을 모르는 경우, 대화 중 사용하는 표현 수준으로 잠정 레벨을 추정하고 진단 테스트를 제안한다.7778## 데이터 전달 프로토콜7980| 전략 | 방식 | 용도 |81|------|------|------|82| 파일 기반 | `_workspace/` 디렉토리 | 주요 산출물 저장 및 공유 |83| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 난이도 조정 요청 |84| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 학습 사이클 관리 |8586파일명 컨벤션: `{순번}_{산출물}_{번호}.{확장자}`8788## 에러 핸들링8990| 에러 유형 | 전략 |91|----------|------|92| 학습 언어 미지정 | 영어를 기본으로 시작하되, 확인 요청 |93| 레벨 진단 거부 | 자가 평가 기반 잠정 레벨 설정, 첫 레슨에서 조정 |94| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행 |95| 난이도 불일치 | 학습자 피드백 반영하여 즉시 조정, 커리큘럼 수정 |96| 특수 언어 지원 한계 | 지원 가능 범위 안내, 주요 언어(영/일/중/스/불/독)에 집중 |9798## 테스트 시나리오99100### 정상 흐름101**프롬프트**: "영어 회화를 잘하고 싶어. 해외 출장이 잦은 직장인이고, 주 5시간 정도 공부할 수 있어."102**기대 결과**:103- 레벨 평가: 적응형 진단 테스트 실시, 영역별 CEFR 레벨 판정104- 커리큘럼: 비즈니스 영어 중심 12주 계획, 회화+이메일+프레젠테이션105- 첫 레슨: 비즈니스 인사·자기소개 패턴 + 핵심 어휘 20개106- 퀴즈: Lesson 1 내용 기반 15문항107- 복습 계획: 간격 반복 스케줄 + 약점 보강 활동108109### 기존 파일 활용 흐름110**프롬프트**: "이 토익 성적표를 기반으로 약점 보강 커리큘럼 만들어줘" + 성적표 파일 첨부111**기대 결과**:112- 성적표를 `_workspace/01_level_assessment.md`의 참고 자료로 복사113- level-assessor가 성적표 기반으로 영역별 레벨 판정 (별도 진단 테스트 간소화)114- curriculum-designer + lesson-tutor + quiz-master + review-coach 투입115116### 에러 흐름117**프롬프트**: "외국어 좀 배워볼까"118**기대 결과**:119- 학습 언어 미지정 → 영어 기본 제안 + 다른 언어 선택지 안내120- 학습 목표 불명확 → 3가지 목표(여행/업무/취미) 제안 후 선택 요청121- 선택 완료 후 풀 파이프라인 실행122123## 에이전트별 확장 스킬124125에이전트의 도메인 전문성을 강화하는 확장 스킬:126127| 에이전트 | 확장 스킬 | 역할 |128|---------|----------|------|129| review-coach | `spaced-repetition` | SM-2 알고리즘, 에빙하우스 망각곡선, 복습 세션 설계 |130| level-assessor | `cefr-assessment` | CEFR 6단계 기술자, 적응형 진단 테스트, CEFR-시험 매핑 |