reels-dopamina

앱용 도파민 릴

이 스킬은 대상 고객의 한 가지 통증을 공략하여 제품을 판매하는 짧은 세로형 비디오를 제작하며, 첫 프레임부터 마지막 프레임까지 높은 유지율을 보장합니다. 프로세스는 인간의 승인을 기준으로 두 단계로 나뉩니다. 음성 생성, 배경 음악, 이미지 생성에는 크레딧과 시간이 소모되므로, 대본 단계에서 오류를 발견하지 못하고 렌더링 단계에서야 알게 되는 것은 가장 큰 낭비입니다.

1단계 (저비용)  브리핑 → 제품에서 진실 확인 → 대본 → 승인
2단계 (고비용)  에셋 → 타임맵 → 컴포지션 → 시각 검토 → 렌더링 → 검증

시작 전: 브랜드 프로필

brands/<브랜드명>.md에서 프로필(색상, 글꼴, 로고 SVG, 이름 발음, CTA, 오퍼, Instagram 핸들, 앱 화면 위치)을 찾으세요. 없으면 사용자가 제공한 정보나 제품 코드/사이트(CSS 색상 토큰, 브랜드 컴포넌트의 로고, 가격 페이지 등)에서 찾은 정보를 바탕으로 brands/_modelo.md를 사용해 새로 만드세요. brands/vehiro.md가 완전한 예시입니다.

1단계 — 대본

1. 간단한 브리핑

누락된 정보만 물어보세요: 제품/브랜드, 대상(구매 결정자), 통증(또는 '왜 당신을 선택하는가'), 음성(여성/남성, 또는 나레이션 없음), 목표 길이(30~50초), 형식(Reels 9:16이 기본). 사용자가 "알아서 해"라고 하면 직접 결정하고 한 줄로 이유를 설명하세요.

2. 통증 선택

비디오 하나당 한 가지 통증만 다루세요. 다음 조건을 우선시하세요: (a) 대상 고객이 경제적 또는 자존심 측면에서 느끼는 통증, (b) 시각적으로 보여줄 수 있는 통증, (c) 제품이 실제로 해결하며 존재하는 화면으로 증명할 수 있는 통증. 같은 시리즈의 이전 비디오에서 이미 다룬 통증은 반복하지 마세요. 선택 전에 이미 만든 통증 목록을 확인하세요.

3. 제품에서 진실 확인

대본의 모든 약속에 대해 코드, 화면 또는 사이트에서 해당 기능이 실제로 존재하고 설명대로 동작하는지 확인하세요. 이는 허위 광고와 재작업을 방지합니다. 실제로 이 확인 과정에서 발견된 예시: 대시보드에서 차량을 상태별로 분리하지 않음(목록 필터만 분리함); "실시간"이 "항상 업데이트됨"으로 변경되어야 함(상태는 사용자가 업데이트할 때만 변경됨); 무료 체험 기간이 7일(코드 상수)임; 앱이 생성한 WhatsApp 메시지의 정확한 문구가 비디오에 사용됨. 기능이 존재하지 않으면 약속을 변경하고, 절대 지어내지 마세요.

4. 대본 작성

references/copywriting.md(카피 구조 및 규칙)와 references/hooks-catalog.md(검증된 후크)를 읽으세요. references/dopamine-fx.md를 사용하여 각 장면의 효과를 선택하세요.

항상 다음 형식으로 채팅에 텍스트를 제공하세요:

## 릴 N — "<통증 이름>"
**통증:** <한 문장>. **제품이 실제로 제공하는 것:** <확인한 위치를 bullet으로 나열>.
**음성:** <음성 이름> · **길이:** ~XX 초

### 후크 (0~3초)
- **시각:** ...   - **사운드:** ...   - **대사:** "..."
- 시선을 사로잡는 이유: ...

### 대본
| 시간 | 대사 | 시각 및 효과 |
|---|---|---|
| 0~3초 · 후크 | ... | ... |
| ... · 불만 | ... | ... |
| ... · 결정타 | ... | ... |
| ... · 전환점 | ... | ... |
| ... · 솔루션 | ... | ... |
| ... · CTA | ... | ... |

### 결정 사항
- <실제 결정 사항만: 음성, 대체 후크, 완화해야 할 약속>

멈추고 승인을 기다리세요. 대본 수정은 저렴합니다. 수정 후 변경된 부분만 다시 제시하세요.

2단계 — 제작 ("제작 시작" 승인 후에만)

프로젝트 폴더(예: marketing/videos/<슬러그>/ 안에 assets/ 폴더)를 생성하고, templates/base.html을 <슬러그>/index.html로, templates/fx.js를 <슬러그>/fx.js로 복사하세요.

5. 에셋

무엇을 생성하기 전에 references/audio.md와 references/elevenlabs.md를 읽으세요.

• 내레이션: ElevenLabs에서 2개의 테이크(eleven_v4, 태그 [urgent], [short pause] 등 사용)를 생성하고, 브랜드 이름은 발음대로 작성하세요(예: VEHIRO → "Verriro").
• 배경 음악: 전환점까지 긴장감을 유지하고 이후에 활기찬 드롭이 있는 악기 음악.
• 후크 효과음: 사이렌, 게임쇼 부저, 금전 등록기 소리 등(짧게, ~1초).
• 실사 이미지(선택 사항): "판매자 휴대폰 사진" — references/elevenlabs.md에서 일일 한도와 가로 형식 확인.
• 실제 앱 화면: 모바일 3배 인쇄물(1170x2532)이 휴대폰 목업 안에 완벽하게 들어갑니다. ElevenLabs를 사용할 수 없거나 크레딧이 부족한 경우: 내레이션 없는 버전(운동 타이포그래피가 메시지를 전달)을 제안하거나 사용자가 크레딧을 충전할 때까지 기다리세요. 허락 없이 음성/공급자를 변경하지 마세요.

6. 음성 검증

python scripts/transcribe_check.py <음성.mp3>를 실행하고(로컬 watch 스킬이 있으면 사용, 없으면 Whisper 사용) 텍스트와 비교하세요. 단어 오류가 없는 테이크를 선택하세요. 특정 부분만 오류가 있는 경우(예: "멈춰" 대신 "팔아"라고 말함) 해당 부분만 다시 생성하고 scripts/splice_phrase.py로 이어붙이세요. 이미 완성된 비디오와의 정렬을 유지하면서 한 단어를 교체해야 하는 경우, 전체 테이크를 다시 생성하고 scripts/align_phrases.py를 사용하세요.

7. 타임맵

• python scripts/timing_map.py 음성.mp3 → 문장 목록(시작/끝, 묵음 포함).
• python scripts/music_drop.py 배경음악.mp3 → 드롭의 정확한 초(저음 에너지).
• V(음성 지연, 0.25~0.9초)를 설정하고 배경 음악을 드롭이 전환점 문장과 일치하도록 배치하세요: 음악_시작 = (전환점_시작 + V) - 드롭.
• 배경 음악이 너무 짧은 경우: python scripts/extend_music.py 배경음악.mp3 배경음악-확장.mp3 --cut <초> --bars 2 --bpm <bpm> (활기찬 부분의 마디를 크로스페이드로 반복).
• 음성이 48초를 초과하는 경우 atempo로 58% 가속(음정 유지). 각 음성 애니메이션은 문장의 시간에 맞춰 들어갑니다: 비디오_시간 = 음성_시간 + V.

8. 컴포지션

references/dopamine-fx.md와 references/hyperframes.md에 따라 index.html에서 장면을 구성하세요. 가장 중요한 규칙: 장면은 0.2~0.5초 겹치며 움직이는 전환을 사용하고, 약 2초마다 시각적 "보상"이 있으며, 상단에 진행 표시줄이 있고, 중요한 텍스트는 Reels UI가 가리는 영역(상단 ~220px, 하단 ~380px)을 피해야 합니다.

9. 시각 검토

npx hyperframes lint . (오류 0개) 및 npx hyperframes snapshot . --at <키-시간> --no-end -o snapshots를 실행하세요. 연속 사진(contact sheet)을 확인하세요: 텍스트 잘림, 읽을 수 없는 오버레이, 빈 장면, 애니메이션되지 않은 요소. 수정 후 영향받은 시간에 대해서만 다시 스냅샷을 찍으세요. 무언가 나타나지 않거나 예상보다 일찍 나타나는 경우 references/pitfalls.md를 참조하세요.

10. 렌더링 및 검증

npx hyperframes render . -o ../renders/<슬러그>-9x16.mp4 -f 30 -q delivery 실행 후 python scripts/verify_render.py ../renders/<슬러그>-9x16.mp4를 실행하세요: 길이, 1080x1920 해상도, 평균 볼륨(-18-20dB)을 확인하고 음성을 텍스트로 변환합니다. 후크가 자막에 나타나지 않으면 효과음이 음성을 묻고 있는 것입니다 — 효과음 볼륨을 낮추세요(references/audio.md 참조).

11. 전달

MP4 파일을 보내고 일반 언어로 설명하세요: 후크, 각 장면의 역할, 사용된 효과, 솔직한 주의사항(자막이 다르게 인식한 발음, 예시 숫자, 소모된 크레딧, 직접 청취 확인하지 않은 사항).

참고 자료

• references/copywriting.md — 7막 구조, 카피 규칙, 트리거.
• references/hooks-catalog.md — 검증된 후크(시각 + 사운드 + 대사) 및 각각 사용 시기.
• references/dopamine-fx.md — 효과 카탈로그, 리듬 및 부드러운 전환.
• references/audio.md — 음성, 발음, 믹싱, 드롭, 이어붙이기.
• references/elevenlabs.md — 커넥터, 할당량, 제한 및 함정.
• references/hyperframes.md — 컴포지션 구조, 오디오, 린트, 스냅샷, 렌더링.
• references/pitfalls.md — 해결된 버그 및 각각의 수정 방법.
• examples/ — 실제 시리즈(VEHIRO)의 승인된 대본으로 어조와 형식을 조정하는 데 사용.