# 작업지시서: 쇼츠 시안 v3 — v2 대본·음성 그대로, 스타일 B로 화면만 교체

## 목표
v2(`pilot\v2\`, `out\pilot_v2.mp4`)와 **같은 대본·같은 음성·같은 타이밍**으로,
화면 스타일만 `C:\Ai_Coding\scratch\video-skill\STYLE_SPEC_B.md`(밝은 만화·마스코트 진행형)로 바꾼 v3를 만든다.

## 먼저 읽을 것
- `C:\Ai_Coding\scratch\video-skill\STYLE_SPEC_B.md` (이번 스타일 — 그대로 따를 것)
- v2 소스: `pilot\v2\` (build_composition.py, index.html, 음성 파일, tts_timestamps)

## 재사용 규칙 (토큰·시간 절약)
- **v2 음성 파일과 단어 타임스탬프를 그대로 사용. TTS 재생성 금지.**
- 장면 시작·끝 시간도 v2와 동일하게 유지.
- 작업 폴더: `pilot\v3\` 로 v2를 복사한 뒤 수정. v1·v2 파일 수정·덮어쓰기 금지.

## 스타일 B 적용 사항
1. **배경**: 장면마다 단색 교체 (방사형 그라데이션). 순서:
   1 하늘 `#8EC9EE` → 2 노랑 `#F6D466` → 3 코랄 `#EE8F86` → 4 연두 `#9ED98A` → 5 하늘 → 6 보라분홍 `#D98FD6` → 7 노랑 → 8 연두 → 9 하늘 → 10 코랄 → 11 노랑
2. **상단 진행바**: `▶ 쇼츠 따라 만들기` + 번호 원 3개(①보기 ②설계 ③제작).
   장면 1~4: 모두 빈 원 / 5: ① 현재 / 6: ① 완료·② 현재 / 7: ①② 완료 / 8: ③ 현재 / 9~11: 전부 완료
3. **자막**: 좌측 하단 검정 박스 + 흰 글자, 좌측 정렬, **구(句) 단위 표시** (단어별 pill 카라오케 폐지).
   - 구 경계는 v2 타임스탬프의 문장부호(, .) 기준. **문장 끝을 넘어 다음 문장 단어와 섞지 말 것** (v2 결함).
   - 핵심어만 노랑 `#F6C945`: 1 "AI 둘" / 2 "뜯어보긴" / 3 "주의할 점" / 4 "watch 스킬", "2만 개" / 5 "1초마다" / 6 "설계서" / 7 "HyperFrames" / 8 "목소리" / 9 "지시", "만들어요" / 10 "스타일만", "쓰지 마세요" / 11 "이렇게"
4. **마스코트**: 우하단 상주. **원본 채널 캐릭터와 다른 새 디자인** (예: 둥근 필름 카메라 몸통 + 막대 팔다리, 굵은 검정 외곽선). 장면별 포즈 2~3종(기본/손 흔들기/놀람) 교체. 순수 SVG/CSS로 제작.
5. **비주얼 카드**: 흰 카드 + 굵은 검정 테두리 + 하드 섀도의 플랫 만화풍. 장면별 내용은 v2 장면 의미 유지하되 B 모티프로 재구성:
   - 4: 플립 숫자 카운터(검정 타일 흰 숫자)로 별 0→20,150, 작은 글씨 "2026.11 기준"
   - 10: 체크리스트 카드(자물쇠 헤더) + 노란 경고 삼각형, 항목에 `!` 순차 점등
   - 그 외 장면은 일러스트 씬 카드·문서 카드·코드 카드·아이콘 스티커 중 적절히 선택
6. 효과음·배경음악 없음. 실제 회사 로고 이미지 금지(텍스트·일반 도형만). 지시에 없는 설명 문구 추가 금지(v2에서 "10번째 장면에서 확인하세요" 같은 임의 문구가 들어갔음).

## 렌더링
- 1080×1920, 30fps, MP4, `--workers 2`
- 산출: `pilot\out\pilot_v3.mp4`
- 렌더를 백그라운드로 돌렸다면 **완료까지 기다린 뒤** 다음 단계 진행하고 worker_done 전송 (턴을 먼저 끝내지 말 것)

## 편집 허용 범위
- `C:\Ai_Coding\scratch\video-skill\pilot\v3\`, `pilot\out\` 내부만. 새 패키지 설치 금지.

## 완료 증거
`pilot\REPORT_v3.md`:
- ffprobe 요약 (해상도, 길이 — v2와 같아야 함, 용량, 오디오 유무)
- 렌더 시간, 워커 수, `npx hyperframes check` 결과
- 마스코트 디자인 설명 1~2줄
- 장면 중간 시점 프레임 PNG 11장: `pilot\out\v3_frames\scene_01.png` … `scene_11.png`

## 성공/실패 기준
- pilot_v3.mp4가 1080×1920, 길이 v2와 ±0.5초, 음성 포함이면 succeeded. 실패 시 failed + 오류 원문.
- worker_done에 반드시 --task-id, --dispatch-id 포함.
