모든 원문은 이 양식으로 메타데이터를 기록한다. 출처 불명확 시 source_status: 확인 필요.
source_id: high2-2026-midterm-unit01-p001 level: high-school grade: 2 exam_type: midterm school_or_source: 확인 필요 unit: unit-01 passage_number: 001 source_status: user-provided copyright_status: user-provided_or_licensed topic: "" genre: expository word_count: 0 target_output: - transformed_passage - reading_questions - grammar_questions - vocabulary_questions - short_answer - partial_writing - full_writing - paraphrasing notes: ""
Stage 2의 핵심 산출물. 이 분석이 모든 후속 작업의 단일 정보원(SSoT).
# Passage Analysis ## 1. Basic Info - Source ID: - Level: - Grade: - Topic: - Genre: - Word Count: ## 2. One-Sentence Summary ## 3. Main Idea ## 4. Logical Flow 1. 도입: 2. 전개: 3. 반전/대조: 4. 결론: ## 5. Sentence-by-Sentence Notes | Sentence | Function | Key Grammar | Key Vocabulary | Transformation Point | |---|---|---|---|---| ## 6. Grammar Points - 출제 가능한 어법 포인트: - 피해야 할 억지 포인트: ## 7. Vocabulary Points - 핵심 어휘: - 유의어: - 반의어: - collocation: ## 8. Reading Question Potential - 주제: / 제목: / 빈칸: / 순서: / 삽입: / 무관한 문장: ## 9. Writing Potential - 부분영작 포인트: - 전체영작 포인트: - 패러프레이징 포인트: ## 10. Risk Notes - 애매한 해석: - 복수 정답 가능성: - 난이도 조정 필요:
## Q01. [문제 유형] 문제 제목 - Level: - Target: - Source Sentence: - Question: - Choices: 1. 2. 3. 4. 5. - Answer: - Student Explanation: - Teacher Note: - Distractor Rationale: - Possible Pitfall:
## Q01. [부분영작] - Level: - Target Grammar: - Korean Prompt: - Required Words: - Student Answer Space: - Model Answer: - Acceptable Answers: - Common Wrong Answers: - Explanation: - Scoring Rubric:
| Level | 기준 |
|---|---|
| 1 | 기본 의미 확인, 쉬운 어휘, 단문 중심 |
| 2 | 교과서 수준, 기본 문법 적용 |
| 3 | 내신 중간 난이도, 복합문 포함 |
| 4 | 고난도 내신/모의고사형, 추론 필요 |
| 5 | 상위권 변별, 복합 논리/고난도 구문 |
- Difficulty: 3/5 - Reason: 관계대명사와 문맥 어휘를 동시에 확인해야 함.
# QC Checklist ## Source - [ ] 원문이 보존되어 있는가? - [ ] 출처 메타데이터가 작성되어 있는가? - [ ] 사용 가능 상태가 표시되어 있는가? ## Analysis - [ ] 주제와 논리 구조가 정리되어 있는가? - [ ] 핵심 어휘와 어법 포인트가 정리되어 있는가? - [ ] 변형 가능 포인트가 표시되어 있는가? ## Transformed Passage - [ ] 단순 치환이 아닌 의미 있는 변형인가? - [ ] 문법적으로 자연스러운가? - [ ] 원문 학습 포인트가 유지되는가? - [ ] 난이도 표시가 되어 있는가? ## Questions - [ ] 문제 유형이 명확한가? - [ ] 정답이 하나로 확정되는가? - [ ] 오답 근거가 명확한가? - [ ] 난이도가 적절한가? - [ ] 학생용 해설이 충분한가? - [ ] 교사용 메모가 있는가? ## Export - [ ] 학생용과 교사용이 분리되어 있는가? - [ ] 정답표가 따로 있는가? - [ ] 최종 파일명이 규칙에 맞는가? - [ ] 재작업 항목이 기록되었는가?
최종 문항을 Excel/CSV로 export하기 위한 표준 필드.
question_id,source_id,level,grade,question_type,difficulty,target_point,question,choice_1,choice_2,choice_3,choice_4,choice_5,answer,student_explanation,teacher_note,status
status 값: draft / review_needed / approved / rejected / final
Claude가 작업 후 항상 이 형식으로 보고하도록 강제.
## 작업 요약 - 수행한 작업: ## 생성/수정 파일 - 파일 경로: ## 핵심 결과 - 지문 수: - 변형 지문 수: - 문항 수: - 검수 상태: ## 확인 필요 - 사용자가 확인해야 할 항목: ## 다음 작업 제안 - 다음 단계:
프로젝트 폴더에서 Claude Code 첫 실행 시 입력.
이 프로젝트의 CLAUDE.md를 읽고, 지켜야 할 작업 규칙을 요약해주세요. 그 다음 현재 폴더 구조를 확인하고, 중등부/고등부 기출지문 변형 및 변형문제 제작 파이프라인에 맞게 누락된 폴더나 규칙 파일이 있는지 점검해주세요. 아직 파일은 수정하지 말고, 먼저 제안만 해주세요.
분석 단계만 먼저 수행. 문제는 별도 단계에서.
`00_source/source.txt`의 지문을 기준으로 작업해주세요. 1. 먼저 지문을 문장별로 번호화해주세요. 2. 중심 내용, 논리 구조, 핵심 어휘, 어법 포인트를 분석해주세요. 3. 변형 가능 포인트를 10개 뽑아주세요. 4. 그 다음 문제 제작 계획을 제안해주세요. 5. 아직 문제는 만들지 말고, 분석 결과만 먼저 저장해주세요.
passage-analysis.md가 준비된 다음 사용.
`02_analysis/passage-analysis.md`를 기준으로 문제를 만들어주세요. 필요한 문제: - 독해 5문항 - 어법 5문항 - 어휘 5문항 - 단답형 5문항 - 부분영작 5문항 - 전체영작 3문항 - 패러프레이징 5문항 각 문항에는 다음을 포함하세요. - 문제 유형 - 난이도 - 출제 포인트 - 정답 - 정답 근거 - 오답 근거 - 학생용 해설 - 교사용 메모 완료 후 QC 체크리스트를 실행하고, 애매한 문항은 `review_needed`로 표시하세요.
한 단원 또는 한 시험 분량을 한 번에.
다음 지문 세트를 CLAUDE.md 규칙에 따라 처리해주세요. 작업 범위: 1. source-meta.yaml 작성 2. 문장 번호 부여 3. 지문 분석 4. 변형 지문 3종 생성 - 쉬운 버전 - 같은 난이도 버전 - 어려운 버전 5. 문제 생성 - 독해 5문항 - 어법 5문항 - 어휘 5문항 - 단답형 5문항 - 부분영작 5문항 - 전체영작 3문항 - 패러프레이징 5문항 6. 정답표 생성 7. 학생용 해설 생성 8. 교사용 해설 생성 9. QC 체크리스트 작성 주의: - 원문은 수정하지 마세요. - 정답 근거를 반드시 표시하세요. - 애매한 문항은 review_needed로 표시하세요. - 최종본은 approved 문항만 포함하세요.
모든 작업 완료 후 03_output/으로 승격.
현재 passage 폴더의 approved 자료만 모아서 최종 산출물을 만들어주세요. 필요한 파일: 1. 학생용 문제지 2. 교사용 해설지 3. 정답표 4. 문항 데이터 CSV 5. export-manifest.md 주의: - 학생용 문제지에는 정답이 노출되면 안 됩니다. - 교사용 해설지에는 정답 근거와 오답 근거를 포함하세요. - 문항 데이터 CSV는 question_id, source_id, question_type, difficulty, answer, status 필드를 포함하세요. - final export 전에 QC 체크리스트를 다시 확인하세요.
프로젝트 전체 헌법. 300줄 이내 유지. 세부는 sub-CLAUDE로 분리.
# CLAUDE.md ## Project Summary 이 프로젝트는 한국 중등부/고등부 영어강사를 위한 기출지문 변형 및 변형문제 제작 파이프라인입니다. 산출물: - 변형 지문 / 독해문제 / 어법문제 / 어휘문제 - 단답형 / 부분영작 / 전체영작 / 패러프레이징 - 정답표 / 학생용 해설 / 교사용 해설 - 최종 배포용 Markdown/PDF-ready/HTML/Excel 데이터 이 프로젝트는 단발성 문제 제작이 아니라, 반복 가능한 교육 콘텐츠 제작 시스템입니다. ## User Context - 사용자는 한국에서 중등부/고등부 영어를 가르치는 강사 또는 원장입니다. - 결과물은 내신, 모의고사, 수능형 독해, 학교별 시험 대비에 활용됩니다. - 설명은 한국어 존대말로 작성합니다. ## Core Principle 원문을 그대로 복사하는 것이 아니라, 원문의 핵심 학습 포인트를 분석한 뒤 교육 목적에 맞게 변형합니다. 순서: 1. 원문 보존 2. 지문 분석 3. 변형 지문 생성 4. 유형별 문제 제작 5. 정답 및 해설 생성 6. 검수 7. 학생용/교사용 최종본 분리 ## Target Levels ### Middle School - 중1: 쉬운 문장 구조, 기본 시제, 기본 접속사, 필수 어휘 - 중2: 관계대명사, to부정사, 동명사, 비교, 수동태 기초 - 중3: 분사, 관계사 심화, 가정법 기초, 간접의문문, 문장 삽입/순서 ### High School - 고1: 모의고사식 중심내용, 빈칸, 어휘, 어법, 지칭추론 - 고2: 추상적 소재, 논리 전개, 문장 삽입, 순서, 어법 심화 - 고3: 수능형 고난도 구조, 빈칸 추론, 함축 의미, 요약, 장문 독해 ## Standard Workflow 0. Source Intake → 1. Cleaning → 2. Passage Analysis → 3. Transformation → 4. Question Generation → 5. Answer & Explanation → 6. Quality Control → 7. Export ## File Naming Rules 학년_시험_단원_지문번호_산출물유형_버전.md 예) high2_2026-midterm_unit01_p001_analysis_v1.md ## Do Not - 원문 파일을 직접 덮어쓰지 않습니다. - 출처가 불명확한 지문을 확정 자료처럼 다루지 않습니다. - 정답이 애매한 문제를 최종본으로 만들지 않습니다. - 오답선지를 억지로 만들지 않습니다. - 단순 동의어 치환만으로 변형 지문이라고 하지 않습니다. - 검수 없이 final 폴더로 보내지 않습니다. ## Maintenance Rules - CLAUDE.md는 300줄 내외로 유지합니다. - 세부 규칙은 00_admin/ 또는 각 폴더의 CLAUDE.md로 분리합니다. - 1개월에 한 번 문항 품질 기준을 점검합니다.
프로젝트 전체 기준표 관리.
# 00_admin/CLAUDE.md ## Purpose 이 폴더는 프로젝트 전체 기준표를 관리합니다. ## Files - level-rubric.md: 중등부/고등부 난이도 기준 - question-type-rules.md: 문제 유형별 제작 규칙 - output-format-rules.md: 최종 산출물 형식 - style-guide.md: 학생용/교사용 문체 기준 - checklist-master.md: 전체 검수 체크리스트 ## Rules - 이 폴더의 파일은 프로젝트 전체 규칙입니다. - 임시 아이디어를 바로 반영하지 않습니다. - 규칙 변경 시 변경 이유를 기록합니다. - 충돌 시 루트 CLAUDE.md와 이 폴더 규칙을 우선합니다. ## Do Not - 검증되지 않은 문제 유형을 공식 규칙으로 넣지 않습니다. - 중등부와 고등부 기준을 섞어서 쓰지 않습니다. - 오래된 규칙을 남겨 충돌을 만들지 않습니다.
원문 저장소. 절대 수정 금지.
# 01_source_bank/CLAUDE.md ## Purpose 이 폴더는 원문과 출처 정보를 보관합니다. ## Rules - 원문은 직접 수정하지 않습니다. - OCR 정리본은 02_workbench/에서 작업합니다. - 모든 원문에는 source metadata가 있어야 합니다. - 출처 불명확 자료는 source_status: 확인 필요로 표시합니다. ## Required Metadata source_id / level / grade / exam_type / source_status / copyright_status / topic / genre / word_count / target_output ## Do Not - 원문을 덮어쓰지 않습니다. - 출처가 불명확한 자료를 final output에 사용하지 않습니다. - 원문 전체를 불필요하게 복제하지 않습니다.
실제 작업 공간. 모든 가공이 여기서.
# 02_workbench/CLAUDE.md ## Purpose 이 폴더는 실제 지문 분석, 변형, 문제 제작을 수행하는 작업 공간입니다. ## Workflow 1. source intake → 2. cleaning → 3. analysis → 4. transformation → 5. question generation → 6. answer/explanation → 7. quality control → 8. export ## Rules - 모든 지문은 passage-001, passage-002 형식으로 관리합니다. - 분석 없이 문제부터 만들지 않습니다. - 변형 지문 없이 변형문제를 만들 경우 반드시 원문 기반 문제임을 표시합니다. - 문제 유형별 폴더를 분리합니다. - draft와 final을 구분합니다. ## Do Not - source 폴더의 원문을 수정하지 않습니다. - 검수되지 않은 문항을 final로 이동하지 않습니다. - 애매한 정답을 확정 답안으로 표시하지 않습니다.
최종 산출물만. draft 진입 금지.
# 03_output/CLAUDE.md ## Purpose 이 폴더는 최종 산출물만 보관합니다. ## Output Types - student / teacher / answer-keys - md / pdf-ready / html / excel-csv ## Rules - student 버전에는 정답과 해설을 포함하지 않습니다. - teacher 버전에는 정답, 해설, 오답 근거, 수업 메모를 포함합니다. - answer-key는 빠른 채점을 위해 간결하게 만듭니다. - pdf-ready는 인쇄용 구조로 정리합니다. - excel-csv는 문항 DB화를 위한 필드를 유지합니다. ## Do Not - draft 파일을 output에 넣지 않습니다. - 검수되지 않은 문항을 최종본에 넣지 않습니다. - 학생용 파일에 정답이 노출되게 하지 않습니다.
검수·오류·재작업 기록.
# 04_quality_control/CLAUDE.md ## Purpose 이 폴더는 품질 검수, 오류 로그, 재작업 기록을 관리합니다. ## QC Categories - source issue / grammar issue / answer ambiguity - distractor issue / level mismatch / explanation weakness - formatting issue / copyright/source issue ## Rules - 오류는 숨기지 말고 기록합니다. - 애매한 문항은 review_needed로 표시합니다. - 재작업 사유를 남깁니다. - 반복 오류는 checklist에 반영합니다. ## Do Not - 문제가 있는 문항을 approved로 바꾸지 않습니다. - 정답 근거가 약한 문제를 통과시키지 않습니다. - 학생용 해설이 빈약한 문제를 final로 보내지 않습니다.
금지: 배경지식만으로 풀리는 문제. 고등부 빈칸은 단순 어휘 빈칸보다 논리 빈칸 우선.
금지: 단순히 어려운 문장이라고 어법 문제로 만들기. 학교문법과 실제 영어 충돌 시 반드시 표시.
금지: 단어장식 뜻 암기 문제. 유의어는 문맥 적합성까지 확인.
필수: 허용답안·부분점수 기준·한국어/영어 답안 가능 여부.
필수: 정답 단일 / 복수 허용 명시. 철자·대소문자·구두점 감점 기준.
평가 차이: 고등부는 문장 구조와 논리 연결 / 중등부는 핵심 문법과 기본 어순.
금지: 단순 동의어 치환만 요구. 구조 전환을 활용해야 진짜 패러프레이즈.
학년·시험·단원·지문번호·산출물 유형·버전을 입력하면 표준 파일명을 자동 생성합니다. 학년_시험_단원_지문번호_산출물유형_버전.md 패턴.
✓ 영어 소문자 + 하이픈 사용 / 한글·공백 금지 / 지문번호는 3자리 0-패딩
5개 상태(DRAFT REVIEW APPROVED REJECTED FINAL)의 흐름을 시연. 상태 클릭으로 다음 단계 전환.
| Question ID | Type | 난이도 | Status (클릭 → 다음) |
|---|
흐름: draft → review_needed → approved → final / 또는 rejected (재작업 후 draft로)
새 프로젝트 시작 시 이 순서대로.
exam-passage-pipeline/CLAUDE.mdquestion-type-rules.md, level-rubric.md, checklist-master.md (이 순서)01_source_bank/에 원문 + source-meta.yaml03_output/ 승격04_quality_control/error-log.md에 실제 시험 오류 기록00_admin/question-type-rules.md로 이동99_archive/rejected/ 패턴 분석 → 다음 학기 룰에 반영