지피터스 발표 영상 하나 보고 따라 만든 나만의 강의록
2026.10.22
강의록 앱 - 개발 로그
지피터스 멀티 스터디 수강생 발표에서 스쳐서 본 "강의록" 화면에 아이디어를 얻어 (너무 좋은 꿀팁..),
수업·사례글·오픈채팅을 한곳에 모아 다시 공부하는 앱을 만든 기록입니다. 요청은 사용자가 입력한 원문이고, 길면 줄였습니다. 수강생 실명과 외부 채팅방 주소는 뺐습니다.
참고: 같은 기간
강의록폴더에 찍힌 약 340건의 요청 중 330건은 직접 입력한 것이 아니라, 오픈채팅 요약·태그 붙이기를 자동으로 돌린 배치 호출입니다. 직접 입력한 요청만 실었습니다.
1. 발표에서 아이디어를 받아 앱 뼈대 만들기
지피터스 23/24기 수업 내용 + 사례글을 주차별로 묶고, 오픈채팅방 내용도 같은 형태로 정리해서 나의 전체 지식 베이스로 키우고 싶어. 옵시디언은 이미지가 안 나와서 다시 학습하기 불편했어.Claude Code 작업:
발표 화면을 보고 구조를 파악: 기수 → 주차 → 스터디로 묶고, 강의·사례글·오픈채팅을 한 화면에서 잇는 형태
강의록/폴더에 로컬 웹앱을 새로 만듦 (server.py,web/, 포트 5240). 홈 허브에 🎓 카드 등록주차 규칙 정리: 기수 1주차 월요일 기준 달력 주. 영상 제목 날짜가 실제 수업일과 다를 수 있어 주차는 직접 지정
갱신 절차를
README.md에 남김
2. 사례글·강의·채팅을 자동으로 모으고 묶기
Claude Code 작업:
사례글: gpters.org 공개 GraphQL로 스터디 태그별 전문·이미지·게시 시각 수집 (로그인 불필요). 24기 925편, 23기 1,907편
강의 노트: 이미 정리해 둔 23·24기 노트와 전사를 가져오고, 목차 시각마다 발표 화면을 영상 전체를 받지 않고 한 장씩 캡처 (2시간 강의 25장에 약 1.5분)
오픈채팅: 수집해 둔 채팅 DB를 방×주차로 묶어 요약, 사진·파일은 원본을 그대로 연결
막힌 지점: 강의 다시보기 목록은 비공개 영상이라 학습 시스템 로그인이 필요함. 24기 2·3주차는 이 때문에 비어 있음
3. 눈이 편하도록 화면 바꾸기
아 이거 보는데 눈이 좀 아픈데? 눈 편하게 글씨체랑 색감 배경 색감 이런것들도 좀 수정해줄래? 밝은 창이여도 좋아 (줄글 형태의 덕질킹에서 사용하는 배경같은 느낌의 노란색 둔 느낌 -> 눈 보호)Claude Code 작업:
어두운 테마를 종이색 계열 밝은 테마로 교체 (원래 파일은 백업)
맥북에서도 열리는 주소 제공
4. 지피터스 밖 톡방까지 넓히고, 태그와 광고 거르기
오픈채팅방도 양질의 자료들이 많아서 외부자료에서도 햄로그 톡방에서 나온건 거기로 묶어서 정리하고 톡방 별로 묶고, 해당 내용들도 태그 걸어서 #영상 #ai사용 이런식으로 맞춰서 작업해줄수있어?광고 이런거는 빼고 유익한 정보성 + 트렌드만 정리하면 돼!자료 링크랑 전달주는 md 이런거 중요해서 오픈채팅방에서 그런거 나오면 함께 정리하게끔 해줘Claude Code 작업:
지피터스 밖 톡방 32개를 월~일 주 단위로 정리. 한 주가 길면 나눠 요약한 뒤 합침
고정 태그 18개(
#영상#AI사용#에이전트등)를 강의·사례글·톡방 주제·공유 자료에 붙임광고 걸러내기: 요약 단계에서 판매·모집·홍보를 빼고, 태그 단계에서 한 번 더 걸러 숨김
채팅에서 공유된 링크·파일을 주제와 함께 자료 목록으로 모으고, 같은 주소는 처음 나온 방으로 묶음
막힌 지점: AI를 수백 번 자동 호출할 때 내 저장 훅이 출력을 바꿔 결과가 깨짐 → 훅을 끄는 옵션으로 해결
5. 자막 없는 2시간 특강을 세밀하게 정리하기
영상 분석해서 내 지식베이스에 (유튜브 세밀하게 요약하는 형태로) 정리해주고 해당 링크도 맥북에 열리게 줘 (여기는 엄청 세밀하게 정리해서 줘!)아니, 옵시디언이 아니라, 내가 만들던 지식베이스 (유튜브 보면서 캡쳐해서 정리하는 부분) 거기다가 정리한거 아니야?Claude Code 작업:
자막이 없는 1시간 58분 특강이라 기존 정리 도구가 빈 결과를 냄 → 음성 받아쓰기(6분 31초) + 1분 간격 프레임 시트 + 핵심 장면 화면 글자 인식(OCR)으로 대체. 총 약 20분
받아쓰기가 틀린 고유명사는 화면과 대조해 정정하고, 확인 못 한 것은 "미확인"으로 표기
노트의 시각 157개를 유튜브 시각 링크로 한 번에 변환
막힌 지점: 처음에 옵시디언에 저장했다가 "내가 만들던 지식베이스(캡처 포함 앱)가 맞다"고 바로잡힘 → 앱 데이터 형식으로 다시 생성
6. 정리가 핵심만 잘 됐는지 검수하고, 스킬로 굳히기
내용 봣는데ㅔ 정말 핵심으로 잘 정리한 건지 다시 한번 검토해줘 (캡쳐 사진 등등도적절하게 들어갔는지 이런거 검토해줘) => 이거 정리하는 스킬이 있어 혹시? 없으면 opus에게 한번 구현 잡아달라고 해야할 것 같아 (그리고 스킬 하나 만들고 해당 스킬 구축)Claude Code 작업:
전사·화면 글자·캡처를 같이 넣어 노트를 만들고 반영 전에 검수하는
lecture-notes-app스킬 신설자동 검수 항목: 중복·빈 화면 캡처, 빠진 구간, 고유명사 오류, 전사가 거의 없는데 통과하는 경우, 퀴즈·따라하기 누락
별도 AI가 "전사·화면 대비 핵심만 잘 정리됐는지" 판정하는 단계를 분리
7. 만든 스킬을 다른 AI(Codex)에게 검토시키기
오커스 스킬 만들고 codex astra에게 한번 검토 맡겨서 스킬 업댓 등 할 수 있게 해줘 (탄탄하게)Claude Code + Codex 작업:
스킬에 Codex가 검토하고 고치는 명령(
review→apply)을 넣어 반복 가능하게 함1차 검토에서 23건(치명적 7건)이 나와 22건 수정, 테스트 48개 통과
2차 검토에서 치명적 5건이 또 나옴 → 1회차 결과만 믿으면 안 된다는 것을 확인. 직접 테스트와 실제 강의 데이터로 재확인하는 순서를 규칙으로 남김
막힌 지점: 검토 AI가 실행 중이던 자기 스크립트를 직접 고쳐서 중간에 꼬임 → 복사본으로 다시 실행하고 지시서에 "도구 파일 수정 금지" 명시
완성 규모
항목 | 규모 |
|---|---|
강의 노트 | 61편 (24기 21, 23기 32, 외부 8) |
사례글 | 2,832편 (24기 925, 23기 1,907) |
오픈채팅 주차별 정리 | 118건 (24기 39, 23기 79) |
지피터스 밖 톡방 | 32개 |
고정 태그 | 18개 |
강의 발표 화면 캡처 | 1,539장 |
앱 코드 | 서버·스크립트 약 1,800줄 |
커밋 히스토리
이 폴더는 git 저장소가 아니라서 커밋 기록이 없습니다.
기술 스택
앱: Python 서버(포트 5240) + 순수 HTML·CSS·JavaScript 화면, 홈 허브 카드로 실행, 폰·맥북은 Tailscale 주소로 접속
수집: gpters.org 공개 GraphQL, yt-dlp, ffmpeg, 오픈채팅 sqlite
정리: mlx-whisper(받아쓰기), ocrmac(화면 글자),
claude -p(강의 노트: opus, 톡방 요약·태그: sonnet)검수: 별도 AI 판정 + 자동 규칙, Codex Astra 스킬 검토
주요 기능
기수 → 주차 → 스터디 묶기: 강의·사례글·오픈채팅을 같은 스터디 태그로 연결
강의 화면: 영상+전사(재생 위치 따라 강조), 짧게/자세히/원문, 핵심마다 그 시각의 발표 화면 캡처, 따라 하기·퀴즈
톡방·태그 화면: 32개 톡방과 고정 태그 18개로 강의·사례글·공유 자료를 한 화면에서 모아 보기
수강 진도: 수강함·읽음·확인함이 맥과 폰에서 같이 보임
정리 스킬(
lecture-notes-app): 유튜브 강의 → 캡처·목차·핵심·퀴즈 → 검수 → 앱 반영까지의 절차를 고정
시도하고자 했던 것과 그 이유를 알려주세요.
결과와 배운 점
처음엔, 영상 내용을 잘 정리한 듯 해보였지만, 막상 실제로 들어가서 내용을 읽어보니 핵심은 빠진 겉내용만 살짝 정리한 느낌이 강했습니다. 이에, astra 에게 검수 시키기 -> 기획 업댓 -> 다시 한번 클로드 검수 이작업을 통해 조금 더 핵심 위주로 정리할 수 있게 시도하였습니다.

![[Paseo + Claude Code] 만들어 둔 리센느빵 테트리스 세션을 그대로 이어받아, 메뉴·2인 대전·배경음악·효과음까지 한 번에 붙였다 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2Fdfa7f86bd93d21caba20bf53.jpg&w=3840&q=75)


강의·사례글·톡방을 한곳에 묶고, 캡처·OCR·자막으로 지식베이스를 채운 흐름이 탄탄하네요. 1차 결과를 다른 AI로 다시 검수하며 다듬은 점에서 검수의 중요성이 잘 느껴졌어요.