# HyperFrames 쇼츠 시안 v3 완료 보고서 (`REPORT_v3.md`)

- **상태**: `succeeded` (1080×1920, 30fps, 47.40초, 11장면, v2 동일 대본·음성·타이밍 재사용, `STYLE_SPEC_B.md` 밝은 만화·마스코트 진행형 스타일 B 전면 적용)
- **산출물 경로**:
  - 최종 영상: [`C:\Ai_Coding\scratch\video-skill\pilot\out\pilot_v3.mp4`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/pilot_v3.mp4) (v1·v2 소스 및 영상 무수정 보존)
  - v3 프로젝트 소스: [`C:\Ai_Coding\scratch\video-skill\pilot\v3\index.html`](file:///C:/Ai_Coding/scratch/video-skill/pilot/v3/index.html), [`v3/build_composition.py`](file:///C:/Ai_Coding/scratch/video-skill/pilot/v3/build_composition.py), [`v3/regroup_captions.py`](file:///C:/Ai_Coding/scratch/video-skill/pilot/v3/regroup_captions.py), [`v3/tts_timestamps.json`](file:///C:/Ai_Coding/scratch/video-skill/pilot/v3/tts_timestamps.json)
  - 검수용 11장면 프레임 PNG: [`C:\Ai_Coding\scratch\video-skill\pilot\out\v3_frames\scene_01.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_01.png) ~ [`scene_11.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_11.png)

---

## 1. `ffprobe` 요약 및 원문 근거 (v2와 동일 길이·해상도·오디오 검증)

- **파일 경로**: [`C:\Ai_Coding\scratch\video-skill\pilot\out\pilot_v3.mp4`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/pilot_v3.mp4)
- **해상도**: `1080×1920` (9:16 세로형, H.264 High Profile, `yuv420p`)
- **프레임레이트 / 총 프레임**: `30 fps` (`30/1`), `1,422 frames` (v2와 동일)
- **재생 길이**: `47.400000초` (`47.40초` — v2 `47.400000초`와 오차 `0.000초`로 100% 일치, 타임라인 기준 `47.381초`)
- **파일 용량**: `6,727,671 bytes` (약 `6.42 MiB` / `6.73 MB`)
- **오디오 유무**: **포함** (`AAC LC`, `48,000 Hz`, `stereo (2ch)`, `171.9 kbps`, `2,223 frames`, v2 음성 파일 무재생성 그대로 재사용)

### `ffprobe` JSON 출력 발췌
```json
{
  "streams": [
    {
      "index": 0,
      "codec_name": "h264",
      "profile": "High",
      "codec_type": "video",
      "width": 1080,
      "height": 1920,
      "display_aspect_ratio": "9:16",
      "pix_fmt": "yuv420p",
      "r_frame_rate": "30/1",
      "avg_frame_rate": "30/1",
      "duration": "47.400000",
      "bit_rate": "956227",
      "nb_frames": "1422"
    },
    {
      "index": 1,
      "codec_name": "aac",
      "profile": "LC",
      "codec_type": "audio",
      "sample_rate": "48000",
      "channels": 2,
      "channel_layout": "stereo",
      "duration": "47.400000",
      "bit_rate": "171967",
      "nb_frames": "2223"
    }
  ],
  "format": {
    "filename": "C:\\Ai_Coding\\scratch\\video-skill\\pilot\\out\\pilot_v3.mp4",
    "nb_streams": 2,
    "format_name": "mov,mp4,m4a,3gp,3g2,mj2",
    "duration": "47.400000",
    "size": "6727671",
    "bit_rate": "1135471"
  }
}
```

---

## 2. 렌더 시간, 워커 수 및 `npx hyperframes check` 결과

- **적용한 렌더 워커 수**: `--workers 2` (`30fps`, `1080×1920`)
- **렌더 소요 시간**:
  - HyperFrames 파이프라인 내부 계측: **`167.6초` (`2m 47.6s`)** (`compile 2.9s`, `audio 8.3s`, `probe 0.5s`, `setup 8.3s`, `capture 2m 3.7s`, `encode 28.1s`, `assemble 2.3s`)
  - 외부 프로세스 Wall-clock 총 소요 시간: **`179.53초`**
- **`npx hyperframes check` 결과**: 전 항목 **0 errors, 0 warnings** 통과 (`97/97 text checks pass WCAG AA`)

```text
Lint
  ◇ 0 errors, 0 warnings

Runtime
  ◇ 0 errors, 0 warnings

Layout
  ◇ 0 issues across 9 sample(s)

Motion
  ◇ 0 errors, 0 warnings

Contrast
  ◇ 97/97 text checks pass WCAG AA

Craft
  ◇ 0 errors, 0 warnings

Audio
  ◇ 0 errors, 0 warnings

Snapshots
  ◇ disabled

◇  Check passed
Report: C:\Ai_Coding\scratch\video-skill\pilot\v3\.hyperframes\artifacts\checks\49512ef6-5db6-439a-845f-7efeccbdc14f.json
Revision: dbf2eddc-c215-421b-a3a6-fc548f803471 (recorded-revision)
```

---

## 3. 마스코트 디자인 설명 (1~2줄)

- 원본 채널 캐릭터를 복제하지 않고, **상단에 2개의 필름 릴 귀와 빨간 REC 램프가 달린 둥근 빈티지 필름 카메라 몸통 + 막대 팔다리 + 굵은 검정 외곽선(4.5~5.5px)** 구조의 독자적인 순수 SVG 마스코트를 새로 제작하여 우하단에 상주시켰습니다.
- 장면 맥락에 맞춰 **손 흔들기(`wave`: 1·9·11장면), 기본 안내(`default`: 2·5·6·7·8장면), 놀람·강조(`surprised`: 3·4·10장면)**의 3가지 표정·팔 동작 포즈로 교체됩니다.

---

## 4. 스타일 B 적용 요약 (배경 · 진행바 · 구 단위 자막 · 비주얼 카드)

| 장면 # | 배경 단색 (방사형 그라데이션) | 상단 진행바 (`①보기 ②설계 ③제작`) | 구(句) 단위 자막 (문장부호 `,` `.` 경계 엄수) | 노랑(`#F6C945`) 핵심어 | 마스코트 포즈 |
|:---:|---|---|---|---|---|
| **1** | 하늘 `#8EC9EE` | 모두 빈 원 | `쇼츠 만들기,` / `이제 AI 둘한테 나눠 맡겨요.` | `AI 둘` | 손 흔들기 (`wave`) |
| **2** | 노랑 `#F6D466` | 모두 빈 원 | `따라 하고 싶은 쇼츠가 있어도,` / `화면 하나하나 뜯어보긴 힘들잖아요.` | `뜯어보긴` | 기본 (`default`) |
| **3** | 코랄 `#EE8F86` | 모두 빈 원 | `주의할 점 하나는 끝에 알려 드릴게요.` | `주의할 점` | 놀람 (`surprised`) |
| **4** | 연두 `#9ED98A` | 모두 빈 원 | `먼저 클로드 코드의 watch 스킬.` / `깃허브 별이 2만 개 넘어요.` | `watch 스킬`, `2만 개` | 놀람 (`surprised`) |
| **5** | 하늘 `#8EC9EE` | ① 현재 | `쇼츠 링크를 주면` / `1초마다 화면을 캡처하고 자막까지 읽어요.` | `1초마다` | 기본 (`default`) |
| **6** | 보라분홍 `#D98FD6` | ① 완료 · ② 현재 | `클로드가 색, 자막,` / `장면 순서를 설계서 한 장으로 정리해요.` | `설계서` | 기본 (`default`) |
| **7** | 노랑 `#F6D466` | ①② 완료 | `다음은 HyperFrames.` / `HTML 코드로 영상을 만드는 도구예요.` | `HyperFrames` | 기본 (`default`) |
| **8** | 연두 `#9ED98A` | ①② 완료 · ③ 현재 | `안티그래비티가 설계서를 받아` / `영상을 만들고 목소리까지 입혀요.` | `목소리` | 기본 (`default`) |
| **9** | 하늘 `#8EC9EE` | 전부 완료 | `클로드는 지시하고 검수하고,` / `안티그래비티는 만들어요.` | `지시`, `만들어요` | 손 흔들기 (`wave`) |
| **10** | 코랄 `#EE8F86` | 전부 완료 | `주의할 점.` / `스타일만 참고하고,` / `원본 대본과 음악은 쓰지 마세요.` | `스타일만`, `쓰지 마세요` | 놀람 (`surprised`) |
| **11** | 노랑 `#F6D466` | 전부 완료 | `지금 보시는 이 영상도 이렇게 만들었어요.` | `이렇게` | 손 흔들기 (`wave`) |

---

## 5. 장면 중간 시점 프레임 PNG 11장 목록

- [`pilot/out/v3_frames/scene_01.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_01.png) (`t = 1.829s`, 426,007 bytes)
- [`pilot/out/v3_frames/scene_02.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_02.png) (`t = 5.952s`, 476,798 bytes)
- [`pilot/out/v3_frames/scene_03.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_03.png) (`t = 9.654s`, 407,662 bytes)
- [`pilot/out/v3_frames/scene_04.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_04.png) (`t = 13.604s`, 389,284 bytes)
- [`pilot/out/v3_frames/scene_05.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_05.png) (`t = 18.390s`, 431,772 bytes)
- [`pilot/out/v3_frames/scene_06.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_06.png) (`t = 22.957s`, 371,571 bytes)
- [`pilot/out/v3_frames/scene_07.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_07.png) (`t = 28.010s`, 478,275 bytes)
- [`pilot/out/v3_frames/scene_08.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_08.png) (`t = 32.995s`, 462,850 bytes)
- [`pilot/out/v3_frames/scene_09.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_09.png) (`t = 37.306s`, 390,575 bytes)
- [`pilot/out/v3_frames/scene_10.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_10.png) (`t = 41.799s`, 438,820 bytes)
- [`pilot/out/v3_frames/scene_11.png`](file:///C:/Ai_Coding/scratch/video-skill/pilot/out/v3_frames/scene_11.png) (`t = 45.808s`, 437,040 bytes)
