다중 동영상 변형 (multi-video-variants)은(는) 무엇을 하나요?
승인된 마스터 하나를 N개의 출력물로 변환하며, 어떤 파일이 어떤 소스 상태에서 왔는지 추적 제어를 유지합니다. 이 스킬은 변형 매트릭스, 마스터 고정, 재레이아웃 복사본, 공유 믹스, 파일명, 한 번에 하나씩 렌더링하는 대기열, 에이전트 감독 규칙, 그리고 매니페스트 게이트를 소유합니다. 마스터를 디자인하지 않으며(타입 스킬이 담당), 개별 파일 QA(render-qa-deliver)를 대체하지 않습니다.
이 파일의 다른 모든 규칙보다 우선하는 규칙
- 마스터 우선, 그 다음 고정. 파생물은 자체 전체 QA를 통과하고
manifest_check.py freeze로 기록된 마스터로만 만들어집니다. 나중에 수정이 필요하면 마스터에서 수정하고change로 기록한 뒤, 같은 라운드의 모든 복사본에 적용하며, 모든 파생물을 다시 렌더링하고 다시 기록합니다. 복사본만 수정하는 것은 금지됩니다. - 재레이아웃, 절대 크롭 금지. 각 종횡비는 마스터 소스의 복사본(
hf_9x16/,hf_1x1/...)이며, 자체 캔버스, 안전 영역, 타입 스케일, 자막 레일, 카메라 키, 얼굴 중앙 정렬을 가집니다. 렌더링된 마스터를 FFmpeg으로 크롭하거나 스케일하는 것은 변형이 아닙니다. - 하나의 믹스. 재레이아웃과 후크 변형은 동일한
cues.js와 동일한assets/mix.wav바이트를 사용하며, 해당 파일 하나에서 먹싱됩니다. 오디오는 변형별로 재구축되지 않습니다. 자체 믹스가 정말로 필요한 변형(무음, 자체 음성 해설, 재컷 길이)은 매니페스트에 이유를 명시하여 선언합니다. - 전체 머신에서 한 번에 하나의 무거운 작업(렌더,
check, 매트, ASR, Blender)은render_lock하에 실행합니다. 병렬 작업은 무겁지 않은 작업(레이아웃, 사양, QA 읽기)으로 제한됩니다. 최대 4개의 에이전트가 병렬로 실행되며, 각 에이전트는 최대 2개의 하위 에이전트를 가집니다. - "준비 완료"는 계산되며, 주장되지 않습니다. 이 단어는
manifest_check.py check가 0으로 종료될 때만 사용할 수 있습니다. 시간 초과, 빈 폴더, 해시 누락,qa: not_run또는 증거 누락은차단됨/증거불충분이며, 절대통과가 아닙니다. paid-generation-gate없이 유료 작업을 수행하지 않으며, 다른 Claude 세션에 메시지를 보내지 않습니다. 사용자 및 프로젝트 제한이 이 절차보다 우선합니다. 안전 영역, -14 LUFS 및 캔버스는 하우스 프리셋 v1(결정 기본값 Q5)이며, 플랫폼 법칙이 아닙니다.
입력 -> 출력
입력: 승인된 마스터(hf/, PROMPT.md, DESIGN.md, cues.js, assets/mix.wav) 및 인테이크의 변형 매트릭스. 출력: final/<name>_<platform>_<hook>_<aspect>.mp4 x N개, final/manifest.json(최종 파일 + 매니페스트만), _work/qa/<aspect>/<round>/ 아래의 파일별 QA 보고서, _work/agents/<agent>.progress.md, _work/STATE.md(대기열).
파일명: <name>_<platform>_<hook>_<aspect>.mp4, <name>은 소문자 ASCII 슬러그(밑줄 허용), <platform> = meta|tiktok|yt|ig|linkedin|x|all, <hook> = master | hookA | hookA-nomusic | hookA-nocaps, <aspect> = 9x16|4x5|1x1|16x9. 또한 다음 약식 비율 형식도 허용됩니다: <name>_<aspect>.mp4(플랫폼 all, 후크 master, 전달 플레이북에서와 같이). 사용자가 원장에서 요청한 이름은 관례를 무시하고 원장 ID와 함께 기록됩니다(record --name-ledger-id).
절차
| # | 단계 | 수행 작업 | 산출물 |
|---|---|---|---|
| 0 | 인테이크 매트릭스 | 파일당 하나의 원장 행: 종횡비, 플랫폼, 경로(유기적 / 광고 / 스파크), 후크, 버전(전체, 무음, 무자막, 길이), 마스터 종횡비. 늦은 "아마도" 비율: 지금 레이아웃 노트를 작성하여 늦은 요청이 재구축 없이 하나의 에이전트로 처리되도록 함(references/variant-matrix-and-layout.md) | PROMPT.md <inputs>의 매트릭스; 매니페스트의 matrix 목록 |
| 1 | 마스터 게이트 | 마스터 승인됨, render-qa-deliver 전체 프레임 QA 통과, manifest_check.py freeze <project> --hf hf --matrix ... | 고정된 src_hash + mix_sha256 |
| 2 | 재레이아웃 복사본 | 종횡비당 하나의 에이전트가 복사본에서 작업; 동일한 큐와 믹스 사용; 레이아웃 테이블 작성(요소별 변경 사항, references/variant-matrix-and-layout.md); 프리플라이트 0 오류; 후크, 오퍼, 엔드 카드에서 스냅샷 오버레이(--describe false, 호출당 최대 5개 타임스탬프) | hf_<aspect>/, _work/qa/<aspect>/layout.md |
| 3 | 후크 / 버전 변형 | 후크 = 종횡비 복사본의 변수에 바인딩된 하위 구성, 변형당 하나의 행; 먼저 하나의 변형을 테스트(배치 변수는 프로젝트에서 테스트되지 않음); 공유 믹스 먹싱; 무음/무자막 = 선언된 믹스 또는 레이어 변형 | rows.json, 변형 파일 |
| 4 | 대기열 | _work/STATE.md에 렌더 순서 작성(마스터, 각 종횡비, 변형 순); 각 렌더 전에 manifest_check.py stamp; hf_deliver / render_lock run을 통해 한 번에 하나씩 렌더링; 렌더 소유자는 두 번째 무거운 작업을 시작하지 않음 | 잠금 로그, 스탬프 |
| 5 | 기록 | 각 렌더 후: record(해시, 적용된 마스터 수정, 믹스 변형, QA 상태, 최종 파일에서 측정된 음량) | manifest.json |
| 6 | 출력별 QA | frame_qa, caption_qa --band <top>:1450 (9:16), motion_qa(레이아웃이 모션을 변경한 경우), face_center audit(화자 푸티지), qa delivery; 시각 검토 축 1(구성/크롭) 및 4(가독성)만; 축 2-3은 모션이 변경되지 않는 한 상속됨 | 보고서 + 증거 경로 |
| 7 | 준비 게이트 | manifest_check.py check <project> --json이 0으로 종료됨; 사용자에게 소스 해시, QA 상태, LUFS/TP와 함께 파일 목록 표시; 격차를 정직하게 나열 | 준비 완료 보고서 |
| 8 | 학습 | 파일당 타이밍 원장 라인, 받은 편지함에 대한 교훈 | _work/timing_ledger.jsonl |
게이트
상태는 통과 | 실패 | 차단됨 | 해당 없음이며 이유가 포함됩니다. 시간 초과, 빈 샘플 또는 누락된 입력은 차단됨이며, 절대 통과가 아닙니다. 성공적인 도구 호출은 실행 증거이고, 본 렌더는 외관 증거입니다.
| 게이트 | 조건 | 증거 | 거짓인 경우 | 소유자 | 재확인 시점 |
|---|---|---|---|---|---|
| G1 매트릭스 | 모든 출력이 빌드 전에 원장 행(종횡비, 플랫폼, 경로, 후크, 버전)을 가짐 | PROMPT.md 및 매니페스트의 matrix | 지금 누락된 축을 요청; 빌드하지 않음 | 이 스킬 + video-intake | 새로운 비율/변형 요청 시 |
| G2 마스터 고정 | 마스터가 전체 QA 통과; freeze 기록됨; 이전에 시작된 파생물 없음 | 매니페스트 master.src_hash, frozen_utc가 모든 스탬프보다 오래됨 | 파생물 중단; 고정 | 이 스킬 | 마스터 소스 변경 시 |
| G3 재레이아웃 | 각 파생물이 자체 루트 캔버스, 요소별 레이아웃 행, 자체 종횡비의 안전 영역을 가짐; 크롭된 마스터 렌더 없음 | layout.md 행 + 오버레이 스냅샷 + 프리플라이트 0 오류 | 실패한 요소를 재레이아웃; 전체 프레임을 스케일하지 않음 | 종횡비의 에이전트 | 마스터 레이아웃 변경, 새 복사본 |
| G4 공유 자산 | 모든 재레이아웃/후크 복사본에서 cues.* 및 assets/mix.wav가 마스터와 동일함; 후크 변형은 먹싱, 재믹싱 아님 | manifest_check.py check: M035/M041 없음 | 마스터 큐/믹스를 다시 복사; 재렌더링 | 이 스킬 | 마스터 큐 또는 믹스 변경 |
| G5 출력별 QA | 각 파일 qa: pass이며 증거 파일 및 최종 파일의 LUFS -14 +/- 0.5, TP <= -1 (하우스 게이트) | 매니페스트의 qa_evidence 경로, lufs, tp 숫자 | 해당 파일만 수정 및 재렌더링 | render-qa-deliver | 재렌더링 시 |
| G6 무거운 작업 규율 | 정확히 한 번에 하나의 무거운 작업; <= 4개 에이전트, 각각 <= 2개 하위 에이전트, 각각 파일 목록, 출력 파일, 마감일, 진행 파일 보유 | render_lock 로그; _work/agents/*.progress.md mtime | 대기열에 추가, 추가 작업 중단(자체 프로세스 트리만) | 이 스킬 | 각 에이전트 시작 시 |
| G7 매니페스트 준비 | 오래된 / 고아 / 누락 / 렌더 후 변경 모두 없음 | manifest_check.py check 종료 코드 0 | 사용자에게 실패 파일 나열; 오래된 파일 재렌더링 | manifest_check.py | "준비"라고 말하기 전, 변경 후 |
수치 (하우스 프리셋 v1, 2026-10-02 날짜, 세부 사항은 references/house-presets.md)
- 캔버스: 9:16 1080x1920, 4:5 1080x1350, 1:1 1080x1080, 16:9 1920x1080; H.264 SDR yuv420p, AAC 48 kHz, 30 fps 기본값.
- 안전 영역, 주요 텍스트/CTA/로고/가격: 9:16 상단 300 / 하단 672 (y <= 1248) / 왼쪽 140 / 오른쪽 192, 자막 레일 하단 <= y 1450; 16:9 x <= 1824, 상단 54, 하단 162; 4:5 및 1:1 각 측면 54px. 기기에서 확인되지 않음: 오버레이 연습 실행.
- 음량: -14 LUFS 통합 +/- 0.5, 트루 피크 <= -1 dBTP, 최종 파일에서 측정; 믹스 중간 TP <= -1.5.
- 감독: 약 15분마다 하트비트 확인; 20분 동안 응답 없거나 마감일 초과 = 확인, 대체 또는 중지; 약 10분의 침묵마다 사용자에게 상태 줄; 렌더 타임아웃은 측정된 ETA의 3배. (출처: distilled 02 workflow §13.6, 2026-10-01)
결정 규칙
| 경우 | 그렇다면 |
|---|---|
| 파생물이 존재한 후 마스터 수정이 필요한 경우 | 마스터를 수정하고, change로 기록하고, 패치를 모든 복사본에 적용하고, 모두 재렌더링 및 재기록 |
| 복사본에 다른 타이밍이나 큐가 필요한 경우 | 이는 마스터 변경 사항임; 또는 자체 원장 라인이 있는 새로운 편집(재컷)이며, 절대 조용한 포크가 아님 |
| 후크에 다른 음성 대사가 필요한 경우 | 이유와 함께 own-vo를 선언; 다른 모든 변형은 공유 믹스 유지 |
| 비율이 늦게 요청된 경우 | 레이아웃 테이블을 작성하고, 고정된 마스터의 복사본에서 하나의 에이전트를 시작; 마스터를 건드리지 않음 |
| 두 개의 렌더가 동시에 요청된 경우 | 대기열에 추가; 잠금이 결정; STATE.md에 순서 작성 |
| 에이전트가 마감일까지 응답이 없는 경우 | 진행 파일을 확인한 다음, 대체하거나 중지(자체 프로세스 트리만), 그런 다음 render_lock status |
| 최종 폴더에 이전 렌더가 있는 경우 | _work/delivered/v<N>/로 이동; "준비"는 폴더가 매니페스트와 일치할 때까지 차단됨 |
| 사용자가 파일 이름을 지정하는 경우 | 사용자 이름이 우선; --name-ledger-id로 기록하고 platform/hook/aspect 필드를 명시적으로 유지 |
차단된 상태 (보고하고, 우회하지 마십시오)
manifest_check.py 차단됨 또는 증거불충분; from_master가 오래되었거나 마스터 수정이 누락된 파생물; 렌더 후 변경된 소스; 공유 큐 또는 믹스 드리프트; qa가 통과가 아님; 약속된 변형 누락; 계획되지 않은 파일 존재. 어떤 파일, 어떤 코드, 수정 방법을 말하십시오.
각각 실제 시간을 소모하는 함정
늦은 16:9 요청(전체 재레이아웃, 드롭됨); 3.7초 마스터 수정이 1:1에 적용되지 않음; 이전 렌더가 새 렌더 옆에 남아 있고 아무도 표시하지 않음; 마스터 버그를 발견하고 복사본만 수정한 파생물 에이전트; 세 개의 에이전트가 동시에 렌더링(병렬 Blender 작업이 렌더를 두 배로 늘림, 11.5분에서 21.5분, 소유자 노트북); 메타와 틱톡 컷 간의 이름 충돌; 하나의 후크 변형이 조용히 다른 믹스를 운반함. 각 종횡비의 본 연락처 시트는 여전히 필요함: 해시는 얼굴 위의 자막을 볼 수 없음.
참조 (다음 경우 로드)
references/variant-matrix-and-layout.md- 매트릭스 작성, 종횡비 재레이아웃, 후크/무음/무자막/길이 변형.references/manifest-schema.md- 파일 기록,manifest_check.py결과 읽기, 오래된 파생물 수명 주기.references/parallel-and-agents.md- 에이전트 실행, 대기열, 잠금, 하트비트, 중지, 토큰 예산.references/house-presets.md- 캔버스, 안전 영역, 음량 또는 플랫폼 번호를 인용하기 전에 (날짜가 있는 모듈).agent-content/references/platform-specs.md(표준 플랫폼 사실, 다른 곳에서 소유) 및agent-content/playbooks/wf-08-deliver.md(전달 플레이북: 파일명, 매니페스트 규칙) - 내보내기 프리셋 및 플레이북; 숫자가 다르면 표준 파일이 우선하고references/house-presets.md가 업데이트됩니다.- 기타 스킬:
render-qa-deliver(파일별 QA),hebrew-captions-asr(자막 레일),edit-ad-promo(후크 순위),revision-round(종횡비 간 노트),paid-generation-gate. - 스크립트:
scripts/manifest_check.py(--self-check29개 케이스, 종료 코드 0 준비 완료 / 1 차단됨 / 2 증거불충분) 및scripts/test_manifest_check.py(단위 테스트).