/video-animado

video-animado은(는) 무엇을 하나요?

코드(SVG + Remotion)로 그린 2D 애니메이션 내레이션 동영상을 만듭니다. 절대 깨지지 않는 규칙: 외부 AI 이미지/영상 도구 사용 금지(Kling, Veo, Flow, Magnific, 이미지 생성기 등 절대 불가). 캐릭터, 배경, 사물은 도형, SVG 경로, 텍스트로만 만들어집니다. 이렇게 하면 모든 장면에서 캐릭터가 동일하게 유지되고 전체 프로세스를 복사하여 재현할 수 있습니다.

상태: 2026년 8월 11일 생성, 아직 종단 간 테스트되지 않음. 첫 실제 실행 시, 깨지는 부분을 "함정"에 기록하세요.

사람과 대화하는 방법

• 브라질 포르투갈어, 실용적인 교수 톤, 상대방이 "tu"를 사용하면 "tu", 그렇지 않으면 "você" 사용. 대시는 없음.
• 상대방이 기술에 능숙하지 않을 수 있습니다. 무슨 일이 일어났고 그것이 그/그녀에게 무엇을 의미하는지 말하세요. 코드와 경로는 그/그녀가 요청할 때만 알려주세요.
• 모든 질문은 AskUserQuestion을 사용하며, 한 번에 하나씩, 2~4개의 옵션을 제시하고, 추천 옵션을 첫 번째에 두고 "(추천)"이라고 표시합니다. 상대방이 "네가 결정해", "아무거나" 등 비슷한 말을 하면 추천 옵션을 선택하고 진행하며, 무엇을 선택했는지 말해줍니다.
• 파일을 보면 알 수 있는 것을 절대 묻지 마세요.

파일 위치

• 작업실(Estúdio): 사용자의 동영상 작업 폴더. ~/meu-estudio/를 찾으세요. 없으면 위치를 묻거나 현재 폴더를 사용하세요.
• 애니메이션 브랜드북: <estúdio>/animacao/<유니버스-이름>/
  • BRANDBOOK-ANIMACAO.html: 예쁜 버전, 보거나 공유용
  • BRANDBOOK-ANIMACAO.md: Claude가 읽는 버전(동일한 규칙; 하나가 변경되면 둘 다 변경)
  • personagens/<이름>/: FICHA.md, Personagem.tsx(코드로 그린 그림), expressoes.png
  • cenarios/: 배경별 컴포넌트(Casa.tsx, Rua.tsx…)
  • pronuncias.md(선택 사항): 각 용어가 음성에서 어떻게 발음되고 자막에 표시되어야 하는지
• 동영상: <estúdio>/animacao/<유니버스-이름>/videos/YYYY-MM-DD-slug/
• 최종 파일: ~/Downloads/YYYY-MM-DD_slug_animado.mp4

브랜드북은 유니버스입니다(고유 이름을 가진 하나의 "세계"). 그 안에는 0명, 1명 또는 여러 명의 캐릭터가 있습니다.

워크플로우

0. 브랜드북 찾기

직접 찾으세요: 작업실과 현재 폴더의 animacao/ 폴더, BRANDBOOK-ANIMACAO.* 파일. 찾은 것을 목록화하고 물어보세요:

• 이 중 하나 사용 (찾은 유니버스당 하나씩)
• 다른 경로 지정 (다른 사람에게 받은 브랜드북 포함)
• 새로 만들기

아무것도 찾지 못하면 그렇게 말하고 바로 생성으로 넘어갑니다. 기존 것을 사용하면 .md 파일과 프로필을 읽고 파트 B로 건너뜁니다.

파트 A. 브랜드북 생성 (처음)

시작할 때 미리 알림: "약 25~35개의 질문을 하나씩 드릴 거예요. 언제든지 '네가 결정해'라고 말해도 돼요." 블록 사이에는 결정된 내용을 짧게 요약하고 맞는지 확인하세요. 질문 및 옵션 데이터베이스는 references/perguntas.md에 있습니다(시작하기 전에 읽으세요).

7개 블록, 순서대로:

1. 유니버스: 이름(3개 이름 제안), 동영상 주제, 대상, 톤.
2. 캐릭터: 몇 명(0, 1, 또는 여러 명). 각각에 대해 전체 프로필(성별, 나이, 얼굴, 머리, 옷, 성격, 반려견, 아기, 식물 등 동반자, 목소리).
3. 배경: 어떤 것이 있는지(집, 사무실, 거리, 자연, 추상 공간…), 방이나 장소, 시간대, 고정 사물.
4. 내러티브: 각 캐릭터가 하는 일, 행동 방식, 자주 가는 곳, 말투, 절대 하지 않는 일, 캐릭터 간 관계.
5. 시각적 스타일: 코드로 가능한 그림 스타일, 색상 팔레트(정확한 16진수 코드와 사용 비율), 글꼴, 디테일 수준.
6. 움직임: 등장 및 퇴장, 표정, 리듬, 호흡 및 깜빡임, 애니메이션 규칙, 절대 하지 않는 일.
7. 마무리: 전체 요약, 내레이션 음성(아래 참조), 최종 브랜드북 이름.

캐릭터 없음도 가능: 배경, 텍스트, 도형만 있는 동영상. 이 경우 블록 2를 건너뛰고 블록 3~6은 세계와 리듬에 대해서만 다룹니다.

내레이션 음성, 다시 묻지 않도록 브랜드북에 저장, 3가지 방법:

1. ElevenLabs에서 복제된 사용자 목소리;
2. 스킬이 캐릭터에 따라 제안하는 ElevenLabs의 기성 목소리;
3. 사용자가 이미 오디오를 녹음했고 스킬이 그냥 사용. 여러 캐릭터가 있는 경우, 각 프로필에 캐릭터의 목소리를 저장합니다.

파트 A의 결과물:

• BRANDBOOK-ANIMACAO.md 및 BRANDBOOK-ANIMACAO.html (구조는 references/brandbook-html.md 참조).
• 각 캐릭터: FICHA.md, Personagem.tsx (expressao, falando, olhando, escala 속성 포함, 입은 내레이션 볼륨에 따라 움직임), expressoes.png (모든 표정을 나란히 보여주는 이미지).
• 배경당 하나의 컴포넌트.
• 캐릭터가 배경 안에 있는 테스트 이미지.

사용자가 표정과 테스트 이미지를 직접 눈으로 확인하고 승인한 경우에만 진행하세요. 코드로 그리는 그림이 마음에 들지 않으면 그림을 단순화하세요(디테일 줄이고, 형태 늘리기). 절대 외부 도구로 대체하지 마세요.

파트 B. 동영상 만들기

1. 단일 질문 (부족한 것만): 주제, 길이(기본 30~60초), 형식(기본 세로 1080x1920, 30fps), 어떤 캐릭터와 배경이 나올지.
2. 듣기 위한 후크 및 스크립트 (references/roteiro.md 읽기). 먼저 다른 유형의 후크 3가지 옵션을 제시하고 사용자가 선택합니다. 그 다음 스크립트: 짧은 문장, 숫자는 말하는 대로 작성, 괄호나 어려운 약어 없음, 금지된 문장 목록의 문장 사용 금지. 각 문장 옆에는: 장면, 등장인물, 표정, 화면에 나타나는 것. 브랜드북의 내러티브를 존중하세요. 마지막에 사용자가 확인해야 할 사실 진술을 별도로 나열합니다. videos/<data-slug>/roteiro.md에 저장하고 사용자 승인이 있어야만 진행합니다.
3. 내레이션, 브랜드북에 저장된 음성 경로 사용. 오디오를 보여주고 승인을 기다립니다. 이상한 문장: 해당 문장만 다시 생성합니다. pronuncias.md가 있으면 사용합니다. narracao.mp3로 저장합니다.
4. 각 단어의 시간. 단어별 타임스탬프로 내레이션을 텍스트 변환합니다(작업실에 이미 있는 전사 도구, 편집 코스의 도구: Mac의 mlx-whisper). 제품 이름과 기술 용어에서 Whisper의 일반적인 오류를 수정합니다. 사용자에게 전사기가 설치되어 있지 않으면 알리고 진행하기 전에 설치를 도와주세요.
5. Remotion 프로젝트를 videos/<data-slug>/에 생성(remotion-best-practices 스킬 사용). 배경 오디오 하나(narracao.mp3). 각 장면은 브랜드북의 컴포넌트를 가져오고, 절대 캐릭터나 배경을 다시 그리지 않습니다. 입: 프레임별로 오디오 볼륨을 추출하여 falando로 사용하며, 침묵 구간에서 떨리지 않도록 바닥값을 설정합니다. 각 요소는 해당 요소를 언급하는 단어에서 생성됩니다. 브랜드북 스타일의 단어별 자막. React 훅은 절대 if 문 안이나 조기 return 이후에 사용하지 마세요.
6. 렌더링 전 확인. npx tsc --noEmit, 그 다음 각 장면의 한 프레임을 확인합니다. 이미지 확인: 캐릭터가 완전하고 프로필과 동일한지, 텍스트가 겹치거나 너비를 초과하지 않는지, 안전 영역 내에 있는지, 입이 음성과 일치하는지, 표정과 장면이 정확한 타이밍에 있는지. 자세한 내용은 references/conferencias.md 참조.
7. 렌더링, 확인 및 최종 파일 제공. ~/Downloads/에 mp4(H.264, AAC 오디오)로 저장. scripts/checar_video.py 실행(볼륨, 크기, 무음 구간), contact sheet 생성 및 독립 검토자(편집을 보지 않은 하위 에이전트, 브리핑은 references/conferencias.md 참조) 호출. 심각하거나 중간 수준의 문제를 수정하고 다시 렌더링합니다. 썸네일과 게시물 자막도 함께 제공하고, 1:1 및 16:9 형식도 제공합니다(references/roteiro.md 참조). 각 장면에 무엇이 있는지, 길이, 검토자가 무엇을 발견했고 무엇이 변경되었는지, 사용자가 귀로 확인해야 할 사항(당신은 오디오를 듣지 못함) 및 프로젝트 위치를 말합니다.
8. 조정. 사용자가 일반적인 말로 요청("캐릭터가 너무 진지해요", "더 빨리 나타나게 해주세요")하거나 시간으로 요청("0:12에서 제목을 바꿔주세요")합니다. 시간을 프레임으로 변환하고, 영향을 받는 장면만 수정하고, 전체를 렌더링하기 전에 해당 부분을 보여줍니다. 규칙이 다음 동영상에도 적용된다면 브랜드북(두 버전 모두)을 업데이트합니다. 이번 동영상에만 적용된다면 프로젝트만 업데이트합니다.

이름 제안

브랜드북이 생성될 때마다 3개의 유니버스 이름(짧고, 말하기 쉬운)을 제안하고 사용자가 선택하거나 직접 입력하도록 합니다. 이름은 폴더 이름(kebab-case)과 HTML 제목이 됩니다.

함정

• 브랜드북 외부의 캐릭터: 모든 장면은 동일한 컴포넌트를 가져와야 합니다.
• 말 없이 입 움직이기, 또는 말하는데 입 움직임 없음: 바닥값이 있는 진폭으로 동기화.
• 게으름으로 인한 외부 도구 사용: 그림이 안 나오면 단순화하세요.
• 스크립트 승인 없이 음성 크레딧 소모. 내레이션을 생성하기 전에 음성에 사용될 문자 수를 말하고 승인을 기다리세요.
• 독립 검토자를 통과하지 않고 최종 파일 제공: 만든 사람은 자신의 실수를 보지 못합니다.
• 브랜드북을 HTML로만 저장: Claude는 .md를 읽습니다. 둘을 동일하게 유지하세요.
• (첫 실제 실행 시 기록하세요.)