1. 공통 규칙

1-1. 저장소 · 브랜치 · 올리지 않는 것

• GitHub: moyuchan84/moyutube. 작업은 브랜치에서 하고 PR 로 main 에 합친다. (main 에 바로 커밋하지 않는다.)
• GitHub Pages 는 main 의 루트를 내보낸다. 루트 index.html 은 qna/ 로 넘겨 주는 페이지다. qna 의 index.html·plan/·guide/·production/·auto/ 가 사이트다.
• 올리지 않는 것: 키 파일 .env, 렌더 결과 out/, node_modules/, .venv/, 자동 생성 그림 qna/video/public/art/, shortube 의 data/·output/videos/.
• Windows 환경: 셸은 PowerShell/Git Bash. shortube 파이썬은 .venv/Scripts/python.exe, 한글 깨짐 방지로 PYTHONIOENCODING=utf-8.

1-2. API 키 · 과금 규칙

Gemini 키는 D:\youtube\.env 한 곳에만 둔다. GEMINI_API_KEY(기본), GEMINI_API_KEY2(첫 키가 한도에 걸리면 번갈아 쓰는 예비). 프로젝트 폴더마다 .env 를 새로 만들거나 키를 복사하지 않는다. 코드는 환경변수 → 저장소 루트 .env → 프로젝트 .env 순서로 찾는다.

1-3. Remotion 영상 · 코드 합성 음악 (세 프로젝트 공통 방식)

• 영상은 React 코드(Remotion)로 그린다. 같은 데이터면 같은 영상이 나와서 재현·수정이 쉽다. 프로젝트마다 node_modules 가 따로라 처음에 폴더에서 npm install. (버전: qna 4.0.525 · shortube 4.0.529 · funtube ^4.0.535)
• 음악·효과음은 코드로 합성한다 (bgm*.mjs, sfx.mjs, beat.mjs). 외부 음원·유튜브 오디오 보관함 대신 쓰는 이유: Content ID 클레임 걱정이 없고, 같은 timeline.json 을 읽어 장면 전환·숫자가 박히는 순간에 소리를 정확히 맞출 수 있다. 설명란에는 [음악] 채널에서 직접 만든 배경음악.
• 패턴: 장면 목록(timeline.json) → 영상 컴포넌트와 BGM 스크립트가 같은 파일을 읽음. 장면 길이를 바꾸면 BGM 도 다시 만들어야 맞는다 (npm run … 이 둘을 묶어 준다).
• Claude 는 소리를 들을 수 없다. 음악·음성은 만든 뒤 "한 번 들어 봐 달라"고 말한다. 볼륨은 RMS 로 확인 (대략 −15 ~ −20 dBFS).

1-4. Claude 가 따르는 문서 · 스킬 · 메모리

qna여덟 살의 질문

2-1. 무엇을 만드는 채널인가

가족 채널 모라구의 시리즈. 아이가 무심코 던진 질문("호텔이랑 모텔이 뭐가 달라?")에 엄마·아빠도 몰라서 얼버무리다가 명쾌하게 설명해 주는 구조. 교사–학생이 아니라 부모–자녀이고, "엄마아빠도 몰랐어요"라는 공감이 핵심 톤이다. 지금까지: 1호텔·모텔·유스호스텔 / 2아파트·빌라·오피스텔 / 3마트·시장·백화점 / 4몸·머리카락 / 5의사·약사·간호사 / 6감기·독감.

2-2. 폴더 지도 — 이 이름들만 쓴다

편 폴더 episodes/NN-slug/ 에 있어도 되는 파일

2-3. 한 편 만드는 11단계

1. 기획 자동(스킬)스킬 eight-year-olds-question 에 주제를 던지면 자료조사 · 7박자 콘티 · 컷별 그림 콘티 · 나레이션 대본(당황 대사 포함) · BGM/효과음 · 썸네일 문구 · 한 문장 정리까지 한 번에. → episodes/NN-slug/<slug>.md, index.html
2. 대본 · 그림 목록 자동(Claude)기획서 대본을 영상용으로 옮긴다 (3편이 기준 예시). → video/src/epNN/script.json, art.json
3. 콘티 확인 사람 확인npm run storyboard -- epNN → storyboard.html 을 열어 컷 구성·길이 확인. 여기서 대본을 고친다 (그림 그린 뒤에 고치면 낭비).
4. 그림 프롬프트 npm run prompts -- epNN → GEMINI_PROMPTS.md (공통 그림은 art/common/GEMINI_PROMPTS.md 에 한 번만).
5. 그림 사람artgen 은 유료Gemini 에서 손으로 뽑아 episodes/NN-slug/art/<id>.png 에 저장하거나, npm run artgen -- epNN (사용자에게 물어보고).
6. 그림 처리 자동npm run art -- epNN — 초록 배경 제거 · 여백 자르기 · 크기 맞춤 → video/public/art/epNN/. 끝나면 다시 npm run storyboard -- epNN.
7. 음성 gen 은 유료npm run voice -- epNN studio(손으로) 또는 … gen(API) → voice-studio/epNN/, src/epNN/timing.json.
8. 등록 · 미리보기src/Root.tsx 의 EPISODES 에 한 줄 추가 (timing.json 이 생긴 뒤) → npm run studio.
9. 완성 자동npm run make -- epNN → video/out/epNN/epNN.mp4 + subtitles.srt. 썸네일은 Ep NN-ThumbD 스틸.
10. 사이트 · 저장홈 index.html 카드 갱신, 브랜치에서 커밋 → PR.
11. 쇼츠 무료스킬 qna-shorts: 편집 계획 src/shorts/epNN.json → short -- epNN --check → short -- epNN → Chrome 으로 비공개 업로드. 롱폼 음성·그림을 재사용하므로 비용 0.

2-4. 시나리오 규칙 — 재미가 여기서 갈린다

7박자 구성 (컷의 beat 값)

소재 주의

• 몸 · 성 관련 소재는 몸을 그리지 않는다 (4편: 닫힌 문 · 거품 모자이크 · 단면도). 민감한 단어는 대사에만, 썸네일 · 제목 · 화면 글자(hook · stamp · end 포함)에는 쓰지 않는다. 쇼츠도 그런 대사를 아예 고르지 않는다.
• 의료 소재(5·6편)는 정보 전달 톤을 지키고, 진단·처방 권유처럼 들리지 않게.

2-5. script.json · art.json 읽는 법

사람이 고치는 두 파일. 영상의 모든 연출이 여기에 글로 적혀 있다 (video/src/epNN/).

script.json — 컷(cut) 구조

복사{
  "rawVoice": true,            // 전부 AI 음성이면 true (렌더 때 음높이 변조를 끈다)
  "speed": 1.15,               // 편 전체 배속 (음성을 다시 만들지 않아도 됨)
  "title": "마트 · 시장 · 백화점, 뭐가 달라요?",
  "bgm": "cheerful",           // public/bgm/cheerful.wav 를 대사 밑에 깐다. 줄을 지우면 BGM 없음
  "cuts": [{
    "id": "c00", "beat": "0. 지금 상황",
    "scene": {
      "bg": "bg/market-alley",
      "props":  [{"art":"prop/stall-front","x":0.2,"y":0.74,"w":0.4,"front":true}],
      "actors": [{"id":"granny","art":"granny/banter","x":0.2,"idle":"sway"},
                 {"id":"kid","art":"common/kid/normal","x":0.5},
                 {"id":"dad","art":"common/dad/panic","x":0.76}]
    },
    "lines": [
      {"who":"narr","text":"…","en":"…(영어 자막)"},
      {"who":"granny","text":"…","focus":"granny","cutin":"cutin/granny-banter","fx":"zoom"},
      {"who":"narr","text":"3분 전으로 돌아가 보겠습니다.","tts":"삼 분 전으로 …","pop":"3분 전","sfx":"rewind","fx":"flash"}
    ]
  }]
}

특별 컷: "style":"triptych" + "triptych":[{art,name,label}] (세 칸 정리), "style":"end" + "end":{series,title,next} (끝 화면). 말하는 인물은 자동으로 까딱거리고, 가만 있어도 숨 쉬며 발밑 그림자가 생기고, 컷 내내 카메라가 천천히 밀고 들어간다 (src/Scene.tsx).

art.json — 그림 목록

• cast: 가족이 아닌 사람의 생김새를 영어로 아주 구체적으로 적는다 (헤어 · 옷 · 표정 성격까지). 같은 사람이 매번 달라 보이지 않게 하는 핵심.
• common: 쓸 공통 그림 id (아빠·아이 표정 등). items[]: 그 편 전용 그림 — id · kind · title · cuts(쓰는 컷) + 묘사.
• 그림 종류 kind: char 전신 · cutin 가슴 위 · prop 소품 (이 셋은 초록 배경으로 뽑아 투명 처리) · bg 사람 없는 배경 · full 완성된 한 장짜리 장면(16:9). 확장: stage(주인공 자리를 비운 무대) · layer(배우를 가리는 앞쪽 물건) · talk(말하는 그림).
• 말하는 그림 <그림>-b: 같은 자세에 입만 다른 두 번째 그림. 있으면 말하는 동안 번갈아 나와 입이 움직인다 (없어도 됨).
• who + ref(기준 그림, 기준 그림 자신은 null)로 같은 인물을 이어 간다. inset: 0.025 는 그림 테두리 자르기, sky 는 장면 하늘색 지정.

2-6. 그림 뽑기 — 사람이 하는 유일한 반복 작업

1. 문서(GEMINI_PROMPTS.md)의 블록을 위에서부터 하나씩 처리한다. 프롬프트를 통째로 복사해 Gemini 에 붙여넣는다.
2. 블록에 적힌 첨부 이미지를 같이 올린다. ① 화풍 앵커(art/anchor/style-cutin.png) ② 같은 사람을 유지하기 위한 기준 그림. 순서를 지킨다.
3. 결과를 블록의 저장 경로·이름 그대로 저장한다. 배경 제거·크기 조절은 하지 않는다 (npm run art 가 한다).
4. 한 사람은 한 대화창에서 끝내고, 다음 사람·배경은 새 대화창에서. 대화가 길어지면 화풍이 흐려진다.

자주 생기는 문제와 다시 뽑을 때 이어 보내는 문장

npm run art -- epNN 경고: 배경을 못 지웠다(→ 위 문장으로 다시 뽑기) · 그림이 가장자리에 닿음(몸이 잘렸을 수 있음, 컷인은 가슴에서 잘리는 게 정상) · 원본이 작아서 흐림(더 큰 해상도 또는 Upscayl 2배) · 16:9 가 아님(Gemini 에서 비율을 16:9 로). 없는 그림은 영상에서 점선 임시 그림으로 나오므로 한 장씩 넣어 가며 확인해도 된다.

2-7. 음성 — 모든 편이 같은 음색

음성을 만드는 세 가지 방법

복사npm run voice -- ep02 gen
npm run voice -- ep02 gen --all

복사npm run voice -- ep02 studio
# 컷마다 복사 버튼 → AI Studio 에서
# Speaker1=Algenib, Speaker2=Leda 로 생성
# → voice-studio/ep02/<컷id>.wav 저장
npm run voice -- ep02 split

복사npm run handoff -- ep03

• 임시 음성: npm run tts -- epNN (Windows 내장 'Heami'). 흐름·길이 확인용. 임시 음성은 한 목소리를 변조해 쓰므로 실제 목소리를 넣을 땐 "rawVoice": true 필수.
• AI Studio WAV 는 안에 헤더가 한 번 더 있고 끝에 C2PA "AI 생성" 표시가 붙을 수 있다. voice.mjs 가 읽을 때 걸러 내니 손대지 않는다 (다른 편집기에 직접 넣을 때만 주의, 안 그러면 "칙" 잡음).
• 직접 녹음으로 바꿔 끼우기: voice -- epNN sheet (녹음 대본 voice-script.md) → public/epNN/voice/c01-0.wav 처럼 같은 이름으로 덮기 → voice -- epNN 으로 타이밍 재계산. 녹음한 뒤에는 --tts 를 붙이지 않는다 (임시 음성이 덮어씀).

2-8. 렌더 · 미리보기 · 배속 · 자막

복사cd D:\youtube\qna\video
npm run studio                  # 브라우저 미리보기 (왼쪽에서 Ep03 선택, 파일을 고치면 바로 반영)
npm run make -- ep03            # 프롬프트 문서 → 그림 처리 → (음성 없으면 임시 음성) → sfx/bgm → 배속 → 렌더 → 자막
npm run make -- ep03 --voice    # 대사가 바뀐 컷을 Gemini 음성으로 다시 (GEMINI_API_KEY, 유료)
npm run make -- ep03 --tts      # 임시 음성(Windows TTS)부터 다시
npm run stills -- ep03          # 컷별 1920x1080 PNG → out/ep03/cuts
npx remotion still src/index.ts Ep03-ThumbD out/ep03/thumbnail.png    # 얼굴 썸네일
npm run srt -- ep03 [en]        # 유튜브용 자막 (en 은 영어)

• 연출만 고쳤으면 음성을 다시 만들 필요가 없다. npm run studio 로 확인하고 make 만 다시. make 는 script.json 이 음성보다 새것이면 경고를 띄운다 (대사를 고쳤다면 --voice/--tts).
• 배속: script.json 의 "speed": 1.2 — 목소리·쉼·컷 전환·자막 타이밍 전부 (음높이 유지). 빠른 목소리는 scripts/speed.mjs 가 public/<편>/voice-x<배속>/ 에 미리 만든다. 줄을 지우면 1배속.
• BGM: "bgm":"cheerful" → node scripts/bgm.mjs 가 코드로 합성 (말하는 동안은 목소리보다 약 22dB 작게). 다른 곡은 public/bgm/<이름>.wav + 이름 변경. 효과음은 node scripts/sfx.mjs.
• 렌더 시간: 4분짜리에 6~7분쯤 (8분 영상은 더 걸린다).
• 완성본: out/epNN/epNN.mp4 (1920×1080) · subtitles.srt (+ subtitles.en.srt).

2-9. 쇼츠 — 롱폼을 유입용으로 다시 엮기 (스킬 qna-shorts)

음성·그림은 롱폼에 이미 있는 것만 쓴다 → Gemini 호출 없음, 비용 0. 새 대사가 필요하면 멈추고 사용자에게 묻는다.

구성 — 궁금증을 남기는 순서

1. 0초에 질문: 아이의 질문 대사로 바로 시작 (인사·나레이션 도입 금지). 위에 hook 두 줄이 쾅 — "아빠도 대답 못 한 / 진짜 차이"처럼 답이 있다는 약속.
2. 틀린 답 → 땡: 아빠가 얼버무린 대사에 stamp.
3. 반전 한 줄: "그런데 ~부터가 완전히 다릅니다"에 pop:"?!".
4. 챕터: 항목마다 chapter (위 목록에 불이 켜지고 첫째/둘째/셋째 도장). 한 항목에 대사 1~3개.
5. 마지막 항목은 답을 주지 않는다: 시작 대사 하나만 보이고 끝 카드로 질문을 남겨 본편으로. 목록에서도 마지막 항목은 차례가 올 때까지 ???.
6. 길이 40~55초 (60초 넘으면 경고), 대사 9~12개. 6번 박자와 롱폼의 결론 문장은 쓰지 않는다 — 본편에서 볼 이유를 남긴다.

복사{ "id":"Ep01-Short", "episode":"ep01", "series":"여덟 살 아들의 질문 1편",
  "topics":["호텔","모텔","유스호스텔"],
  "hook":["아빠도 대답 못 한","진짜 차이"],
  "segments":[
    { "line":"c01-1", "hl":["호텔이랑"], "cutin":false },           // 대사 id = <컷>-<번호>
    { "line":"c03-0", "stamp":{"text":"땡!","sub":"가격 차이가 아니었다"} },
    { "line":"c04-1", "transition":"whip", "pop":"?!" },
    { "line":"c05-0", "chapter":0, "transition":"whip" },
    { "line":"c07-0", "chapter":2, "transition":"glitch", "hold":4 }
  ],
  "end":{ "title":["독일의 한 선생님은","왜 이걸 만들었을까?"], "sub":"본편에서 확인하세요" },
  "upload":{ "longTitle":"…", "title":"… #shorts", "description":"…", "tags":[], "playlist":"여덟 살 아들의 호기심" } }

조각 옵션: transition whip(가로 모션블러, 컷이 바뀔 때) · glitch(마지막 ??? 항목) / zoom · cam(기본은 말하는 배우를 따라가는 카메라 — 배우 1.6배, 나레이션 1.35, 배경만 1.15) / hl(노랗게 칠할 단어, 한 대사 1~3개) / stamp · pop · shake · cutin · hold. 자동: 훅 플래시 · 단어 단위 자막 · 위 목록+진행 막대 · 필름 입자 · 비네트 · BGM · 효과음 · 끝 카드.

복사cd D:\youtube\qna\video
# 대사 목록 (id · 화자 · 길이 · 대사)
node -e "const s=require('./src/ep03/script.json'),t=require('./src/ep03/timing.json');for(const c of s.cuts)c.lines.forEach((l,i)=>console.log(c.id+'-'+i,l.who,(t[c.id+'-'+i]||0).toFixed(1)+'s',l.text))"
npm run short -- ep03 --check   # 조각마다 스틸 → out/shorts/ep03-check.png (직접 열어 본다)
npm run short -- ep03           # mp4 + upload.md + 10MB 이하 업로드용 사본(.upload.mp4)

확인할 것: 글자가 오른쪽 140px · 아래 330px(쇼츠 UI 자리)에 걸리지 않는지 · 자막이 얼굴을 가리지 않는지 · 같은 그림이 3번 넘게 연달아 나오지 않는지. 고칠 게 있으면 json 만 고치고 다시 --check.

2-10. YouTube Studio 업로드 (Claude in Chrome)

1. anthropic-skills:chrome-browser 스킬을 읽고 도구를 한 번에 불러온다 → tabs_context_mcp → 새 탭 → studio.youtube.com. 로그인 화면이면 멈추고 사용자에게 부탁 (비밀번호를 대신 넣지 않는다).
2. 본편 URL 찾기 (관련 동영상용). 업로드 창은 …/videos/upload?d=ud 로 바로 열린다.
3. 파일은 find 로 input type=file 을 찾아 file_upload — 10MB 한도라 epNN-short.upload.mp4 사본을 쓴다. 파일 선택 버튼은 클릭하지 않는다(보이지 않는 창이 열림).
4. 제목 칸은 파일명이 들어 있으니 클릭 → ctrl+a → 입력. 설명 · 재생목록 · 아동용("아니요, 아동용이 아닙니다" — 묻지 않고 선택) · "자세히 보기"로 태그(쉼표로 끝맺기) · AI 사용: "예"(그림·목소리가 AI 생성).
5. "동영상 요소"의 관련 동영상에 본편 연결. 전화 인증 창이 뜨면 취소 (채널 인증은 이미 완료 2026-10-16).
6. 공개 상태 비공개를 확대 화면으로 확인 → 저장. 영상 링크를 out/shorts/epNN-short.upload.md 끝 ## 업로드 기록 에 적는다.

• 롱폼(수백 MB)은 확장으로 못 올린다(10MB). 업로드 창만 열고 사람이 파일을 끌어다 놓은 뒤 세부정보·썸네일·자막(파일 업로드 → '타이밍 포함')·영어 제목/설명(영어(미국), 제목 100자 넘으면 저장 안 됨)을 채운다.
• 같은 동작이 2~3번 실패하면 반복하지 말고 사용자에게 묻는다. 알림·확인창(삭제 등)을 띄우는 버튼은 누르지 않는다.
• 업로드 창 클릭은 ref 보다 스크린샷 좌표로, 누른 뒤 zoom 으로 확인 (창이 다시 그려지면 ref 클릭이 안 먹을 때가 있음).
• Chrome 이 다른 Google 계정(AI Studio 용)이면 "권한이 없습니다" → 사람에게 계정 전환 부탁.

2-11. qna 자동화 팁

shortube숫자로 보는 요즘

3-1. 무엇을 만드는 채널인가

채널 숫자로 보는 요즘(UCatFTcoyLuCtsiK8JTPfQkA) — 요즘 화제를 숫자·그래프로 짚는 40~60초 쇼츠. 화면은 텍스트 · 직접 그린 차트 · 도형 · 입자뿐(인물 사진·로고·캡처·음원 없음), 배경음악은 코드 합성. 재생목록: 숫자로 보는 시장 · 순위·차트 · 날씨·생활 · 건강.

3-2. 한 편 만드는 6단계 (shortube/CLAUDE.md 0장)

1. 브리프 먼저 Claudeoutput/briefs/YYYY-MM-DD_slotN.md — 출처 표 · 사실 카드(YAML) · 스토리라인 · 연출 카드 · 메타데이터 · 검수 체크리스트. 영상에 들어가는 숫자는 사실 카드에 있는 것만.
2. 영상video/src/<주제>/ 에 컴포지션 + timeline.json(장면·타격 시점) + Root.tsx 등록.
3. 배경음악video/scripts/bgm-*.mjs 로 코드 합성 (같은 timeline.json 을 읽어 장면 전환과 맞춘다).
4. 점검 눈으로핵심 프레임 스틸 npx remotion still <Id> out.png --frame=N --scale=0.4 를 직접 보고 겹침·잘림·줄바꿈을 고친 뒤 렌더.
5. 업로드3-9장. 기본은 비공개. 공개는 사용자가 명시적으로 요청할 때만.
6. 보고무엇을 만들었고 무엇을 확인 못 했는지(음악은 귀로 못 들음, 미확인 사실 카드)를 그대로 알린다.

3-3. 주제 자동 선정 (Python + 스킬 shortube-daily)

"오늘 쇼츠 만들어줘" / /shortube-daily 2 → 사용자에게 주제를 묻지 않고 끝까지 진행한다. 후보가 0개처럼 규칙상 불가능할 때만 멈춘다. 업로드는 하지 않는다.

복사cd D:\youtube\shortube
export PYTHONIOENCODING=utf-8
.venv/Scripts/python.exe -m shortube entities       # 최근 14일 OTT 작품 (캐시되므로 재실행 무해)
.venv/Scripts/python.exe -m shortube autocomplete   # 자동완성 후보 + 리스크/조언/노이즈 필터
.venv/Scripts/python.exe -m shortube pick --count 2 --json   # 로테이션이 슬롯별 category · entity · shortlist 선정
# …브리프 작성·제작 후 이력 기록 (다음 날 로테이션·쿨다운에 반영)
.venv/Scripts/python.exe -m shortube log-topic "<대표 키워드>" --category chart --brief output/briefs/<파일>.md

3-4. 규칙 — 쇼츠 작업 전에 반드시 (COMPLIANCE_GUIDE 요약)

핵심 5줄

1. 사실은 가져오고 표현은 직접 만든다. 기사 문장·구성·사진은 보호된다.
2. 사람(개인) 콘텐츠는 만들지 않는다. 한국은 사실을 말해도 명예훼손이 성립할 수 있다(형법 307조 1항).
3. 이미지·영상·음원은 외부에서 가져오지 않는다. 텍스트 · 직접 그린 차트 · 라이선스 명확한 아이콘/지도만.
4. 영상마다 "내가 더한 가치"(직접 계산 · 비교 · 시계열 해석 · 오해 바로잡기). 같은 틀에 단어만 바꾼 대량 생산은 수익화(YPP) "진정성 없는 콘텐츠"로 빠진다.
5. 자동화는 초안까지, 공개는 사람이.

주제별 반드시 / 금지

출처 등급

금지 항목 (만들지 않음)

연예인 근황·열애·논란 콘텐츠 · 인물 사진·포스터·스틸컷·앨범아트·캡처 · 기업 로고 · 기사/블로그 문장 복사·살짝 바꿔쓰기 · 차트 전체(TOP100) 매주 그대로 옮기기 · 유명인 목소리 복제 TTS · 상업 음원/타 채널 BGM · 드라마 결말 상세 재서술 · 조회수/구독/댓글 자동화 봇·다계정 · 내용과 무관한 자극 제목/썸네일 · 태그/설명란 키워드 나열.

3-5. 브리프 · 사실 카드 — 영상의 뼈대

브리프 템플릿 (output/briefs/YYYY-MM-DD_slotN.md)

1. 머리: 날짜 · 슬롯 · 대표 키워드 · 데이터 기준일 · 선정 근거 · ⚠ 요청 전제 바로잡기
2. 출처 표: # · 기관/사이트 · 문서 · URL · 등급 · 확인일 (1차 자료를 못 열었으면 "미확인 — 제작 전 필수"로 표시)
3. 사실 카드(YAML): id · claim(내 말 1문장) · value · unit · as_of · sources[#] · verified(true/partial/false) · sensitivity
4. 직접 계산(부가가치): 계산식을 적는다 (예: 3.83 ÷ 0.34 = 11.3배)
5. 대본 표: 시간 · 내레이션/자막 · 화면 — 사실 카드만 보고 쓴다
6. 연출 카드 7항목 · 메타데이터(제목 후보 3 · 설명란 · 태그 ≤10) · 검수 체크리스트

복사- id: M1
  claim: "2026-10-16(금) 미국 종가: 나스닥 -2.15%, S&P500 -1.09%, 다우 -0.34%"
  as_of: 2026-10-16
  sources: [1, 3]
  verified: true      # 목요일 종가와 등락률로 역산해 일치 확인
- id: M3
  claim: "한 주 성과: 나스닥 -4.48% …"
  sources: [2]
  verified: partial   # 1건 → 화면에 '보도 기준'

• 출처 2개 이상 교차 확인. 하나뿐이면 verified: partial + 화면에 "보도 기준". 출처끼리 수치가 다르면 대본에서 빼거나 "기관마다 차이"로.
• 시세는 Yahoo 일봉이 공식 종가와 맞음(뉴스 종가와 대조 필수). 네이버 차트는 시간외 포함이라 종가가 다를 수 있음. 0거래량·평평한 봉 같은 깨진 봉을 검사하고, 보정했으면 브리프에 기록.
• 기간이 다른 값 비교(1년 vs 반기) 금지 — 기간 명시. 다른 임상시험끼리의 수치는 "다른 시험" 표기. 숫자에는 항상 기준일과 단위.
• 문장은 사실 카드만 보고 새로 쓴다. 출처 문장과 연속 20자 이상 겹치지 않게(렌더 전 재확인). 정식 기준: 5-gram 겹침 15% 초과 시 실패.

3-6. 영상 코드 구조 (shortube/video)

새 영상을 추가하는 패턴 (예: UsShort)

1. src/<주제>/timeline.json — 장면 길이(프레임, 30fps) · hits · risers. 합계가 total.
2. fx.tsx(배경·전환·상단 띠) + scenes.tsx(장면별 컴포넌트 + Caption 줄) + <Name>Short.tsx(Sequence 조립).
3. Root.tsx 에 <Composition id=… durationInFrames={TOTAL} …/> 추가, package.json 에 "<주제>": "node scripts/bgm-<주제>.mjs && remotion render …" 한 줄.
4. npx tsc --noEmit 으로 타입 확인 → 스틸 점검 → npm run <주제>.

화면 규칙

• 1080×1920. 자막은 하단 박스(bottom 250) — 본문 요소가 y≈1450 아래로 내려오면 겹친다. 줄바꿈이 어색하면 whiteSpace:"pre-line" 이나 wordBreak:"keep-all", 아니면 문장 수정.
• 출처·기준일·고지는 마지막 장면 또는 상단 고정 띠(TopBand).
• 브랜드(남색 + 노랑 선 + 분홍 점, Brand.tsx)는 첫 1초나 마지막 띠로만. 본문 배경까지 매번 남색으로 고정하지 않는다.
• 쓸 수 있는 재료: 코드 생성(SVG 필터·입자·그라디언트·도형 패턴·카메라 이동·화면 나누기) / 라이선스 분명한 외부 자료(Natural Earth 지도 · Material Symbols · Tabler Icons · Noto Emoji · OFL 폰트 — 받으면 video/public/<종류>/LICENSE.md 에 출처·라이선스·날짜) / 사진·영상 클립은 쓰지 않는다.

3-7. 연출 카드 — 찍어낸 영상처럼 보이지 않게

브리프마다 7항목을 채운다: 팔레트 · 주 레이아웃 · 장면 전환 · 카메라 · 상징 오브젝트 · 타이포 · 템포. 규칙: 직전 2편과 7항목 중 4개 이상 달라야 하고, 같은 날 올리는 2편은 팔레트·주 레이아웃이 반드시 달라야 한다. 주제가 연출을 정한다 (더위 → 아지랑이·색 온도 / 시황 → 흔들림·긴박한 컷 / 수능 → 칠판·OMR / GTA → 노을 네온 고속도로 / 간밤 미국장 → 수심 눈금으로 낙하).

3-8. 배경음악 — 코드 합성

• 외부 음원·오디오 보관함 대신 코드 합성이 기본. 설명란 [음악] 채널에서 직접 만든 배경음악.
• 기존 스크립트(분위기별): bgm.mjs(밝고 잔잔) · bgm-tension.mjs(긴박·시황) · bgm-dance.mjs(밝은 댄스·K팝) · bgm-info.mjs(차분한 정보·의료, 리스크 구간 단조) · bgm-heat.mjs(더위→식음) · bgm-gta.mjs · bgm-suneung.mjs · bgm-usmarket.mjs(저음 드론 + 물방울). 새 주제는 비슷한 것을 복사해 진행·템포·화음만 바꾼다.
• 구조: 마디 단위로 패드 코드 → 킥/물방울 같은 리듬 → timeline.json 의 risers(전환 직전 스웰) · hits(숫자 박히는 순간 킥/벨) → 끝 2초 페이드 → 정규화(tanh) → 16bit WAV. 마지막에 RMS dBFS 를 출력해 볼륨 점검 (대략 −15~−20, 영상 쪽 <Audio volume=0.75>).
• 분위기 전환 아이디어: 특정 프레임(calmFrom·coolFrom) 이후 단조→장조, 킥 제거 — 이야기의 "식는 순간"을 소리로.

3-9. 시황 · 차트 주제를 만들 때 (가장 위험한 영역)

• 종가 기준·기준일을 화면에 상시 표기(TopBand). 미국장은 "미국 현지 종가".
• 한국 차트 색: 상승 빨강 · 하락 파랑. 사용자가 "피로 물든"처럼 미국식 색으로 말해도 영상은 한국식 + 첫 장면에서 한 줄로 짚기.
• 수치 검증 요령: 지수 종가를 (전날 종가 × 등락률)로 역산해 보도와 맞추면 1건 보도도 신뢰도가 올라간다. 일봉 기술 분석은 stockstealer 규칙(200일선 국면 · 이평 정배열 · RSI14 · 볼린저 · 지지·저항 피벗)을 같은 기준으로 세 차트에 적용 → "과매도 ✓ / 추세 ✗" 같은 판정 요약이 부가가치.
• 못 찾은 값(예: 금요일 마감 금리)은 빈칸으로 두고 "확인하지 못해 싣지 않았습니다"라고 화면에 적는 편이 틀린 숫자보다 낫다.
• 의료 주제: 효과와 같은 비중으로 부작용·중단 후 요요·규제, "전문의약품 · 의사 처방 필요 · 의학적 조언 아님" 상시 표기. 연예: 그룹 단위 공개 사실만, 미성년 개인 정보 금지.

3-10. 업로드 · 한도 (Claude in Chrome)

1. 준비: 원본은 output/videos/. 확장의 업로드는 파일당 10MB 제한인데 이번 영상(약 9.6MB)은 그대로 통과했다. 넘으면 스크래치패드에 2-pass 압축본(-b:v 1100~1600k, aac 128k)을 만들고 프레임 하나 뽑아 화질 확인.
2. 새 탭에서 작업: tabs_context_mcp → 새 탭 → studio.youtube.com/channel/<채널ID>/videos/upload?d=ud (업로드 창이 바로 열림). 사용자가 쓰는 탭은 건드리지 않고, 끝나면 내가 연 탭을 닫는다.
3. 파일: find 로 file input → file_upload (파일 선택 버튼은 클릭 금지).
4. 세부정보: 제목 클릭 → ctrl+a → 입력 / 설명은 기본 틀 [자료 출처]…"0000년 0월 0일" 을 통째로 지우고 브리프의 설명으로 교체 / 재생목록 드롭다운에서 주제에 맞는 것(맞는 게 없으면 새로 만들지 말고 사용자에게 묻기) / 아동용 아님 / "자세히 보기" 펼쳐 AI 사용 = 아니요(텍스트·차트만, 실존 인물처럼 보이는 합성·음성 없을 때만) / 태그(쉼표로 끝맺기, 10개 이하).
5. 검증: 입력 후 스크린샷으로 내용이 남아 있는지 확인(업로드 직후 대화상자가 다시 그려지며 입력이 날아갈 수 있음). 라디오 선택은 스크롤해서 실제 선택됐는지 다시 본다.
6. 공개 범위: 기본 비공개. 사용자가 "공개로"라고 명시한 경우에만 공개 선택 후 "게시". 자동 모드 권한이 막으면 우회하지 말고 Studio 에서 직접 바꾸도록 안내.
7. 사후 확인: Studio 콘텐츠 목록에서 실제 공개 상태·게시일을 다시 확인(채널 기본값 때문에 의도와 다르게 공개될 수 있음). 영상 ID 는 목록 링크(/video/<ID>/edit)에서 읽는다.
8. 장부: output/uploads.csv 에 한 줄 — uploaded_at,video_id,brief,title,visibility,category, 시각은 한국시간.

• 채널 업로드 기본값(2026-10-16 설정): 카테고리 교육 · 언어 한국어 · 설명란에 [자료 출처] 틀이 미리 들어감.
• 영상 파일 교체는 불가 → 새로 올리고 옛 영상 삭제는 사용자가 한다 (영구 삭제는 Claude 가 하지 않음).
• 설명란 고정 문구: 출처 목록 · "OO년 O월 O일 기준이며 이후 바뀔 수 있습니다" · 투자/의료 고지 · 직접 계산한 값 명시 · "대본 초안 작성에 AI 도구를 사용했으며 사람이 검수했습니다" · [음악] · 보도 1건 기준 수치 안내.

3-11. shortube 자동화 팁

funtube웃긴 영상툰 · 하이브리드 방향 (코드에서 정리)

4-1. 무엇인가 · 방향

1080×1920 세로 영상 모음. 대본(JSON) 한 파일 → AI 음성 → Remotion 렌더가 기본 흐름이다. 초기에는 말풍선·이모지·2D SVG 위주였지만, 지금 방향은 하이브리드다: "코드가 잘하는 것"과 "AI가 잘하는 것"을 한 장면 안에서 나눠 맡긴다.

out/ 에 chat · skit · facts · balance · fight · ride · ride3d · ride3dface · carpool .mp4 가 있다 (ride3dface-v2/-v3 는 표정 시트를 바꿔 가며 비교한 버전).

4-2. 영상 형식 9가지 — 방식별로 나누면

2D 코드 방식(chat · skit · facts · balance · fight · ride)과 3D 하이브리드 방식(carpool · ride3d · ride3dface)으로 갈린다. 새 영상은 3D 하이브리드를 기본 방향으로 보고, 가벼운 형식(단톡·상식·밸런스)은 2D 로 빠르게 뽑는다.

4-3. 하이브리드 방식 — 무엇을 어떻게 섞나

한 장면의 층 구조 (Carpool.tsx 기준)

핵심은 "AI 산출물은 얼굴 그림과 목소리 두 가지뿐"이라는 점이다. 그래서 (1) 캐릭터 일관성이 코드로 보장되고(몸·옷·무대는 매번 같음), (2) 대사 한 줄을 고치면 그 줄 음성만 다시 만들면 되고, (3) 연기를 바꾸는 건 대본의 act 이름 하나만 바꾸면 된다.

언제 무엇을 쓰나

대본에서 연출을 지정하는 법 (carpool 예)

복사{ "who":"선배", "text":"야, 너 5분 늦었어. 시간 개념이 없어.",
  "style":"scolding loudly, annoyed older boss",      // TTS 영어 톤
  "cam":"c선배",                                       // 카메라 샷: wide · two · c선배 · c후배 · creep
  "face":{ "선배":3, "후배":1 },                        // 표정 번호 1~6 (아래 표). 지정 안 하면 직전 표정 유지, 말하는 줄은 기본 2(TALKING)
  "act": { "선배":"scold", "후배":"deadpan" } }         // 몸 연기 이름 (ACTS 사전). 다음 지정 전까지 유지

{ "who":"효과", "text":"", "dur":1, "sfx":"door" }      // voices 에 없는 who = 음성 없는 효과 줄 (dur 초)
{ "who":"내비", "text":"200미터 앞, 직진입니다.", "fx":"nav", "sound":"⬆ 직진 200m", "sfx":"chime" }   // fx:nav → 내비 화면에 sound 표시

4-4. 제작 순서

1. 대본 쓰기 사람·Claudecontent/episodes.json 에 새 키(id)로 title · voices · lines 추가. 노래면 content/song.json. 하이브리드 콩트라면 줄마다 cam · face · act 까지 적는다(4-3).
2. 표정 시트 준비 생성은 유료(하이브리드만) 캐릭터 묘사를 content/faces.json 의 characters 에 추가 → node scripts/facegen.mjs --list 로 프롬프트 확인(무료) → 요청이 있을 때만 facegen <이름>. 이미 있는 시트면 --process-only. 이 단계가 끝나야 public/faces/<이름>_1..6.png 가 생긴다.
3. 컴포넌트 연결2D 형식은 기존 컴포넌트(Chat·Facts …)를 쓰면 되고, 새 형식이면 src/Root.tsx 의 EPISODES 배열에 {id, component} 추가 (EpisodeId 는 episodes.json 키에서 자동). 3D 콩트는 Carpool.tsx 를 복사해 EP · WHO · X(좌석 위치) · LOOK(옷·머리색) · CAMS 를 바꾼다.
4. 음성 + 효과음 키가 있으면 유료npm run tts (특정 편만: node scripts/tts.mjs carpool). 효과음 14종은 이때 코드로 합성된다. 먼저 TTS_DRY=1 npm run tts 로 길이만 추정해 레이아웃을 확인하고(무료), 마음에 들면 키로 생성.
5. 미리보기npm run studio → 샷·표정·연기·타이밍 확인. 대사만 고쳤다면 tts 를 다시 (바뀐 줄만 생성). 연기·카메라만 고쳤다면 음성은 그대로 두고 studio 로 확인.
6. 렌더 무료npm run render (전부) 또는 node scripts/render.mjs carpool → out/<id>.mp4. 노래는 먼저 npm run beat. 3D 는 느리니 한 편씩.
7. 타입 점검npm run typecheck.

4-5. content/ 파일 — 대본 문법

복사"chat": {
  "title": "아빠가 갑자기 사랑한다고 했다",
  "room": "우리집 🏠",
  "voices": { "아빠":"Charon", "엄마":"Kore", "나":"Puck", "시스템":"Zephyr" },   // 화자 → Gemini 보이스
  "lines": [
    { "who":"아빠", "text":"사랑해 ❤️", "say":"사랑해~",                          // text=화면, say=읽을 문장(이모지·기호 보정)
      "style":"suspiciously sweet and sheepish" },                              // 영어 톤 지시 (TTS 프롬프트에 들어감)
    { "who":"시스템", "text":"엄마님이 아빠님을 내보냈습니다.", "pauseAfter":1.5 }   // 이 줄 뒤 추가 쉼(초)
  ] }

같은 cam 이라는 필드 이름이라도 2D(fight)와 3D(carpool)에서 값 목록이 다르다(2D: wide/mid/closeL/closeR, 3D: wide/two/c선배/c후배/creep). 형식별 컴포넌트가 해석한다.

타이밍은 src/timeline.ts 가 계산: 첫 대사 앞 0.4초, 줄 사이 기본 0.35초, pauseAfter 추가, 끝 0.5초. src/generated/timings.json 이 (줄별 음성 파일 · 길이)를 담는다 — 자동 생성이니 손으로 고치지 않는다.

4-6. 음성 · 효과음 (scripts/tts.mjs)

• 모델 기본 gemini-2.5-flash-preview-tts (환경변수 GEMINI_TTS_MODEL 로 변경). 출력 24kHz 16bit 모노 PCM → WAV. 앞뒤 무음 자동 제거(0.05초만 남김).
• 캐시: [모델|보이스|style|say] md5 가 같고 파일이 있으면 다시 생성하지 않는다 → 대사 하나만 고치면 그 줄만 과금. 429/5xx 는 15초씩 늘려 최대 6번 재시도.
• 키 순서: 환경변수 GEMINI_API_KEY/GOOGLE_API_KEY → 루트 .env. 키가 없으면 음성 없이 글자 수 × 0.13초로 길이만 추정해 타이밍을 만든다 (레이아웃 점검용, 무료). TTS_DRY=1 로 일부러 키를 무시할 수 있다.
• 효과음 14종은 저작권 걱정 없이 코드로 합성해 public/sfx/ 에 만든다: 기본 pop tick ding boom crinkle whoosh punch powerup + 콩트용 사운드 디자인(차 안) door(문) · blinker(깜빡이) · chime(내비 안내음) · heart(심장 소리 4박) · away(멀어지는 소리) · engine(엔진 저음, 반복 재생용). 새 효과음은 synth("이름", 길이초, (t,p)=>…) 한 줄 추가 후 tts 를 한 번 돌리면 생성된다(키 없어도 됨).
• 하이브리드 콩트에서는 목소리마다 역할에 맞는 보이스 + 영어 톤(예: 선배 "scolding loudly, annoyed older boss", 후배 "flat deadpan, very tired", 내비 "robotic car navigation voice, polite and flat")을 줘서 연기와 어울리게 한다. 한 편에서 보이스가 겹치지 않게 voices 를 정한다.

4-7. 노래 영상 (beat.mjs · song.json)

• song.json = title · lead · sections[]. 섹션: name · style(intro/verse/chorus/bridge/end) · bpm · energy(0~3) · lines[{who,text,beats}]. bpm: 0 이면 음악 없는 정적 구간(lines[].seconds 사용).
• node scripts/beat.mjs (npm run beat) 가 이 구조대로 킥·스네어 등 비트를 코드로 합성해 public/bgm/ride.wav 로 저장 (고정 시드 잡음 → 매번 같은 소리, API 없음, 무료).
• 영상 쪽 src/songTimeline.ts 가 같은 계산으로 가사 타이밍을 만들고, 풍경 이동 속도는 bpm × 7 px/초(정적 구간은 멈춤). beat.mjs 와 songTimeline.ts 의 계산이 어긋나면 소리와 가사가 어긋난다 — 한쪽을 고치면 다른 쪽도 같이.
• 가사는 beats 로 길이를 정하므로, 박자 수만 바꿔 가사를 늘이고 줄인다.

4-8. 얼굴 표정 시트 — 하이브리드의 AI 쪽 (facegen.mjs)

3D 노래(ride3dface)와 3D 콩트(carpool)가 같은 표정 시트(public/faces/선배_1..6.png, 후배_1..6.png)를 쓴다. 캐릭터가 늘면 faces.json 의 characters 에 묘사를 추가해 시트를 새로 만든다. 표정 번호 의미는 4-3 의 표.

복사node scripts/facegen.mjs --list                  # 프롬프트만 출력 (무료)
node scripts/facegen.mjs 선배 후배                # Gemini 로 6칸 표정 시트 생성 (유료)
node scripts/facegen.mjs --process-only          # 이미 받은 원본(art/faces/raw_<이름>.png)만 다시 자르기 (무료)
node scripts/facegen.mjs --placeholder           # 임시 시트로 자르기만 — 파이프라인 점검 (무료)
node scripts/facegen.mjs 선배 --force            # 원본이 있어도 다시 생성 (유료)

• content/faces.json = 화풍(한국 웹툰 개그체 "grotesque-cute") · 작업 지시 · 캐릭터별 묘사 · 6표정 · 레이아웃. 얼굴 이목구비만 초록(#00FF00) 배경에 3×2 격자로 그리게 한다 (머리 윤곽·머리카락·몸 없음 — 3D 머리에 투영하는 데칼).
• 처리: 초록 키잉 → 가장 넓은 빈 틈 n개를 칸 경계로 → 6칸으로 잘라 public/faces/<이름>_1..6.png (투명 PNG). Gemini 가 오른쪽 아래에 넣는 작은 별 로고는 지운다.
• 429 면 예비 키(GEMINI_API_KEY2)로 바꿔 재시도, 이미지 모델은 키로 쓸 수 있는 것 중 최신을 자동 선택(GEMINI_IMAGE_MODEL 로 고정 가능).
• 표정 파일이 모자라면 원본(raw_*.png · _v1 · _v2-pale 버전들)을 art/faces 에 보관해 두고 --process-only 로 다듬기만 반복.

4-9. funtube 자동화 팁

5. Claude 에게 이렇게 말하세요

버튼으로 복사해서 그대로 붙여 쓸 수 있습니다. 괄호는 바꿔 넣으세요. 키 있는 생성이 필요하면 "API 로 만들어 줘"라고 분명히 말해야 유료 명령이 실행됩니다.

qna

shortube

funtube

문서 · 정리

6. 막힐 때 · 체크리스트

6-1. 증상 → 원인 → 처방

6-2. 올리기 전 체크리스트

6-3. 이 문서를 최신으로 유지하기

• 규칙의 원본은 각 프로젝트의 CLAUDE.md·스킬 문서다. 이 가이드는 그 요약 + 실전 팁이므로, 원본이 바뀌면 이 문서도 같이 고친다 (Claude 에게 "규칙 반영" 문구 사용).
• 정책·법령·모델 이름은 바뀐다. COMPLIANCE_GUIDE 의 원문 링크(YouTube 수익 창출·스팸·합성 콘텐츠 정책, API 개발자 정책)는 분기마다 재확인. TTS 모델명도 구현 전에 공식 문서 재확인.
• 이 문서에는 키 값을 쓰지 않는다.

7. 명령어 전체표

qna cd D:\youtube\qna\video

shortube cd D:\youtube\shortube (Python) · cd video (영상)

funtube cd D:\youtube\funtube