Browse / Teaching & study / Second brain / Software development / electrical-engineer-understanding-notes-generator
electrical-engineer-understanding-notes-generator
mivomad33
A Claude Code workspace that rewrites a condensed Korean Electrical Engineer exam textbook into understanding notes
Open mivomad33/electrical-engineer-understanding-notes-generator → Checked against the four rules.
Built for Claude Code
ships .claude CLAUDE.md and nothing for other agents.
In its own words
시험 대비 요약 교재를, 개념이 끊기지 않고 이어지는 이해 노트로 다시 쓰는 Claude Code 작업 환경
소개
전기기사 필기 수험서는 대부분 요약집입니다. 공식이 나열되어 있을 뿐, 그 공식이 어디서 왜 나왔는지, 개념이 서로 어떻게 이어지는지는 설명하지 않습니다. 이해 없이 외우는 공부는 오래가지 않습니다.
이 프로젝트는 교재 챕터 PDF 하나를 받아, 그 챕터를 처음부터 새로 쓴 이해 노트로 만듭니다. 노트는 개념을 가장 논리적인 순서로 다시 배열하고, 공식은 그 개념을 설명하는 흐름 안에서 생략 없이 유도합니다.
기존 교재는 두 가지 용도로만 씁니다.
- 범위: 이 챕터에서 무엇을 빠짐없이 다뤄야 하는지
- 시험 표기: 시험에 나오는 공식의 형태·기호·용어. 노트로 이해했는데 시험지에서 못 알아보는 일이 없게, 노트의 해당 자리에 연결해 둡니다
노트를 쓰는 일은 Claude Code 스킬 /chapter-note가 맡습니다. 교재 PDF를 다루는 일(챕터 분할, 그림 추출, 기출 문제지, 필기용 PDF)은 tools/의 도구들이 맡습니다.
도구들은 다산에듀 「속전속결」 전기기사 필기 이론서의 편집 양식(표지, 꼬리말, 캡션, 문제풀이 단원)에 맞춰져 있습니다. 이 프로젝트는 출판사와 관계없는 개인 학습용 비공식 프로젝트이며, 교재 내용은 저장소에 들어 있지 않습니다.
주요 기능
- 4단계 노트 생성: 범위 추출 → 설계 → 집필 → 마무리. 설계 단계에서 큰 질문과 이야기 뼈대를 학습자에게 확인받고, 집필은 멈추지 않고 이어 갑니다.
- 검증 에이전트: 범위 추출, 파트 검증, 챕터 전체 검토를 작업 맥락이 없는 새 에이전트에게 맡깁니다. 쓴 쪽의 착각이 그대로 넘어가지 않게 하기 위해서입니다. 에이전트는 지적만 하고, 고칠지는 노트를 쓴 쪽이 판단합니다.
- 교재 그림 자동 삽입: 교재 본문의 그림(회로도, 파형, 벡터도, 그림이 든 표)을 PDF의 벡터 도형과 글꼴 정보로 찾아 잘라 냅니다. 노트는 이 그림을 빠짐없이 넣고, 마무리 단계에서 누락·중복을 자동으로 점검합니다.
- 기출 문제지 생성: 챕터 끝의 기출 문제풀이에서 정답과 해설을 가린 문제지, 그리고 정답표가 붙은 해설 PDF를 만듭니다.
- 필기용 PDF: 노트와 기출 문제지를 오른쪽에 필기 여백이 넓은 챕터 PDF 한 권으로 묶습니다. 태블릿 필기 앱에서 쓰기 위한 것이며, 목차 책갈피와 노트 안 링크가 PDF 안에서 동작합니다.
- 이어서 하기: 단계마다 결과를 작업 파일에 남겨, 대화가 끊겨도 중단된 단계부터 이어 갑니다. 스킬만 부르면 아직 끝내지 않은 다음 챕터를 골라 제안합니다.
- 챕터 사이 연결: 기호 약속과 "나중에 연결할 곳"을 과목 목차에 기록해, 뒤 챕터를 쓸 때 앞 챕터와 같은 기호를 쓰고 밀린 링크를 채웁니다.
Quoting 41% of the README. Read the rest on GitHub ↗
Read from the repository's git tree on 2026-08-17.