16 가르치기 — 발표와 강좌

뒷이야기 · 16 / 17단계 · 2026-08-31 ~ 10-08 · 갈래 교육
이전 단계: 15 회사 자료 AI — making-ai · 다음 단계: 17 일하는 방식 — 규칙과 함정 모음

핵심 요약

한 줄 요약 — 만든 것을 남이 따라 하게 하려면 영상 말고도 목소리 · 가릴 것 · 저작권 · 올릴 곳을 정해야 했다.

16단계 · 가르치기 — 발표와 강좌

목적

먼저 회사 행사(AI 갈라)에서 15분 안에 보여 줘야 했고, 그다음엔 코드를 모르는 교육생이 같은 것을 스스로 만들어 보게 해야 했다. 산초 강좌를 듣다 막힌 교육생이 나오자 그 앞에 기초 강좌를 하나 더 만들었다. 가르치는 일에는 영상 말고도 정해야 할 것이 따라왔다. 목소리를 누구 것으로 할지, 무엇을 가릴지, 저작권은 누구에게 둘지, 어디에 올릴지다.

만든 순서

1 · AI 갈라 발표 자료 (8/31 ~ 9/2)

AI Innovation Gala 2026 순서 9 「기업의 AI 활용 경험 및 사례 공유」(15분)에서 쓸 발표 자료를 만들었다.

• 어떻게: 슬라이드를 손으로 그리지 않고 코드(gen-deck.js, pptxgenjs 라이브러리)로 짰다. 캡처 자산은 전부 실제 화면이다. 헤드리스 크롬(화면 없이 돌리는 브라우저)을 원격 조종하는 스크립트(cdp-*.js 10개)로 파이스 화면과 그래프를 찍었다. 자산 폴더에는 그림 파일 59개(프레임 포함)가 모였다. 구조도 슬라이드는 SVG 한 장(arch.html)을 렌더했다.
• 판 번호: 8/31 13:26 첫 판 17장 → 9/2 15:00 21장 → 15:08 22장 → 15:55 23장 → 16:13 24장. 생성기 첫 줄 주석은 「15분 · 15장」으로 남았고, 실제로 만든 판은 17~24장이다.
• 가리기: 메일 자동 회신 캡처는 실명 4곳, 의미 검색 캡처는 실명 1곳을 블러했다. 조직 사용 현황 슬라이드는 관리자 콘솔 실측값만 쓰고 개인별 순위는 뺐다.
• 실제 발표본은 사람이 따로 다듬은 17장짜리 덱이었다(영상 슬라이드 6장, 발표자 노트 17장 모두 글 있음). 9/9에 드라이브에서 받아 다음 일의 바탕으로 썼다.

2 · 파이스 목소리로 자동 발표판 (9/9)

최종 17장 덱에 내레이션을 넣어, F5 한 번에 6분 52초 동안 스스로 넘어가는 발표판을 만들었다.

• 결과: 17장의 자동 넘김 시간 합이 412.2초(6분 52초)다. 영상 슬라이드 6장(4·7·8·10·11·12장)은 내레이션과 같이 무음으로 자동 재생된다. 인터넷 없이 되도록 음성·영상을 파일 안에 넣었다.
• 목소리: 네 엔진(ElevenLabs · MiniMax · SeedSpeech · SeedAudio)을 비교해 ElevenLabs로 정했다. 말 빠르기는 1.25배다. 1.5배는 중간중간 속도가 이상한 구간이 느껴져 상한을 1.2~1.25배로 잡았다.
• 길이 조절: 최종 대본 머리의 표로 1.20배 7분 05초 · 1.25배 6분 52초 · 1.30배 6분 33초. 더 느긋하게 하려면 배속이 아니라 대본을 줄여야 한다.
• 같은 날 14:30~14:43에 배속을 바꾼 판(1.35배 · 1.42배)과 쇼 파일(.ppsx, 자동 넘김 합 400.8초)이 더 남아 있다. 발표장에서 어느 판을 틀었는지는 확인 못 함.
• 정정: 「이 목소리가 파이스의 실제 목소리」라고 말하면 거짓이라, 13장 대본에 「사람이 녹음한 것이 아니라 AI가 합성한 것」이라고 적었다.
• 시각은 숫자 그대로 두면 「이시·오시」로 읽혀서 「오전 두 시 · 오전 다섯 시 삼십 분」처럼 말로 풀어 썼다.
• 공정: 덱에서 글·노트·영상 길이 추출(PowerPoint COM, 프로그램으로 파워포인트를 조종하는 통로) → 음성 생성 → 배속(ffmpeg) → 조립(COM). 배속은 공짜고, 글자가 바뀔 때만 음성을 다시 만든다.

3 · 산초 강좌 10편 (10/6 ~ 10/7)

코드를 모르는 사람이 Claude 데스크톱 앱(Code 탭)으로 「로그인 되는 개인 AI 비서 + 업무 대시보드」를 만드는 강좌다. Sonnet 5.5로 만들고 Opus 5.5로 검증한다.

• 역할 둘: 제작 세션(녹화 · 요청문 입력 · 승인 클릭 · 목소리 · 편집)과 시연 세션(시연 앱 폴더에서 요청문을 받아 실제로 만들기)을 나눴다. 시연 세션에서 다음 편 기능을 미리 만들지 않는다. 「만드는 장면」이 영상에서 사라지기 때문이다.
• 공정: 요청문 준비 → 녹화(ffmpeg gdigrab) → 장면 시각 기록 → 검증 → 시연 앱 커밋·태그 → 편집 → 노션 → 드라이브. 대본의 내레이션은 초안이고, 녹화가 끝난 뒤 실제 화면에 맞춰 확정한 다음 음성으로 만든다. 1편 첫 판은 초안을 그대로 읽혀서 실제와 달랐다.
• 편집 규칙: 요청·결과 화면은 제 속도, 기다림은 목소리 길이에 맞춰 빨리 감기(×N 표시), 장면 사이 1초 남짓, 5초 인트로·아웃트로 카드.
• 목소리: PLAN 문서에는 ElevenLabs로 적혀 있었지만 파이스는 9/30부터 Gemini TTS Zephyr(무료)를 1순위로 쓰고 있었다. 파이스 코드가 진실이라 Zephyr 1.15배로 바꿨다. 1편 첫 판은 ElevenLabs로 만들어 약 3천 자를 쓰고 버렸다.
• 결과: 시연 앱 커밋 55개(Sonnet 5.5 공동 저자 37 · Opus 5.5 15), 태그(커밋에 붙인 이름표) ep1~ep10 · v1.0 · v1.0.1. 녹화 원본 10편 합계 52,457초(14시간 34분) → 편집본 10편 합계 52분 30초(편당 4:02~7:51).
• 편이 지날수록 검증이 코드를 고쳤다. 5편 점검에서 숨은 지침 파일로 권한을 넘던 길을, 6편 점검에서 같은 아이디로 새 계정을 만들면 옛 연결이 새 사람 채널을 받던 길을 찾아 막았다.

4 · Opus 5.5 보호 장치가 검증을 멈췄을 때 (10/7)

검증 세션이 세 번 멈췄다. 6편 장면 5에서 한 번, 8편에서 두 번이다.

• 무엇이: Opus 5.5의 보호 장치(위험한 사이버 행위로 보이면 세션을 일시 중지하는 분류기)가 시연 앱의 다른 사용자 쪽을 찔러 보던 검증을 멈췄다. 8편은 「설계 규칙 점검」 꼴로 바꿔도 두 번 멈췄다. 같은 세션에서 서버를 일부러 망가뜨린 뒤라 문맥 전체가 공격처럼 보인 것으로 짐작한다(확인 못 함).
• 대처: 요청을 「설계한 규칙대로 동작하는지 확인」 「README 정리 + selftest(앱이 스스로 돌리는 시험) 확인」 꼴로 바꿨다. 6편은 이 꼴로 통과했고, 8편은 세 번째 시도(README 정리 + selftest 확인만)에서 통과했다. 9편은 처음부터 이 꼴로 요청해서 멈춤이 없었다. 공격하는 말투, API 직접 호출, 탈취라는 낱말은 쓰지 않는다.
• 되돌려도 남는 것: 카드의 「프롬프트 수정 후 재시도」는 요청 직전으로 되돌리고 새 세션 파일을 만든다(감시기를 새 파일로 옮겨야 한다). 그런데 멈춘 시도가 고친 파일은 남아서, 다음 시도가 그것을 「다른 세션의 변경」으로 같이 커밋했다.
• 6편의 멈춤 장면은 영상과 노션에 교훈으로 넣었다. 검증이 왜 필요한지 보여 주는 자료가 되기 때문이다.

5 · AI 기초 다지기 10편 (10/7 밤 ~ 10/8)

산초 강좌를 듣다 막힌 교육생을 위해 그 앞에서 듣는 기초 10편을 만들었다. 코드를 모르는 사무직 기준이고 한 편 5~7분이다.

• 왜: 산초 강좌의 대본·자막에서 낱말이 나온 횟수를 글자 단위로 세어 보니 서버 108번 · 파일/폴더 235번 · 커밋 49번 · 태그 54번 · 저장소 39번 · selftest 31번 · 토큰 38번 · 키 62번 · 권한 41번 · 세션 33번 · 모드 37번 · 스킬 53번 · 커넥터 21번 · MCP 12번이었다(「키」처럼 짧은 말은 다른 낱말 속 글자도 센다). 계획 문서는 이 말들이 설명 없이 쓰였다고 판단했다.
• 짜임: 컴퓨터 기초(로컬·서버·터미널·Git) → AI 기초(LLM·로컬 LLM) → Claude 지도(채팅·Cowork·Claude Code·MCP·스킬) → 바이브 코딩과 맡기기, 4부 10편. 편마다 장면 10개, 내레이션 1,662~2,009자(공백 뺀 값).
• 사실표: Claude 제품에 관한 말은 공식 문서로 확인해 적은 사실표(FACTS.md)에 있는 것만 쓴다. 조사 에이전트가 낸 초안에서 틀린 것을 Opus가 바로잡았다. 예를 들면 Cowork는 여러 사람이 함께 쓰는 기능이 아니라 혼자 맡기는 일꾼이다.
• 결과: 편집본 10편 합계 3,303.4초(55분 3초), 편당 4:58~6:13.
• 목소리 경계: 한 장면 묶음에 문장 여럿을 합성하면 문장 경계를 찾아야 한다. 글자 수 비율로 나눴더니 한 문장씩 밀려 장면을 건너 틀렸다(6편). 8편은 그 계산이 오류로 죽어 장면 9를 아예 안 만들었다(따로 다시 만들어 채웠다). 위스퍼(받아쓰기 모델)로 낱말 시각을 뽑고 마침표 후보와 글자 비율을 맞추는 방식(basic-align.mjs)으로 바꿨다.

6 · 쉬운 말 상자 67곳 · 어려운 말 사전 86 (10/8)

같은 일을 쉬운 한국어로 한 번 더 했다. 산초 강좌의 요청문과 어려운 낱말이 그대로 남아 있었기 때문이다.

• 쉬운 말 상자 67곳: 산초 노션 10쪽의 요청문 밑에 「🗣️ 쉬운 말로」 콜아웃을 붙였다. 편별로 10 · 9 · 7 · 6 · 5 · 6 · 5 · 7 · 6 · 6곳이다.
• 어려운 말 사전 86: 낱말마다 쉬운 설명 · 예문 · 산초 몇 편에서 나왔나 · 기초 몇 편에서 배우나를 달았다. 86개 중 68개는 기초편 어딘가에서 배우고 18개는 기초편에 없다.
• 규칙: 어려운 말은 처음 나올 때 풀고, 한 문장에 새 낱말은 하나만 쓴다. 비유(게임 세이브 · 가게 창구 · 택배)를 쓰고, 예시는 가상 회사(가나다전자)로 한다. 목소리로 읽힐 대본에서는 영어를 소리 나는 대로 적는다(AI → 에이 아이, Git → 깃). 이 규칙은 기초 강좌 규격(SPEC.md)에 적힌 것이다.
• 산초 영상 자막 3곳을 고쳤다(Node.js → 노드, 「이피 텐」 → ep10, 4편 schedule.json). 드라이브에는 같은 파일에 덮어써서 링크가 그대로다.

7 · 저작권·라이선스 (10/7 저녁 ~ 10/8)

강좌를 마친 뒤 그날 만든 것 전부의 저작권을 본인 것으로 하고, 남이 지우지 못하게 했다. 10편에서 만든 LICENSE는 MIT(저작권자 cwkim83)라 판매까지 허락하고 있었다.

• 정한 것: 강좌 자료(영상·노션·대본·자막)는 CC BY-NC-ND 4.0. 코드는 MIT 또는 Apache-2.0에 상업적 배포 금지(Commons Clause)와 표시 유지를 붙였고, 19:29에 「재배포·공개 전에 저작권자에게 알리기」 조건을 더했다.
• 못 지우게: 라이선스 파일 넷(LICENSE · LICENSE-MIT · LICENSE-APACHE · NOTICE)을 시연 앱의 불변 목록에 넣어 비서가 고치지 못하게 했다. 파일·README·화면 셋의 © 표시는 selftest가 검사하므로, 자기 수정이 표시를 지우면 관문에서 되돌려진다.
• 옛 태그 옮기기: ep1~ep9를 「그 편의 코드 그대로 + 라이선스 파일 넷」을 얹은 새 커밋으로 다시 만들었다(10/7 20:28). 최신 커밋으로 옮기면 노션의 「epN 태그로 시작」이 깨지기 때문이다. 확인한 값: ep1·ep5·ep9·ep10 모두 라이선스 파일 넷이 들어 있다.
• 영상: 산초 영상 10편 모두 오른쪽 아래에 © 표시를 박고 mp4 저작권 정보와 자막 끝 줄에도 넣었다. 노션 10쪽은 위 안내줄 · 맨 아래 콜아웃 · 페이지 잠금을 붙였다.
• 공개 전 점검: 저장소를 공개하기 전에 현재 파일과 지난 커밋 기록 49개를 훑어 키·토큰·실제 이메일·개인 경로가 없는지 보고, 같은 검사를 selftest에 넣었다(10/7 17:56). 작성자 주소는 그 전날 첫 공개 때 이미 바꿔 두었다 — 회사 메일이 이력에 있어 GitHub 공용 주소로 고쳐 썼다(10/6). 지금 작성자 이메일은 공용 주소 54개 · 로컬 1개다.
• 10/8 표기 변경: 새로 쓰는 곳(유튜브 설명 · 사이트 · 새 기록)의 저작권 줄은 © 2026 crazy4eu (cwkim83) · CC BY-NC-ND 4.0 · 무단 상업 이용·수정 배포 금지로 바꿨다. 실명은 쓰지 않는다. 이미 만든 영상 21편 화면 속 옛 표기는 다시 만들지 않기로 했고, 시연 앱 저장소의 라이선스 파일·화면 표기도 아직 옛 표기 그대로다.

8 · 노션 셋으로 나누기 → 자체 사이트 (10/8)

10/8에 노션 「AI 교육」을 셋으로 나눴다(🌱 AI 기초 다지기 · 🤖 나의 AI 비서 Sancho 만들기 · 📘 파이스 제작기). 같은 날 노션 대신 자체 사이트로 옮기기로 했다.

• 왜: 노션 워크스페이스의 무료 블록 한도를 넘었다. 한도 때문에 MCP(AI가 노션을 쓰는 연결 통로)로 새 내용을 넣는 것은 10/11까지만 된다고 기록돼 있다. 사내 시스템 세부와 운영 숫자가 들어가므로 전부 로그인 뒤에 두기로 했다.
• 방식: 글은 마크다운 하나가 원본이다. build.mjs가 HTML로 짓고(dist/), Cloudflare Workers의 정적 자산으로 올린다. 모든 주소를 워커가 먼저 받아 회사 구글 계정으로 로그인한 사람에게만 12시간짜리 서명 쿠키(위조할 수 없게 서명한 출입증)를 주고, 검색엔진에는 noindex(목록에 싣지 말라는 표시)를 보낸다. 영상은 유튜브 개인 채널에 일부 공개로 올려 쪽 안에 넣는다.
• 옮긴 것: 노션 28쪽(기초 12 · 산초 11 · 안내 3 · 파이스 제작기 1 · 첫 쪽 1) 중 영상이 있는 쪽이 23곳이다.
• 유튜브 하루 10편 한도: youtube.json에는 10개(기록실 1 + 산초 9)만 올라 있고 산초 10편째와 기초 10편은 한도 때문에 대기다(24시간 뒤 또는 휴대폰 인증 뒤).

💡 설명

• 헤드리스 브라우저: 화면 없이 뒤에서 도는 브라우저. 스크립트로 조종해 화면을 자동으로 찍는다.
• CDP: 크롬을 프로그램으로 조종하는 통로(Chrome DevTools Protocol). 캡처 스크립트가 쓴다.
• TTS: 글을 사람 목소리로 읽어 주는 합성 음성(Text-To-Speech). 이 단계에서는 Gemini Zephyr · ElevenLabs를 썼다.
• 배속(atempo): 음높이는 두고 말 빠르기만 바꾸는 ffmpeg 필터. 1.4배 이상에서 티가 난다.
• 위스퍼(whisper): 소리를 글자로 받아 적는 모델. 낱말마다 시각을 뽑는 데 썼다.
• 자막(.srt): 영상에 맞춰 시각과 글을 적은 파일.
• 보호 장치(분류기): 위험한 행위로 보이는 요청이면 AI 세션을 일시 중지하는 안전장치.
• 불변 목록: AI가 고칠 수 없게 막아 둔 파일 목록. 라이선스·감시기 같은 것이 들어 있다.
• CC BY-NC-ND: 출처를 밝히고(BY) 비영리로(NC) 바꾸지 않고(ND) 그대로 공유할 수 있는 저작권 이용 조건.
• Commons Clause: 코드를 쓰는 건 허락하되 파는 건 막는 라이선스 추가 조건.
• 콜아웃: 글 사이에 아이콘을 붙여 눈에 띄게 한 상자.
• 워커(Workers): 클라우드 쪽에서 요청을 받아 처리하는 작은 프로그램. 로그인 확인을 한다.

함정과 배운 것

• (1) 화면 없는 캡처는 암호 입력창에서 멈춘다: 파이스는 토큰이 없으면 prompt()로 접속 암호를 묻는다. 이 창이 메인 스레드를 잠가 원격 조종(evaluate·screenshot)이 전부 무한 대기가 됐다. 대화창이 열리는 순간 자동으로 응답하게 해야 한다. 다크 화면은 localStorage 값으로 강제하고, 그래프 화면은 주소로 바로 들어갔다.
• (1) 발표 숫자도 쓰기 전에 코드에서 다시 센다: 슬라이드·대본의 「8월 한 달 커밋 341건 · 전부 AI가 저자」 중 341은 덱을 처음 만든 8/31 13:26 직전까지 센 값과 맞는다(8월 전체는 그날 17:02 커밋까지 342개). 「전부 AI가 저자」는 맞지 않는다. 그 341개 중 작성자 이름이 PAIS인 것은 60개, Claude 공동 저자 표시가 붙은 것은 206개, 둘 다 없는 것이 76개다. 발표 문구는 저자 표시가 아니라 「AI와 함께 쓴 커밋」 정도로 적어야 했다.
• (1) 생성기 첫 줄 주석은 어긋난다: 「15장」이라 적혀 있는데 만든 판은 17~24장이다. 05단계에서 본 문서 숫자와 같은 병이다.
• (2) 파워포인트 자동 시작은 기본값이 아니다: PlayOnEntry는 요즘 버전에서 「클릭 시 시작」으로 들어간다. 효과를 찾아 TriggerType을 직접 바꿔야 자동으로 시작한다.
• (2) 시간 지연 값은 정수가 아니라 Single이다: PowerShell의 실수를 그대로 주면 「Specified cast is not valid」로 실패하고, 도입 여유가 앞이 아니라 뒤에 붙는다.
• (2) 열어 둔 파일에 조립하면 깨진 파일이 남는다: 결과 pptx를 열어 둔 채 조립하면 복사가 막히고, COM이 중간에 끊겨 1장만 바뀐 파일이 남았다. 새 파일 이름으로 만든다. 이름에 _최종이 없는 동명 파일은 미완성본이다.
• (2) 셸 입력 파일을 PowerShell로 쓰면 줄 끝이 달라진다: CRLF가 붙어 URL 끝에 CR이 묻고 다운로드가 전부 실패했다. 줄바꿈을 LF로 써야 한다.
• (2) 한글이 든 .ps1은 BOM이 필요하다: BOM 없는 UTF-8은 PowerShell 5.1이 ANSI로 읽어 한글 문자열이 깨지고 파싱 오류가 난다.
• (2) 무료 한도는 하루 단위다: Gemini TTS Zephyr 무료 한도가 하루 20여 회라 17장을 두 번 뽑으니 한도에 걸려 다른 목소리로 바뀌어 섞였다. 한 목소리로 통일해야 한다. ElevenLabs 중개 크레딧도 9/9 오후에 바닥났다.
• (3) 문서의 사실보다 코드를 믿는다: 계획 문서의 목소리 이름이 실제와 달라 약 3천 자를 버렸다.
• (3) 녹화 전에 화면을 정리한다: 브라우저 패널이 닫힌 채 녹화해 앞 장면 화면이 안 찍혔고(2편), 카톡 알림이 실명과 메시지를 띄웠다(2편에서 42번 — 알림이 뜬 구간을 찾아 화면에서 가렸다). 시연 세션 안의 옛 서버를 못 꺼서 직접 끈 일도 있다.
• (3) 자동 승인 감시기의 고아 프로세스: 감시기를 중지해도 안쪽 자식 프로그램이 남아 옛 세션 파일을 보고 계속 키를 눌렀다. 관련 프로세스를 PowerShell로 전부 끈다.
• (3) 계획 카드의 「수락」은 계획 전체를 한 번에 만든다: 거부로 닫고 편집을 자동 수락으로 한다.
• (5) 정렬과 받아쓰기를 동시에 돌리면 섞인다: 임시 파일 이름이 같아 서로 덮어써서 다른 편의 글이 섞였다. 이제 임시 이름에 프로세스 번호를 붙이지만, 그래도 한 번에 하나씩 돌린다.
• (5) 녹화 메모 시각은 어긋난다: 1~수십 초 틀리므로 접촉 시트(장면을 격자로 한 장에 모은 그림)로 보고 구간을 고친다.
• (5·8) 노션은 파일 이름을 링크로 바꾼다: .md · .ai · 127.0.0.1:포트 · localhost가 자동 링크가 되고 역슬래시는 사라진다. 코드 표시로 감싸고 \를 두 번 쓴다. 공유 단추 클릭은 좌표 클릭이 안 먹어 이벤트를 직접 보내야 했고, 게시 직후 「템플릿으로 복제」를 꺼야 한다. 편 사이 링크는 일반 링크 대신 멘션으로 건다.
• (7) 저작권 표시는 사람이 아니라 검사가 지킨다: 불변 목록에 넣고 selftest가 표시를 보게 했다. 줄바꿈이 CRLF로 꺼내지는 PC에서는 줄바꿈을 맞춘 뒤 비교한다. 쓴 사람 표기도 같은 날 바뀌었으므로 영상 안의 옛 표기는 남아 있다.
• (8) 홑 물결 ~은 취소선이 될 수 있다: 마크다운(GFM, 깃허브식 마크다운)은 ~와 ~ 사이를 취소선으로 바꾼다. 지금은 build.mjs가 코드 밖의 홑 물결을 글자로 바꿔 두므로 그대로 써도 된다.
• (8) 유튜브는 하루 10편이다: 업로드가 끝나기 전에 다음 편으로 넘어가면 취소되므로 링크와 업로드 끝을 확인한 뒤 저장한다.

출처

• 커밋(시연 앱 저장소 my-agent): 240a4e1(첫 커밋 10/6 15:35) · 668bb68 · fe5aa05 · 8dd7261 · 4f201f5 · ba28f10 · 594cc73 · 352c617 · a225562(ep1 태그)
• 커밋(파이스 저장소 pais_project): 995ba93(TTS 무료 전환 — Gemini Zephyr 1순위, 9/30 23:37)
• 파일: AI갈라발표/gen-deck.js · 파이스내레이션_대본.md · AI교육/개인에이전트강좌/PLAN.md · 녹화방법.md · 대본/00_전체개요.md · AI기초강좌/PLAN.md · tools/SPEC.md · tools/FACTS.md · notion/glossary.json · notion/sancho-easy.json · 제작기록실/site/ (build.mjs · worker.js · content/manifest.json) · youtube.json
• 기억 노트: ai-gala-presentation · agent-course-production · basic-course-production · copyright-name-crazy4eu · log-site
• 숫자를 센 명령과 결과: 같은 폴더 checks.md

← 15 회사 자료 AI — making-ai · 17 일하는 방식 — 규칙과 함정 모음 →