scene-studio

AI에게 숏폼 영상 제작을 맡겨 기획부터 발행 메타까지 가는 출발점입니다. Claude Code 또는 Codex로 작업한다는 가정 위에 두 트랙(생성형과 리믹스), 승인 게이트, 라이선스 정책, 파이프라인 성능 정책이 미리 잡혀 있어, AI가 컷과 후크와 라이선스와 속도에서 미끄러지는 자리를 막아 줍니다.

이 페이지는 분기일 뿐입니다. 본인이 어디서부터 시작해야 할지 한 표로 가린 다음, 그 자리로 곧장 넘어가면 됩니다.

어디서부터 시작할지

어떤 분	가야 할 자리
풀타임 개발자가 아닌 분, 터미널이 처음, ffmpeg와 yt-dlp도 처음	비개발자용 매뉴얼
코드는 익숙한데 두 트랙, template filling, 라이선스 게이트가 처음	비개발자용 매뉴얼의 prerequisites부터 first-run까지, 그다음 전문가용 매뉴얼
이미 숏폼 파이프라인을 운영해 봄	전문가용 매뉴얼, architecture부터 곧바로

세 행 중 어느 쪽인지 결정이 안 서면 첫 행을 고릅니다. 비개발자용 매뉴얼은 한 단계당 한 동작 호흡이라, 이미 익숙한 자리는 빠르게 훑고 넘어가도 됩니다.

두 매뉴얼의 차이

전문가용 매뉴얼은 짧은 reference 호흡입니다. 두 트랙, 승인 게이트, 5 구조 template filling, license-policy L2, pipeline-performance 같은 어휘가 익숙하다고 가정하고, 결정 근거 위주로 풀립니다. intro와 architecture, tracks, verification, distribution, updates 여섯 섹션입니다.

비개발자용 매뉴얼은 단계별입니다. AI가 영상을 만든다는 발상에는 익숙하지만 터미널과 ffmpeg, yt-dlp가 처음일 수 있다고 가정합니다. 외부 도구 설치가 많은 제품이라 prerequisites가 무거운 편입니다. index와 11단계로 풀립니다.

같은 base를 두 호흡으로 푼 짝입니다. 톤은 다르지만 다루는 명령과 워크플로는 그대로 일치합니다.

두 트랙

같은 채널에서 두 트랙을 공존 운영합니다. 진입점만 갈리고, 공유 자산(자막 스타일, 발행 메타, 성능 정책)을 재활용합니다.

생성형 — 오리지널, 캐릭터, 새 영상. 기획에서 장면, 이미지(Codex), 영상(ffmpeg)으로 흐릅니다. 진입점은 scene-flow-orchestrator.
리믹스 — 기존 영상 URL을 받아 수집(yt-dlp), 분석(Whisper와 hook 탐지), 자동 편집으로 흐릅니다. 진입점은 remix-flow-orchestrator.

모호한 입력(예: “숏폼 만들어줘”만)은 추측하지 않고 멈춰서 묻습니다. URL이 있나, 캐릭터와 시나리오인가.

어디서 시작하든 공통

첫 실행은 프로젝트 시작으로 /start를 부르는 자리입니다. /start가 환경(ffmpeg, OPENAI_API_KEY, 트랙별 도구)을 검증하고, 어느 트랙을 쓸지 묻고, 채널 정체성(channel.json)을 잡습니다. 외부 도구는 자동으로 깔지 않습니다. 누락된 건 안내만 하고 설치는 사용자가 직접 합니다.

AI가 한 번에 완성품을 만들지 않습니다. 각 phase가 승인 게이트에서 멈추고, 사람이 승인하거나 수정하거나 롤백합니다. 산출물은 채팅이 아니라 _workspace/에 파일로 남기 때문에, 세션이 끊겨도 정확한 자리에서 돌아옵니다.

리믹스 트랙에는 라이선스 정책이 강제됩니다. 라이선스 라벨이 없는 원본은 진행을 거부하고, Fair Use 30% 이하와 변환 의무 세 개 이상을 요구합니다. 사용자가 명시로 책임을 수락한 자리만 우회합니다.

AI 진입점은 Claude Code에서 /start 한 줄, Codex에서는 저장소 루트의 AGENTS.md입니다. 두 경로는 같은 canonical 문서 AI_AUTOMATION.md를 가리킵니다.

발행은 자동으로 하지 않습니다(S8). publish-copywriter가 발행 메타만 만들고, 플랫폼 업로드는 사용자가 직접 합니다.

본인 자리를 골랐다면 전문가용 매뉴얼 또는 비개발자용 매뉴얼로 곧장 넘어갑니다.