애니메이션 비디오 (Remotion)
인프라일 뿐, 취향은 아닙니다. 이 기술은 모델이 스스로 가져오지 못하는 것들을 저장합니다 — 도구(음성, 배경 음악, 렌더링, 텍스트 추출), 회사 컨텍스트(승인된 음성, API 키, 방화벽, 라이선스), 진실 규칙, 수치 기반 기술, 리뷰 및 기술 교훈 — 그리고 비디오의 모양을 규정하지 않습니다. 스타일, 장치, 외관은 매 비디오마다 콘텐츠에서 탄생합니다. 기술을 발전시킬 때, 항상 읽히는 내용에 외관 예시, 미적 레시피 또는 "기본" 컴포넌트를 절대 추가하지 마십시오. 그것은 중독되고 반복됩니다.
읽을 것
| 항상 | 필요 시 |
|---|---|
이 파일 · APRENDIZADOS.md (기술) · direcao.md (직무) | gemini.md (음성, API, 기능) · assets.md (라이선스, 자산 출처) · edicao.md (녹화) · critica.md (리뷰) · referencias.md (요청이 연구된 비디오 중 하나를 언급할 때만) · biblioteca/ (컨셉 선택 후에만) · VIDEOS.md 및 이전 프로젝트 (스타일 라인이 요청된 경우에만 — "다른 사람들이 어떤 음성을 사용했는지" 확인하는 용도 금지) · historico/ (문제가 익숙해 보일 때) |
요청 읽기
기술은 감독 역할을 합니다: 요청이 원하는 바를 이해하고 행동합니다. 질문 목록을 만들지 않으며, 차단 요소(모호한 정치/역사적 프레임, 소스가 해결하지 못하는 사실, 불확실한 사용 권리)에 대해서만 추천과 함께 질문합니다.
| 요청에 포함된 내용… | 수행할 작업 |
|---|---|
| 주제만 있음 | 모든 것을 생성(리서치, 대본, 컨셉, 음성, 배경 음악)하여 바로 전달합니다. |
| 대본 | 텍스트는 그대로 유지(별도로 선택적 조정 제안); 브리프를 보여주고 확인 후 제작("바로 진행"은 생략). |
| 메모, 이야기, 키워드 | 이를 기반으로 대본 작성(어조, 컷, 익명화) 후 제작 전에 대본 + 브리프를 보여줍니다. |
| 콘텐츠 없는 문의 ("~에 어떤 애니메이션을 추천하나요…") | 컨셉을 선택하지 않음: 컨셉은 텍스트에서 탄생합니다. 선택이 무엇에 달려 있는지 설명하고 콘텐츠를 요청합니다. |
| 제안 요청 | 브리프만 (PROPOSTA.md). |
| 구체적인 지침 | 엄격히 따름; 명시되지 않은 부분에만 자유를 둡니다. |
| 편집할 녹화본 | 편집 모드: edicao.md. |
| 기존 비디오 조정 | 해당 부분만 변경하고 다시 렌더링합니다. |
| 스타일 라인 ("비디오 X와 같게", "시리즈") | VIDEOS.md의 항목을 로드하고, 해당 프로젝트의 tema.ts 및 조각을 복사하여 룩 유지; roteiro.linha_de_estilo. |
| 빈 시트 ("처음부터", "준비된 것 없음") | 기술적 베이스만; 라이브러리 또는 연구된 참조 자료는 일체 사용 금지. |
| 외부 참조 (링크, 비디오) | 프레임 단위로 연구하고 문법(리듬, 기술)을 가져오며, 콘텐츠나 룩은 가져오지 않습니다. |
| "API 사용 없음" | "offline": true, 로컬 음성, 배경 음악은 partitura 또는 arquivo, 이미지 생성 없음. |
요청은 조합될 수 있습니다. 기본값: ~45–60 초 기준 · 16:9 + 9:16 · 내부용으로 승인된 참조에서 복제된 VoxCPM2 음성 ("voz": "voxcpm", 템플릿에 이미 포함) — 공개용 비디오(캠페인, 소셜 미디어, 고객)는 다른 음성을 요청합니다: 브리프와 함께 추천과 질문. 다른 음성 요청: 이름 → 사용; 설명 → gemini.md; "옵션" → 샘플 · 판매 목적인 경우에만 URL이 포함된 CTA. 길이는 콘텐츠가 요구하는 대로; 선택한 음성의 측정된 속도로 추정합니다(측정 전에 약속 금지). 긴 비디오: 각각 기능을 가진 막과 하위 에이전트 간에 완전히 분할된 패스.
감독의 브리프 (코드 작성 전)
순서대로 — 로그라인과 한계를 먼저, 미학을 다음으로, 도구를 마지막으로 (기술부터 시작하면 기술이 아이디어를 집어삼킵니다). PROPOSTA.md(받은 대본/제안) 또는 ANALISE.md 상단에 작성합니다.
항상 바(Bar) 높이기: 모션 디자인 스튜디오의 포트폴리오 조각처럼 — 최대한의 완성도, 기본이 아닌. 이는 모든 스타일(미니멀하거나 복잡한)에 적용되며 완성도가 나타나는 위치가 다를 뿐입니다.
- 로그라인: 한 문장으로 표현하는 비디오 + 대상 + 게재 위치 + 시청자가 끝났을 때 느끼거나 행동해야 할 것.
- 한계: 길이, 포맷, 진실(소스; 일러스트레이션인 것), 권리, API 예산.
- 편향 없는 아이디에이션: 3개의 매우 다른 컨셉, 콘텐츠에서만 (라이브러리나 이전 비디오를 열지 않고), 각각 완전함: 장치, 시각적 세계, 재료, 팔레트, 타이포그래피, 움직임, 사운드 팔레트 및 배경 음악.
conceitos.json에 선언하고python3 scripts/diversidade.py --conceitos실행 — 모델은 이력을 보지 않아도 반복되는 세계적 반사 작용을 가지고 있습니다; 스크립트(레지스트리만 읽음)가 이를 지적합니다. 2개 미만의 자유로운 컨셉 → 다시 창안.out/conceitos/에 각각 빠른 스틸 이미지 하나씩 생성하고 보고 선택; 승인할 브리프가 있는 경우 3개의 스틸 이미지를 함께 제공합니다. 3개와 그 이유를 기록; 선택된 컨셉의 재료는roteiro.conceito.materiais로 이동합니다. - 비주얼 바이블 (각 선택의 이유와 품질 기준 문장 포함) →
src/tema.ts. 반복 캐릭터 → 캐릭터 바이블 (비율, 팔레트, 표정, 절대 변하지 않는 것). - 디컷 페이지: 블록별로 각 블록의 기능, 나타나는 것, 전환, 사운드.
- 도구: 음성; 배경 음악; 자산 — 라이선스가 있는 웹 (assets.md,
CREDITOS.md), 생성 (scripts/img.py, Veo: gemini.md 참조) 또는 코드로 그리기. - 자산 패스 (바이블 이후, 애니메이션 전): 이 비디오를 위해 만들어진 세트, 대본의 각 아이디어당 하나의 자산(캐릭터, 오브젝트, 배경, 텍스처), 모두 동일한 처리. 생성됨:
roteiro.json의tratamento_imagem+imagens, 첫 번째 승인된 이미지가 다른 이미지의ref스타일이 되고,recorte는 분리된 요소용 (python3 scripts/img.py). 쿼터 없음 또는 오프라인: 동일한 주의를 기울여 코드로 그리기. 생성된 이미지는 실제 사람이나 "일러스트레이션" 레이블이 없는 사실을 절대 나타내지 않습니다. 이것이 스튜디오 작품과 정확하지만 평범한 작품을 가장 크게 구분짓는 요소였습니다.
관문 (건너뛰지 마세요)
브리프 → 대본 → 음성 → 측정 → 사운드 + 비트 → 자산 → 스토리보드 → 애니메틱 → 전체 패스 → 비평 → 렌더링 → 전달 → 발전
- 프로젝트:
bash ~/.claude/skills/video-animado/novo.sh ~/videos/<slug>. 프로젝트의ANALISE.md에는 관문 체크리스트가 이미 포함되어 있습니다: 통과할 때마다 표시; 요청이 생략한 경우에만 건너뛰고 이유를 명시. - 대본
roteiro.json(단일 소스) +ROTEIRO.md(소스 포함). 음성 전에 항상 사실 확인. - 음성:
python3 scripts/tts.py(변경된 블록만 재녹음). 확인:~/.venvs/tts-local/bin/python scripts/check_voz.py. - 측정:
python3 scripts/tighten.py; 자연스러운 발화 또는 주의 →~/.venvs/tts-local/bin/python scripts/align.py(cueW). - 사운드 + 비트: 배경 음악 (
lyria→scripts/music.py;arquivo; 코드로 작곡된partitura, 블록별intensidade및 장면eventos포함) 및python3 scripts/sound.py(타임라인, 효과, 피크, 악보의beats.json). 배경 음악 준비됨 →~/.venvs/tts-local/bin/python scripts/beatmap.py. 패밀리별 효과(biblioteca/sfx/INDEX.md), 재료에 따라sfxVar로 선택 (피크가 자동으로 액션에 맞춰짐). - 스토리보드: 대본의 각 순간마다 스틸 이미지, 바이블 및 "무엇을 뺄 수 있을까?"에 대해 비평.
- 애니메틱: 빠른 렌더링 (
npx remotion render Video-9x16 out/animatic.mp4 --scale=0.4)으로 완성 전에 리듬과 비트 조정. - 전체 패스
src/Video.tsx(템플릿 예제는 단순 동기화일 뿐: 대체; 컨셉이 요구하는 컴포넌트를 구축). 긴 비디오:tema.ts및 핵심 규칙을 사용하여 하위 에이전트 간에 장면 그룹 분할. - 비평:
python3 scripts/qa_folhas.py out/<mp4>+ 점수가 있는 클린 하위 에이전트 (critica.md 참조), 모든 항목이 ≥ 8이 될 때까지 (최대 3라운드; 비평가는 비디오의 바이블을 기준으로 판단, 자신의 취향이 아님).python3 scripts/diversidade.py통과 (요청된 연속성:roteiro.linha_de_estilo). - 렌더링:
bash scripts/render.sh(−14 LUFS, 2패스, 대본의 포맷);qa_folhas.py의relatorio.txt에서 확인 (−14 ± 1). - 전달: MP4 + 커버 프레임 (
npx remotion still … out/capa.png) + 리뷰 시트 +ANALISE.md(브리프, 결정, 소스, 비평 노트, 사람이 들어야 할 것) + Finder에서 열린 파일 (open -R). 최종 메시지에서 평점(1–5)과 변경할 점을 요청. - 기술 발전: 요청자의 평점 →
diversidade.py --registrar→APRENDIZADOS.md에 기술적 교훈 (짧게; 추가할 때 병합 또는 제거),VIDEOS.md에 미적 선택,biblioteca/에 재사용 가능하고 주제가 없는 조각 (+INDEX.md), 두 포맷에서 테스트 및 수정된 템플릿 버그,gemini.md의 새로운 기능. 2개 비디오에서 반복된 직무 교훈 →direcao.md(룩 예제 없이).
코드 계약
- 시간은 절대 단독 숫자가 아님:
cue,cueW,blockStart,naBatida(frame),batida(i),virada(). - 포맷:
useFmt()+pick(paisagem, retrato); 모든 장면은 두 포맷에서 실행(자르기보다 재구성). - 움직임:
mola(frame, at, 'ui'|'padrao'|'pesada'|'viva'); 규칙은 direcao.md 참조. - 템플릿의 중립 코어:
tema.ts(비디오의 색상 및 글꼴),lib.ts(시간, 포맷, 비트, 스프링),stage.tsx(corte/wipe/zoom또는 사용자 정의 전환TransFn,Sheet,Soundtrack,sfxVar포함SceneStack),acabamento.tsx. 준비된 조각은biblioteca/componentes/에 선택적으로, 컨셉 후에만 공개. - 모든 애니메이션은 프레임에서 시작 (
useCurrentFrame+interpolate/mola);interpolate는 항상extrapolateLeft/Right: 'clamp'와 함께 사용; CSStransition/animation사용 금지 (렌더링에 나타나지 않음). - 템플릿의
@remotion/*패키지 4.0.528 (transitions, paths, shapes, noise, motion-blur, lottie, three, media-utils, layout-utils); 새 패키지는 동일한 버전.
엄격한 규칙
- API 키는
~/.config/secrets.env에 위치 (source로 로드; 절대 출력 금지). 할당량/지출 한도 없음: 로컬 음성 및partitura사용. - 음성 복제는 서면 승인 필요; 실제 사람의 복제된 음성은 명시적인 공개 승인이 없는 한 내부용입니다.
- 제3자 자산은 명확한 라이선스가 있어야 하며
CREDITOS.md에 등록; 권리 기반이 없는 실제 사람 사진, 상업 음악 또는 공식 작품을 모방한 제3자 로고는 절대 사용 금지. - 진실: 소스가 있거나 "일러스트레이션/예제" 레이블이 있는 데이터; 화면이나 게시물 캡션에 허위 정보 없음.
- MP4 및 오디오 파일은 공개 리포지토리에 업로드 금지. 문의 없이 커밋 금지.
- 기술을 변경하는 병렬 세션 (
git status에 자신의 변경이 아닌 수정 사항이 있는 경우): 일회성 교환만 허용, 또는 자체 워크트리 사용 (claude --worktree) 및 머지 — 다른 세션의 파일을 덮어쓰지 마십시오.