E.P.F. English Pipeline Factory · 영어 기출지문 변형 공장 v1.0 · OPS
→ E.P.Q.
Big Layers
6
Pipeline Stages
8
Question Types
7
Status States
5
Difficulty Levels
1-5
Sub CLAUDE.md
6

🏭 Factory Floor — 6 베이

최상위 폴더 구조 (Step 1: Big Layer)
00 · ADMIN
00_admin/
프로젝트 전체 기준표·유형 규칙·체크리스트·스타일 가이드. 운영 헌법.
level-rubric.mdquestion-type-rules.mdchecklist-master.md
01 · SOURCE BANK
01_source_bank/
원문·기출지문·메타데이터의 읽기 전용 저장소. 절대 수정 금지.
middle-school/high-school/metadata/
02 · WORKBENCH
02_workbench/
실제 분석·변형·문제 제작 작업 공간. 모든 연쇄 작업이 여기서 일어남.
middle-school/grade-1~3high-school/grade-1~3
03 · OUTPUT
03_output/
검수 통과한 최종 산출물만. 학생용/교사용/정답표/CSV 형태별 분리.
student/teacher/answer-keys/excel-csv/
04 · QC
04_quality_control/
검수 결과·오류 로그·재작업 기록. 품질이 누적되는 곳.
error-log.mdreview-checklist.mdrewrite-log.md
99 · ARCHIVE
99_archive/
완료·폐기·구버전 보관. 지우지 말 것 — 다음 학기 룰 개선의 원천.
completed/rejected/old-versions/

🌳 3-Step 폴더 구조

Big Layer → Middle Layer → Final Layer

핵심 운영 원칙

  1. 원본은 절대 수정 금지. 01_source_bank/는 읽기 전용. 작업은 모두 02_workbench/에서.
  2. 분석 없이 문제 만들지 않는다. Stage 2 분석 산출물 없이 Stage 4(문제 생성) 진입 금지.
  3. 검수 통과만 03_output/으로. Stage 6 QC 체크리스트 8항목 모두 ✓인 문항만 final.
  4. 학생용·교사용·정답표는 항상 분리. 한 파일에 섞지 않음.
  5. 모든 지문은 source-meta.yaml + analysis 필수. 메타·분석 없으면 문제 생성 차단.

🔄 8-Stage Pipeline

Stage 0 (Source Intake) → Stage 7 (Export)

📐 Templates — 양식 모음

복사 → 즉시 프로젝트에 붙여넣기 가능

① source-meta.yaml — 지문 메타데이터

모든 원문은 이 양식으로 메타데이터를 기록한다. 출처 불명확 시 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: ""

② passage-analysis.md — 지문 분석 양식 (10 섹션)

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
- 애매한 해석:
- 복수 정답 가능성:
- 난이도 조정 필요:

③ Question Format — 객관식

## Q01. [문제 유형] 문제 제목

- Level:
- Target:
- Source Sentence:
- Question:
- Choices:
  1.
  2.
  3.
  4.
  5.
- Answer:
- Student Explanation:
- Teacher Note:
- Distractor Rationale:
- Possible Pitfall:

④ Question Format — 서술형 (부분영작)

## Q01. [부분영작]

- Level:
- Target Grammar:
- Korean Prompt:
- Required Words:
- Student Answer Space:
- Model Answer:
- Acceptable Answers:
- Common Wrong Answers:
- Explanation:
- Scoring Rubric:

⑤ Difficulty Rubric — 난이도 1~5

Level기준
1기본 의미 확인, 쉬운 어휘, 단문 중심
2교과서 수준, 기본 문법 적용
3내신 중간 난이도, 복합문 포함
4고난도 내신/모의고사형, 추론 필요
5상위권 변별, 복합 논리/고난도 구문
- Difficulty: 3/5
- Reason: 관계대명사와 문맥 어휘를 동시에 확인해야 함.

⑥ QC Checklist — 검수 체크리스트

# QC Checklist

## Source
- [ ] 원문이 보존되어 있는가?
- [ ] 출처 메타데이터가 작성되어 있는가?
- [ ] 사용 가능 상태가 표시되어 있는가?

## Analysis
- [ ] 주제와 논리 구조가 정리되어 있는가?
- [ ] 핵심 어휘와 어법 포인트가 정리되어 있는가?
- [ ] 변형 가능 포인트가 표시되어 있는가?

## Transformed Passage
- [ ] 단순 치환이 아닌 의미 있는 변형인가?
- [ ] 문법적으로 자연스러운가?
- [ ] 원문 학습 포인트가 유지되는가?
- [ ] 난이도 표시가 되어 있는가?

## Questions
- [ ] 문제 유형이 명확한가?
- [ ] 정답이 하나로 확정되는가?
- [ ] 오답 근거가 명확한가?
- [ ] 난이도가 적절한가?
- [ ] 학생용 해설이 충분한가?
- [ ] 교사용 메모가 있는가?

## Export
- [ ] 학생용과 교사용이 분리되어 있는가?
- [ ] 정답표가 따로 있는가?
- [ ] 최종 파일명이 규칙에 맞는가?
- [ ] 재작업 항목이 기록되었는가?

⑦ CSV/DB Format — 문항 데이터 필드

최종 문항을 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

⑧ Default Response Format — 작업 보고 양식

Claude가 작업 후 항상 이 형식으로 보고하도록 강제.

## 작업 요약
- 수행한 작업:

## 생성/수정 파일
- 파일 경로:

## 핵심 결과
- 지문 수:
- 변형 지문 수:
- 문항 수:
- 검수 상태:

## 확인 필요
- 사용자가 확인해야 할 항목:

## 다음 작업 제안
- 다음 단계:

💬 즉시 사용 프롬프트

5종 — 새 프로젝트 / 단일 / 일괄 / 문제 생성 / 최종 export

① First Prompt — 새 프로젝트 시작

프로젝트 폴더에서 Claude Code 첫 실행 시 입력.

이 프로젝트의 CLAUDE.md를 읽고, 지켜야 할 작업 규칙을 요약해주세요.

그 다음 현재 폴더 구조를 확인하고,
중등부/고등부 기출지문 변형 및 변형문제 제작 파이프라인에 맞게
누락된 폴더나 규칙 파일이 있는지 점검해주세요.

아직 파일은 수정하지 말고,
먼저 제안만 해주세요.

② Single Passage Prompt — 한 지문 작업

분석 단계만 먼저 수행. 문제는 별도 단계에서.

`00_source/source.txt`의 지문을 기준으로 작업해주세요.

1. 먼저 지문을 문장별로 번호화해주세요.
2. 중심 내용, 논리 구조, 핵심 어휘, 어법 포인트를 분석해주세요.
3. 변형 가능 포인트를 10개 뽑아주세요.
4. 그 다음 문제 제작 계획을 제안해주세요.
5. 아직 문제는 만들지 말고, 분석 결과만 먼저 저장해주세요.

③ Question Generation Prompt — 분석 후 문제 생성

passage-analysis.md가 준비된 다음 사용.

`02_analysis/passage-analysis.md`를 기준으로 문제를 만들어주세요.

필요한 문제:
- 독해 5문항
- 어법 5문항
- 어휘 5문항
- 단답형 5문항
- 부분영작 5문항
- 전체영작 3문항
- 패러프레이징 5문항

각 문항에는 다음을 포함하세요.
- 문제 유형
- 난이도
- 출제 포인트
- 정답
- 정답 근거
- 오답 근거
- 학생용 해설
- 교사용 메모

완료 후 QC 체크리스트를 실행하고,
애매한 문항은 `review_needed`로 표시하세요.

④ Batch Production Prompt — 여러 지문 일괄 처리

한 단원 또는 한 시험 분량을 한 번에.

다음 지문 세트를 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 문항만 포함하세요.

⑤ Final Export Prompt — 최종 산출물 묶기

모든 작업 완료 후 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 체크리스트를 다시 확인하세요.

📜 CLAUDE.md 6종

루트 헌법 1개 + 5개 베이별 sub-CLAUDE

🏛️ ROOT — /CLAUDE.md

프로젝트 전체 헌법. 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

프로젝트 전체 기준표 관리.

# 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

원문 저장소. 절대 수정 금지.

# 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

실제 작업 공간. 모든 가공이 여기서.

# 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로 이동하지 않습니다.
- 애매한 정답을 확정 답안으로 표시하지 않습니다.

🚀 03_output/CLAUDE.md

최종 산출물만. 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

검수·오류·재작업 기록.

# 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로 보내지 않습니다.

❓ 7가지 문제 유형 — 출제 규칙

유형별 작성 규칙·하위 유형·금지 사항

① 독해 (Reading)

12개 하위 유형 · 지문 근거 확정
  • 주제 / 제목 / 요지 / 주장 / 목적
  • 빈칸 / 순서 / 삽입 / 무관한 문장
  • 내용일치·불일치 / 지칭추론 / 함축의미

금지: 배경지식만으로 풀리는 문제. 고등부 빈칸은 단순 어휘 빈칸보다 논리 빈칸 우선.

② 어법 (Grammar)

5개 하위 유형 · 문법적 검증 가능
  • 밑줄 어법상 틀린 것
  • 어법상 적절한 것
  • 선택형 어법
  • 문장 내 오류 찾기
  • 문장 전환형 어법

금지: 단순히 어려운 문장이라고 어법 문제로 만들기. 학교문법과 실제 영어 충돌 시 반드시 표시.

③ 어휘 (Vocabulary)

6개 하위 유형 · 문맥 의미 우선
  • 문맥상 적절한 어휘
  • 문맥상 부적절한 어휘
  • 유의어 / 반의어 / 다의어
  • collocation / word family

금지: 단어장식 뜻 암기 문제. 유의어는 문맥 적합성까지 확인.

④ 단답형 (Short Answer)

5개 하위 유형 · 허용답안 필수
  • 핵심 내용 단답
  • 빈칸 단답 / 지칭 대상 쓰기
  • 이유/근거 쓰기
  • 문장 구조 기반 단답

필수: 허용답안·부분점수 기준·한국어/영어 답안 가능 여부.

⑤ 부분영작 (Partial Writing)

4개 하위 유형 · 목표 문법 명확
  • 한국어 의미를 바탕으로 일부 영어 완성
  • 주어진 단어 배열
  • 조건에 맞게 문장 일부 쓰기
  • 문법 포인트를 반영한 부분 변형

필수: 정답 단일 / 복수 허용 명시. 철자·대소문자·구두점 감점 기준.

⑥ 전체영작 (Full Writing)

4개 하위 유형 · 모델 답안 + 대체 표현
  • 한국어 문장 전체 영작
  • 조건어 포함 영작
  • 문장 전환 영작
  • 요약문 영작

평가 차이: 고등부는 문장 구조와 논리 연결 / 중등부는 핵심 문법과 기본 어순.

⑦ 패러프레이징 (Paraphrasing)

6개 하위 유형 · 의미 보존 최우선
  • 같은 의미 다른 표현
  • 구문 전환 / 접속사 전환
  • 능동/수동 전환
  • 관계사 / 분사구문 전환
  • 가정법/조동사/명사절 전환

금지: 단순 동의어 치환만 요구. 구조 전환을 활용해야 진짜 패러프레이즈.

🚫 변형 지문 금지 사항 (모든 유형 공통)

  • 원문 문장 순서만 바꾸기
  • 동의어 몇 개만 바꾸기
  • 원문 표현을 거의 그대로 유지하기
  • 문법적으로 어색한 변형
  • 원문의 논리를 왜곡하는 변형

✅ 변형 지문 허용 기준 (1개 이상 만족)

  1. 같은 주제를 다른 소재로 재구성
  2. 같은 논리 구조를 다른 사례로 적용
  3. 핵심 어법 포인트를 유지하되 문장 구조 변경
  4. 핵심 어휘군을 유지하되 collocation 변경
  5. 난이도 조절
  6. 서술형 출제 가능성을 높임
  7. 내신 시험에서 나올 만한 함정 포인트 삽입

⚙️ 운영 도구

파일명 빌더 + 상태 보드 + 점검 체크리스트

📝 파일명 빌더

학년·시험·단원·지문번호·산출물 유형·버전을 입력하면 표준 파일명을 자동 생성합니다. 학년_시험_단원_지문번호_산출물유형_버전.md 패턴.

생성 파일명 high2_2026-midterm_unit01_p001_questions-reading_v1.md

✓ 영어 소문자 + 하이픈 사용 / 한글·공백 금지 / 지문번호는 3자리 0-패딩

📋 Status Board — 문항 상태 보드 (Mock)

5개 상태(DRAFT REVIEW APPROVED REJECTED FINAL)의 흐름을 시연. 상태 클릭으로 다음 단계 전환.

Question IDType난이도Status (클릭 → 다음)

흐름: draft → review_needed → approved → final / 또는 rejected (재작업 후 draft로)

🚀 5단계 부트스트랩

새 프로젝트 시작 시 이 순서대로.

  1. 루트 CLAUDE.md 작성 — Tab 5의 ROOT 템플릿 복사 → exam-passage-pipeline/CLAUDE.md
  2. 00_admin/ 3개 파일 생성 — question-type-rules.md, level-rubric.md, checklist-master.md (이 순서)
  3. 원문 입력 — 01_source_bank/에 원문 + source-meta.yaml
  4. 첫 지문 작업 — Tab 4의 "Single Passage Prompt" 사용
  5. QC → Final — Stage 6 검수 8항목 통과 후 03_output/ 승격
유지 룰: 1주차에 모든 파일을 다 만들지 말 것. 안 쓰는 룰이 누적되면 Claude의 주의력이 분산됨. 처음엔 reading-questions.md + quality-control.md 2개만 있어도 충분.

🔧 Maintenance — 월간 점검

  • 📅 1개월 1회: 문항 품질 기준 재점검
  • 📝 누적: 04_quality_control/error-log.md에 실제 시험 오류 기록
  • 🗂️ 분리: 자주 쓰는 문항 템플릿은 00_admin/question-type-rules.md로 이동
  • ⚠️ CLAUDE.md 분량: 300줄 초과 시 분리 신호 — 세부 룰을 sub-CLAUDE로 이동
  • 🔄 학기 말: 99_archive/rejected/ 패턴 분석 → 다음 학기 룰에 반영