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

README.mdmivomad33/electrical-engineer-understanding-notes-generator

시험 대비 요약 교재를, 개념이 끊기지 않고 이어지는 이해 노트로 다시 쓰는 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.