감독 개요 (코스 10단계)
장편 영화는 제작물입니다. 코스의 야간 영화 뒤에 있는 개요는 비디오를 설명하지 않습니다. 대신 제작진을 고용합니다: 모든 결정을 검증할 로그라인, 참고 자료, 도구와 예산, 캐릭터 바이블, 비트 시트, 화면 내 텍스트 규칙, 게이트, 비평 루프, 결과물. 이 스킬은 사용자의 아이디어를 해당 개요로 변환하고 게이트를 통해 제작을 실행합니다. 챕터 없이 약 45초 이하의 클립에는 /motion-studio:motion-reel을 대신 사용하세요(해당 스킬이 더 긴 영화를 이 스킬에 넘기는 동일한 임계값입니다).
한 번 표시되는 인수:
이 스킬의 파일은 ${CLAUDE_SKILL_DIR}에 있습니다 (개요 템플릿은 ${CLAUDE_SKILL_DIR}/assets/brief-template.md, assets/brief-template.md).
이 스킬의 비용
max 노력으로 실행됩니다: motion-studio 스킬 중 가장 깊은 추론과 가장 높은 토큰 사용량. 계획 실수는 수시간의 자율 작업 동안 누적되므로, 계획 단계에서 비용이 투자됩니다. 시작 전에 사용자와 기대치를 설정하세요. 코스에서 보고된 데이터 포인트: 야간 뮤직비디오는 약 12시간이 소요되었고 Max 플랜 사용량의 약 80%와 추가 $75의 이미지/비디오 API 크레딧을 사용했습니다. 45초 핸드 페인트 단편은 163번의 모델 호출, 6270만 토큰(96% 캐시 읽기), API 목록 가격 기준 약 $34, 약 6.75시간이 소요되었습니다. 나머지 부분은 더 저렴하게 유지하세요: 챕터 애니메이터는 자체 노력(high)으로 실행되고, 수정 및 재렌더링은 중간 노력 작업입니다. 예산이 중요한 경우 계획이 승인된 후 /model로 세션 노력을 낮추라고 사용자에게 알리세요.
1. 입력 수집
메인 세션만 사용자에게 질문할 수 있습니다 (서브 에이전트는 불가). 사용자가 긴 개요를 받아쓰기한 경우 다시 묻지 말고 구문 분석하세요. 그렇지 않으면 한 번에, 하나의 메시지로 누락된 항목을 물어보세요:
| 입력 | 이유 |
|---|---|
| 로그라인, 그리고 시청자가 마지막에 느껴야 할 감정 | 모든 결정이 이에 대해 검증됨 |
| 러닝타임, 포맷, 게시 위치 | 챕터 수, 렌더링 시간, 안전 영역 |
| 참고 자료 (비디오, 프레임, 이미지 라이브러리, 이전 저장소) | 차용할 문법, 피해야 할 콘텐츠 |
| 음악: 트랙 (및 라이선스) 또는 "합성" | 모든 것이 고정되는 비트 그리드 |
| 경로 (A 기본값; B는 Remotion/HyperFrames를 명명한 경우에만; C 생성-후-추적) 및 변수명으로 API 키 | 도구 및 지출 |
| 예산: 모델 사용량, 유료 API, 실제 소요 시간 | 생성 중단 시점 |
| 모드: PLAN FIRST 또는 GO | 계획 후 중단 여부 |
2. docs/brief.md 작성
studio.json이 없으면 먼저/motion-studio:studio-init실행 (--duration,--bpm,--formats설정).${CLAUDE_SKILL_DIR}/assets/brief-template.md를docs/brief.md로 복사. 파트 A를 사용자의 답변으로 채우고, 파트 B는 그대로 유지.- 일치하도록
studio.json업데이트 (제목, 러닝타임, fps, bpm, 포맷, 브랜드,loop). - PLAN FIRST: 채워진 개요를 표시하고 사용자가 승인할 때까지 중단. GO: 사용자를 위해 내린 모든 결정을
docs/decisions.md에 기록하고 계속 진행.
3. 게이트 1: 계획 문서
| 파일 | 내용 | 작성자 |
|---|---|---|
docs/style_guide.md | 팔레트, 타이포그래피, 템포, 전환, 텍스처, 금지된 룩 | 참고 자료로부터 style-analyst 서브 에이전트 (/motion-studio:reference-style), 또는 직접 |
docs/STORYBOARD.md | 아이디어, 캐스트, 연결 요소, 시간과 전환이 포함된 샷 단위 챕터 | motion-director 서브 에이전트, 또는 직접 |
docs/shotlist.md | 비트 그리드(마디) 위의 모든 샷, 카메라, 텍스트, SFX | motion-director |
| 챕터 계획 (STORYBOARD 내) | 다운비트 위의 챕터 경계, 챕터별 담당자 | 직접 |
타이밍 전에 음악을 측정하거나 합성하세요 (/motion-studio:sound-design): 챕터 및 샷 시간은 추측이 아닌 grid.bar(n) 값입니다. 챕터는 8~30초로 유지하여 한 서브 에이전트가 한 세션에서 하나를 완료하고 확인할 수 있도록 하세요. motion-director는 docs/**만 작성합니다 (역할 가드 훅이 강제).
4. 게이트 2: 리그 및 가이드
- 챕터 애니메이터가 시작하기 전에 프로젝트의
docs/에 있는 템플릿에서docs/ANIMATION_GUIDE.md를 작성하여 모든 챕터가 동일한 스타일로 코딩하도록 합니다: 챕터 작동 방식, 소유권, 레이아웃 및 예약된 대역, 공유 API, 공유 요소, 페인트 시간 예산이 있는 스타일 규칙, 정확한 확인 명령어. - 직접
film/scenes/shared_<name>.js에 공유 요소 (히어로 캐릭터, UI 키트, 팔레트 헬퍼)를 빌드합니다. 챕터 애니메이터는 이를 가져오고 절대 편집하지 않습니다. 모든 상태의 모든 요소에 대한 스틸을 렌더링합니다. - 챕터 진행 중에도 필름이 처음부터 끝까지 렌더링되도록 각 챕터를 스텁 처리합니다:
// film/scenes/ch03_build.js (메인 세션이 작성한 스텁; 챕터 애니메이터가 샷을 대체)
import { chapter } from '../../lib/timeline.js';
export const BARS = [12, 20]; // docs/STORYBOARD.md에서 마디 단위 범위 (null = 끝까지)
export default function ch03(ctx) {
const FROM = BARS[0] === 0 ? 0 : ctx.grid.bar(BARS[0]);
const TO = BARS[1] == null ? ctx.dur : ctx.grid.bar(BARS[1]);
return chapter({ name: 'ch03_build', from: FROM, to: TO, shots: [], cues: [] }); // 샷 없음 = 플레이스홀더 카드
}
film/film.js를 한 번 연결합니다.buildFilm은scenes내부의chapter()결과를 받아들이고, 씬을 평탄화하고 큐를 병합합니다. 필름 전체 레이어 (자막, 이음새 전환)는 팩토리의overlays: Scene[]에 들어갑니다: 모든 씬 이후에, 배열 순서대로, 동일한from <= t < to규칙 (필름의 마지막 프레임에서 끝 포함)으로 그려지며, 절대 샷으로 계산되지 않으므로 스틸 레이블, 비평 샷 경계 및 미리보기 스트립 목록은 챕터 샷만 나열합니다. 챕터 코드는 그대로 유지됩니다. 챕터draw함수를 래핑하거나 패치하지 마십시오. 중첩 배열,null및chapter()결과도overlays에서 허용되므로 챕터는 자체 오버레이 씬을 제공할 수 있습니다. 일반 씬을 쌓으려면 씬에layer번호 (기본값 0)를 부여합니다: 씬은(layer, from)순서로 그려집니다.
import { defineFilm, scene } from '../lib/timeline.js';
import ch01 from './scenes/ch01_hook.js';
import ch02 from './scenes/ch02_problem.js';
import ch03 from './scenes/ch03_build.js';
const CHAPTERS = [ch01, ch02, ch03];
export default defineFilm((ctx) => ({
scenes: CHAPTERS.map((make) => make(ctx)),
overlays: [
scene(0, ctx.dur, 'captions', (g, lt, c) => { /* 필름 전체 자막: 필름 시간 c.t로부터 그림 */ }),
// 전환이 필요한 각 챕터 이음새당 하나의 짧은 씬, 그리드에서 시간 측정
scene(ctx.grid.bar(12) - 0.2, ctx.grid.bar(12) + 0.2, 'seam-ch02-ch03', (g, lt, c) => { /* 와이프 또는 플래시 */ }),
],
cues: (grid) => [{ t: grid.bar(0), type: 'hit' }], // 필름 레벨 큐; 챕터 큐는 자동으로 병합
}));
5. 챕터 분산 처리
챕터당 하나의 chapter-animator 서브 에이전트 (motion-studio:chapter-animator)를 여러 개 병렬로 실행합니다. 각각에게 파일 (film/scenes/chNN_<name>.js), 범위 (스텁의 BARS 내보내기 및 확인 명령어를 위한 동일한 초 단위 범위), STORYBOARD 섹션, 그리고 "docs/ANIMATION_GUIDE.md를 따르세요"를 브리핑합니다. 역할 가드 훅은 챕터 애니메이터가 film/scenes/**만 작성하도록 허용합니다 (film/scenes/shared_* 제외, 이는 챕터 애니메이터에게 읽기 전용이며 대신 공유 파일 버그를 보고합니다) 및 out/check/**. 각각은 보고서를 반환합니다: 구축한 내용, 스틸 확인, 알려진 문제, 공유 파일에서 찾은 버그. 공유 파일을 직접 수정하고, 전체 필름 확인을 다시 실행하며, 보고서에 문제가 표시되면 챕터를 다시 브리핑합니다.
챕터 범위는 마디 단위이며, 챕터의 팩토리 내부에서 ctx.grid로 계산되므로 연속된 챕터는 항상 만나고 측정된 트랙을 따릅니다. 샷 시간은 그리드에서 가져온 절대 필름 초입니다 (shots: [{ at: grid.bar(13), name: 'assemble', draw }, ...]); 각 샷은 다음 샷의 at까지 실행되며, draw(g, lt, c)는 샷 시작부터 lt를 받습니다. 챕터 범위를 벗어난 샷은 chapter()가 예외를 발생시키고 필름 로딩을 중지합니다 (예: 리터럴 TO = 4는 측정된 트랙이 첫 번째 다운비트를 2.0초에 배치하면 grid.bar(1) = 4.003초의 샷을 거부합니다).
6. 게이트 3~8
| 게이트 | 수행 | 확인 |
|---|---|---|
| 3 스틸 | node tools/stills.mjs --shots (샷당 하나의 스틸) | 비평 라운드 (/motion-studio:critique-loop) |
| 4 애니메틱 | npm run animatic (절반 해상도, 30fps, 블러 없음) 실제 또는 플레이스홀더 트랙 사용 | 템포: 모든 읽기가 다음 비트 전에 도착 |
| 5 가장 어려운 샘플 | 가장 어려운 2~4초에 대해 node tools/render.mjs --from A --to B --out out/check | node tools/critique.mjs --strip-at <t>; 결정론; 동기화 |
| 6 전체 패스 | 플레이스홀더 없음 (node tools/stills.mjs --shots의 샷 레이블이 /placeholder로 끝나지 않음) | 전체 필름에 대한 비평 라운드 |
| 7 폴리싱 및 사운드 | /motion-studio:sound-design: 스코어 또는 비트, 큐, SFX, 음성 | 동기화 메트릭, 사운드 축 |
| 8 최종 | npm run build | 개요 B6의 완료 조건 |
장편 필름은 재개 가능한 세그먼트로 렌더링됩니다: node tools/render.mjs --format all --final --chunk 10은 out/<fmt>/.parts/seg_<a>_<b>.mp4를 작성하고 중단 후 재실행 시 완료된 세그먼트를 건너뜁니다. 긴 렌더링은 세션을 차단하지 않고 백그라운드 (Bash 도구의 run_in_background, 또는 폴링하는 로그 파일)에서 실행하고, 2분 이상 포그라운드에서 기다리지 마십시오. 60fps 및 4개 서브프레임에서 세 가지 포맷에 대해 필름 1초당 약 20초의 실제 시간을 예산하십시오 (2분 필름은 약 40분 렌더링). /motion-studio:motion-reel의 파이프라인 런북에는 패턴과 다른 모든 명령어의 예상 시간이 있습니다. 챕터 애니메이터 또는 다른 서브 에이전트는 자신이 시작한 명령어가 계속 실행 중인 동안 반환해서는 안 됩니다.
7. 경로 C: 생성-후-추적 (선택 사항)
개요가 경로 C를 선택하고 키 (변수명으로: .env의 FAL_KEY, ELEVENLABS_API_KEY)와 예산을 나열하는 경우에만. 비디오 모델은 하드 코딩하기 어려운 물리, 타이밍 및 얼굴을 제공합니다. 코드 레이어는 사용자가 소유하는 일관된 모양을 제공합니다. 시청자는 코드 레이어를 봅니다.
- 사용자가 선택한 서비스를 사용하여 자체 문서를 따라 캐릭터 시트와 기본 샷을 생성합니다. 모든 결과를 매니페스트 행(서비스, 모델, 프롬프트, 시드, 비용, 라이선스)과 함께
refs/base/아래에 저장합니다. 예산에서 중단합니다. - 프레임을 추출하여 연구:
node tools/refs.mjs extract refs/base/shot01.mp4 --every 0.1 --out refs/base/shot01. - 해당 타이밍 위에 코드로 각 샷을 다시 그립니다 (프레임을 보고 스프링 및 트랙으로 모션 재구성). 기본 푸티지는 렌더링 시 네트워크에서 로드되지 않습니다. 샷이 기본 프레임을 합성하는 경우
setup()의 로컬 파일에서 로드합니다. - 동기화 확인: 동일한 시간에 기본 프레임 옆에 있는 코드 레이어의 스틸과 그리드의 오디오 큐. 드리프트가 있는 샷에 대해 단계를 다시 실행합니다.
키: 절대 인쇄, 에코, 로그 또는 붙여넣지 마십시오. 도구는 .env를 직접 읽습니다. 프롬프트와 문서에 변수명을 명시하십시오.
8. 완료 조건 및 보고서
개요의 B6이 계약입니다: 전달된 MP4에서 음량 -14 LUFS ±0.5 및 ≤ -1 dBTP, 각 축이 >= 8이고 P0가 없는 최소 3회의 비평 라운드 (npm run gate), 재렌더링 시 동일한 프레임 제공 (비평 결정론 검사 및 두 번의 --hash 렌더링에서 동일한 framesDigest 값), 모든 포맷에서 정확한 길이와 프레임, 모든 결과물 존재 (npm run deliver는 대부분을 확인하고 docs/production.json을 작성). B7 보고서로 마무리: 결과물, 라운드별 점수, 실제 지출, 알려진 결함, 다음에 개선할 사항.
크레딧: 개요 골격은 코스의 10단계를 따릅니다. 채우기/유지하기 분할, PLAN FIRST 대 GO 및 완료 조건은 @pradeepXkapoor의 공개 템플릿 패턴을 따릅니다 (표현 변경). 승인 게이트는 athemeroy/awesome-opus-5-5-videos의 docs/production-brief.md에서 적용되었습니다 (CC BY 4.0). 가이드-더하기-스토리보드 서브 에이전트 패턴은 JohnHeibel/PDoomVideo에서 연구되었습니다 (아이디어만, 텍스트 재사용 없음).
다음: 게이트 3 이후 매번 /motion-studio:critique-loop, 그 다음 /motion-studio:ship-formats로 전달.