# 작업지시서: 쇼츠 시안 v2 (약 45초, 11장면) — v1 코드 재사용

## 목표
v1(`C:\Ai_Coding\scratch\video-skill\pilot\`, `out\pilot_v1.mp4`)과 같은 스타일로 11장면 약 45초 버전을 만든다.
**v1의 index.html·컴포넌트·자막 로직·TTS 스크립트를 재사용**하고 장면만 추가/교체한다 (처음부터 다시 작성 금지 — 토큰 절약).

## 먼저 읽을 것
- `C:\Ai_Coding\scratch\video-skill\STYLE_SPEC.md`
- v1 산출물: `pilot\index.html`, `pilot\REPORT.md`, `pilot\tts_timestamps.json` 및 TTS 생성 스크립트

## v1 결함 수정 (필수)
1. 긴 자막(4어절이 한 줄에 안 들어가는 경우)은 글자 축소 대신 **자막 그룹을 2개로 나눠** 순차 표시. 자막 글자 크기는 전 장면 동일 유지, 좌우 여백 최소 80px.
2. 자막 어절 간 간격 균일화 (v1 1장면 "마음에 / 드는" 사이 간격이 과하게 넓었음).

## 대본 (문구 수정 금지)
| # | 헤드라인 1줄(흰) / 2줄(주황) | 내레이션 = 자막 | 비주얼 지침 |
|---|---|---|---|
| 1 | 쇼츠 만들기 / AI 둘이 나눠서 | 쇼츠 만들기, 이제 AI 둘한테 나눠 맡겨요. | 원형 아이콘 2개(클로드/안티그래비티 — 텍스트 라벨만) 가 양쪽에서 등장 |
| 2 | 따라 하고 싶은 쇼츠 / 뜯어보기 힘들다 | 따라 하고 싶은 쇼츠가 있어도, 화면 하나하나 뜯어보긴 힘들잖아요. | v1 폰 카드 + 주변에 물음표 카드 여러 장 |
| 3 | 주의할 점 하나 / 끝에 알려드림 | 주의할 점 하나는 끝에 알려 드릴게요. | 봉인된 봉투 카드 (STYLE_SPEC 모티프) |
| 4 | 첫 번째 도구 / watch 스킬 | 먼저 클로드 코드의 watch 스킬. 깃허브 별이 2만 개 넘어요. | 코드 칩 `/watch` + 별 숫자 카운트업 0→20,150 + 작은 글씨 "2026.11 기준" |
| 5 | 1단계 / 클로드가 본다 | 쇼츠 링크를 주면 1초마다 화면을 캡처하고 자막까지 읽어요. | v1 2장면 재사용 (단계 칩 1 활성 + 프레임 카드 누적) |
| 6 | 2단계 / 설계서로 정리 | 클로드가 색, 자막, 장면 순서를 설계서 한 장으로 정리해요. | v1 3장면 재사용 |
| 7 | 두 번째 도구 / HyperFrames | 다음은 HyperFrames. HTML 코드로 영상을 만드는 도구예요. | 코드 칩 + `<html>` → 필름 아이콘 변환 연출 |
| 8 | 3단계 / 안티그래비티가 만든다 | 안티그래비티가 설계서를 받아 영상을 만들고 목소리까지 입혀요. | v1 4장면 재사용 + 스피커(음파) 아이콘 추가 |
| 9 | 역할 분담 / 지시 vs 제작 | 클로드는 지시하고 검수하고, 안티그래비티는 만들어요. | 좌우 비교 패널 + 가운데 vs (STYLE_SPEC 모티프) |
| 10 | 주의할 점 / 스타일만 참고 | 주의할 점. 스타일만 참고하고, 원본 대본과 음악은 쓰지 마세요. | 체크리스트 카드: 초록 "색·레이아웃·템포" / 빨강 "대본·음악·영상" |
| 11 | 지금 이 영상도 / 이렇게 만들었어요 | 지금 보시는 이 영상도 이렇게 만들었어요. | v1 5장면 재사용 |

- 실제 회사 로고 이미지 금지 (텍스트·일반 도형만). 구독/댓글 CTA 장면 없음.

## 음성
- v1과 동일: edge-tts `ko-KR-SunHiNeural`, `+10%`, WordBoundary 타임스탬프, 장면 끝 0.3초 여유.

## 렌더링
- 1080×1920, 30fps, MP4, `--workers 2` (코어 50% 이하)
- 산출: `pilot\out\pilot_v2.mp4` — **v1 파일은 덮어쓰지 말 것**
- v1 소스를 수정해야 하면 `pilot\v2\` 로 복사 후 작업하거나, v1 결과물이 그대로 재현 가능한 상태를 유지할 것

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

## 완료 증거
`pilot\REPORT_v2.md`:
- 장면별 시작~끝 시간 표, 총 길이
- ffprobe 요약 (해상도, 길이, 용량, 오디오 유무)
- 렌더 시간, 워커 수
- v1 결함 2개 수정 방법
- `npx hyperframes check` 결과
- **각 장면 중간 시점 프레임 PNG 11장**을 `pilot\out\v2_frames\scene_01.png` … `scene_11.png` 로 저장 (Claude 검수용)

## 성공/실패 기준
- pilot_v2.mp4가 1080×1920, 38~55초, 음성 포함이면 succeeded. 생성 실패 시 failed + 오류 원문.
- 완료 시 반드시 아래 형식으로 worker_done 전송 (taskId·dispatchId 누락 금지 — v1 때 누락으로 거절됨).
