Show GN: PAIDEIA — KAIST 물리학과 & 수학과 복수전공생이 만든 시험 공부 전용 claude code 플러그인
(github.com/TaewoooPark)PAIDEIA – 내 강의자료로 시험 대비 지식베이스를 만드는 로컬 우선 Claude Code 플러그인
KAIST에서 물리학과 수리과학을 복수전공하고 있습니다. 시험 공부하면서 GPT에 PDF를 통째로 밀어넣는 친구들을 보면서 더 효율적인 방식에 대해 고민하다가, 직접 플러그인을 제작하였고 이를 오픈소스로 공개하였습니다!
대부분의 학생들은 강의자료, 과제, 솔루션, 기출을 한꺼번에 LLM에 넣고 “설명해줘”, “요약해줘”, “예상문제 만들어줘”라고 요청합니다. 하지만 실제 시험공부에서 중요한 건 단순 요약이 아니라, 그 과목에서 반복되는 풀이 패턴, 교수님의 과제 스타일, 내가 자주 틀리는 지점, 그리고 시험에 나올 확률이 높은 구간을 계속 추적하는 일입니다. 그래서 PAIDEIA를 만들었습니다.
PAIDEIA는 Claude Code용 Local-first를 지향합니다. 강의자료, 과제, 솔루션 PDF를 과목 폴더에 넣으면, 그 과목만을 위한 시험 대비 지식베이스를 생성합니다.
기능
- 강의자료/HW/솔루션 PDF를 Markdown으로 변환
- 솔루션에서 반복되는 풀이 패턴 추출
- 과제 커버리지를 기반으로 시험 가능성이 높은 영역 표시
- 패턴 카드, 약점 지도, 한 페이지 치트시트 생성
- 기존 문제의 twin variant 생성
- 모의고사 생성
- 손으로 푼 답안 PDF를 OCR로 읽고 reference solution과 비교해 채점
- 틀린 패턴을 누적해서 다음 드릴과 치트시트에 반영
- 모든 산출물을 plain Markdown으로 저장
배경
대학생들에게 필요한 것은 “더 친절한 AI 튜터”가 아니라, 내 강의자료와 내 실수를 계속 축적하는 과목별 학습 시스템입니다.
시험은 보통 일반적인 지식보다 특정 교수님의 스타일과 과제 분포에 더 강하게 묶여 있습니다. 같은 개념이라도 어떤 방식으로 출제되는지, 어떤 풀이 패턴이 반복되는지, 내가 어디서 자주 막히는지가 중요합니다. PAIDEIA는 그래서 대화형 챗봇보다는 편집 가능한 학습 그래프에 가깝습니다. 한 번 문제를 틀리면 그 실수가 약점 지도에 남고, 다음 연습문제와 치트시트에 반영됩니다.
Local-First
결과물은 특정 앱 안에 갇히지 않습니다. 과목별 폴더 안에 Markdown 파일로 남고, Obsidian 같은 도구에서도 그대로 열 수 있습니다. OCR은 기본적으로 Claude/Codex의 vision 흐름을 사용할 수 있고, 선택적으로 Qwen3-VL이나 Tesseract도 붙일 수 있게 했습니다.
많은 공대 전공자 분들의 사용을 통해 기능을 검증받고 싶은 마음에 공유합니다!
댓글과 토론
게시자입니다! README가 조금 긴 만큼 빠르게 이해할 수 있는 30초 데모 GIF와 sample-course 결과물을 추가하려고 합니다.
그 전에 많은 분들께 조언을 구하고 싶습니다!
- Claude Code plugin 형태의 사용 장벽 여부
- PDF → 패턴 추출 → 약점 지도 → 치트시트 흐름이 실제 시험공부에 쓸 만해 보이는지
- Markdown artifact로 남기는 local-first 구조가 매력적인지
의견 주시면 바로 검토해보겠습니다! 감사합니다
업데이트입니다!
조언 주신 것처럼 README에 실제 동작 흐름이 보이는 데모 영상을 추가했습니다. 링크에서 확인해보실 수 있습니다! https://github.com/TaewoooPark/PAIDEIA
- PAIDEIA가 어떤 문제를 풀려고 하는지 빠르게 보여주는 opening demo
- Claude Code 터미널에서 자연어로 플러그인을 실행하며 course materials → 분석 → weakmap/cheatsheet 흐름으로 이어지는 실제 사용 demo
- 결과물이 앱 안에 갇히지 않고 Markdown artifact로 남는 구조도 README에서 바로 확인할 수 있게 정리했습니다
특히 “실제 출력물이 어느 정도 나오는지 궁금하다”는 피드백이 있어서, 단순 설명보다 실제 터미널 인터랙션과 생성되는 학습 산출물이 보이도록 보강했습니다.
계속 피드백 주시면 바로 반영하겠습니다. 감사합니다!
저는 개인적으로 학습에서 적극 활용 중에 있습니다! 특히 쓰면 쓸수록 제 약점이 누적되는 만큼 사용이 길어질수록 맞춤화되어가는 것에 체감이 큰 것 같습니다.
의견 감사합니다! codex는 현재 별도 레포로 지원하고 있습니다! (https://github.com/TaewoooPark/PAIDEIA-codex) Gemini CLI도 제작 검토해보겠습니다.