# 작업 사양: ACT6 — "영수증 결투" 산책로 버전 완성 (생성 3컷 + 편집 + 음악)

션 승인 (2026-11-17): **C1·C3·C4 생성, 합계 한도 234, run 1회.** 3D 세트장 배경은 사용하지 않는다(BG-WALK 산책로). C2는 이미 있는 영상을 사용한다.

에피소드: `C:/Ai_Coding/apps/studio/episodes/2026-11-17_action-duel/`

## 절대 규칙
- `dreamina-canvas`를 직접 호출하지 않는다. 생성은 `C:/Ai_Coding/apps/studio/tools/pipeline/studio_run.py`로만 한다.
- `run`은 아래 3단계 명령으로 **정확히 1회만** 실행한다.
  - 실패하거나 일부만 성공하거나 결과가 애매하면 다시 실행하지 않는다. `resume`(조회 전용)만 허용한다. 그래도 안 되면 멈추고 보고한다.
- C2는 다시 생성하지 않는다. `state.json`은 직접 수정하지 않는다.
- 수정 가능: 이 에피소드 폴더 안만. `job.json`(프롬프트 점검 수정만), `REVIEW.md`, `edit-plan.json`, `src/`, `out/`
- `sound/` 폴더는 읽기만 한다.
- 다른 폴더(tools/pipeline 코드, works/, 다른 에피소드, 스킬 폴더)는 수정 금지.

## 1단계 — 프롬프트 점검 (0크레딧)
- `C:/Ai_Coding/apps/studio/.agents/skills/studio-script-to-flow/SKILL.md`를 읽는다.
- `job.json`의 C1·C3·C4 프롬프트를 아래 기준으로 점검한다.
  - 한 컷에 핵심 동작 하나
  - 인물 외형 문구가 세 컷 모두 동일
  - 글자 금지 문장 있음
  - "배경음악 없음" 문장 있음
  - 화면 좌우 축 유지: 아름은 화면 왼쪽, 한조교는 오른쪽에서 시작
- 고칠 것이 있으면 최소한만 고치고, 고친 내용을 `REVIEW.md`에 적는다. C2 항목은 건드리지 않는다.
- 이어서 검사와 견적을 돌린다.
  ```
  cd C:/Ai_Coding/apps/studio/tools/pipeline
  python studio_run.py check ../../episodes/2026-11-17_action-duel
  python studio_run.py quote ../../episodes/2026-11-17_action-duel --shots C1,C3,C4
  ```
  - 합계가 234가 아니면 멈추고 보고한다.

## 2단계 — 생성 (한도 234, 1회)
```
python studio_run.py run ../../episodes/2026-11-17_action-duel --shots C1,C3,C4 --ceiling 234
```
- 일부 컷이 서버 오류로 실패하면(예: 20114 음악 저작권 차단) 그 컷은 빼고 진행한다. `REVIEW.md`에 실패 사유를 적는다. 다시 생성하지 않는다.

## 3단계 — 후처리 (0크레딧)
성공한 컷마다(C2는 `C2_fix.mp4`가 이미 있음):
```
ffmpeg -y -i src/assets/clips/<ID>_raw.mp4 -map 0:v -map 0:a -c:v copy -af loudnorm=I=-16:TP=-1.5 -c:a aac -b:a 192k src/assets/clips/<ID>_fix.mp4
ffmpeg -y -i src/assets/clips/<ID>_fix.mp4 -vf "fps=2,scale=480:-1,tile=4x3" -frames:v 1 out/previews/<ID>_sheet.png
```
- 시트를 직접 보고 컷마다 `REVIEW.md`에 기록한다.
  - 인물 수, 얼굴·의상, 결재판·영수증, 동작, 글자 유무
  - 각 컷에서 쓸 구간(초)

## 4단계 — 편집 (0크레딧)
- `C:/Ai_Coding/apps/studio/.agents/skills/studio-video-editing/SKILL.md`를 읽고 따른다.
- 순서: C1 → C2 → C3 → C4 (실패한 컷은 빼고)
- 컷마다 in/out을 고른다.
  - 편집 길이 목표: C1 4.5초, C2 5초, C3 5초, C4 5초
  - 기준: 동작 시작 직전과 동작 직후를 남기고, 멈칫하는 대기나 이상한 프레임은 잘라낸다.
  - 근거는 프레임 시트로 판단한다.
- 영상: 1280×720 lanczos, 30fps, 하드컷, 끝 0.6초 페이드아웃
- 오디오:
  - 클립 원음(효과음)은 컷 경계에 20ms 페이드
  - 음악: `C:/Ai_Coding/apps/studio/episodes/2026-11-10_mugi-yeo/src/assets/audio/run-amok.mp3`, -14dB, 페이드 인 0.3초, 끝 0.8초 페이드
  - 효과음과 음악을 `amix(normalize=0)`로 섞은 뒤, 전체에 `loudnorm I=-16 TP=-1.5`를 **1회만** 적용한다.
  - 견본: `../2026-11-17_action-duel-3d/edit-plan-c1b-c2.json` (같은 방식)
- 출력: `out/duel_v1.mp4`
- `edit-plan.json`에 다음을 기록한다.
  - 소스, in/out, 순서, 음악, 출처 표기
  - 음악 출처 원문: "Run Amok" Kevin MacLeod (incompetech.com), Licensed under Creative Commons: By Attribution 4.0 License http://creativecommons.org/licenses/by/4.0/
- 검증:
  - ffprobe로 길이·해상도·오디오 스트림 확인
  - ebur128로 LUFS 측정
  - `out/previews/duel_v1_sheet.png` (fps=1, tile)

## 5단계 — 기록
`REVIEW.md`에 다음을 기록한다.
- 단계별 결과, 견적과 실제 차감, submit ID
- "**청취·시청 미검증 — 션 판정 대기**" (워커가 합격을 선언하지 않는다)
- `## 작업 기록` 표에 한 줄씩 추가:
  - S5 영상 생성: 담당 제미나이
  - S6 편집: 담당 제미나이

## 완료 보고에 붙일 것
1. check, quote, run 출력 전체
2. `spend.log` 마지막 5줄
3. 컷별 사용 구간 표
4. `out/duel_v1.mp4`의 ffprobe 결과와 LUFS
5. 에피소드 폴더 밖에서 바뀐 파일이 없다는 확인
