mfrancime/trident-archive

제품 데모 비디오

병렬 빌드 옵션과 구조화된 비평 리뷰를 통해 기술 프로젝트용 2분 제품 데모 비디오를 생성합니다.

사용 시기

• GitHub 리포지토리, API, 또는 기술 제품 데모
• 전문적인 설명 동영상을 빠르게 제작해야 할 때
• 여러 접근 방식(애니메이션 vs 간단함)을 원할 때

워크플로우 (7단계)

발견 → 스크립트 → 병렬 빌드 → 병렬 비평 → 반복 → 최종 → 전달
   │           │           │                │              │          │         │
 5-10분      10-15분      30-60분           10-15분        0-3회전   게이트    전달

---

1단계: 발견

리포지토리 복제 및 분석:

gh repo clone <owner/repo> /tmp/<repo>

추출:

• 기능 (1문장)
• 대상 사용자
• 3-5가지 주요 기능
• 아키텍처/흐름
• 시각 자료 (로고, 다이어그램)

질문 (또는 기본값 사용):

질문	기본값
길이	2분
대상	혼합 (기술 + 비즈니스)
어조	전문적-대화체
형식	애니메이션 설명

---

2단계: 스크립트

references/script-template.md 구조 사용:

장면 1: 훅 (0:00-0:15) — 문제 진술
장면 2: 맥락 (0:15-0:30) — 이것이 중요한 이유
장면 3-5: 기능 (0:30-1:30) — 3가지 주요 기능, 각 20초
장면 6: 기술 (1:30-1:50) — 아키텍처/신뢰성
장면 7: CTA (1:50-2:00) — 다음에 할 일

지침:

• 분당 150단어
• 문장당 최대 20단어
• 능동태 사용
• 추상적보다 구체적

---

3단계: 병렬 빌드

2개의 하위 에이전트를 동시에 실행하여 옵션을 빌드:

// 옵션 A: Remotion (애니메이션)
sessions_spawn({
  label: "demo-video-option-a",
  task: `Remotion을 사용하여 애니메이션 데모 비디오를 빌드하세요.
  
  스크립트: [스크립트 붙여넣기]
  음성: ElevenLabs 사용, 음성 ID CcEB0ARKH8qIyzh2I1OR
  출력: /tmp/demo-video/option-a.mp4
  
  접근 방식:
  1. 장면별 음성 해설 생성 (ElevenLabs API)
  2. 장면 컴포넌트로 Remotion 프로젝트 생성
  3. 애니메이션을 오디오 타이밍에 맞춤
  4. 1080p 30fps로 렌더링`
})

// 옵션 B: 슬라이드 + ffmpeg (간단)
sessions_spawn({
  label: "demo-video-option-b", 
  task: `슬라이드 기반 데모 비디오를 빌드하세요.
  
  스크립트: [스크립트 붙여넣기]
  음성: ElevenLabs 사용, 음성 ID CcEB0ARKH8qIyzh2I1OR
  출력: /tmp/demo-video/option-b.mp4
  
  접근 방식:
  1. 음성 해설 생성 (ElevenLabs API)
  2. Puppeteer로 슬라이드 생성 (HTML → PNG)
  3. ffmpeg로 결합, 오디오와 동기화
  4. 간단한 전환 효과 추가`
})

두 옵션 모두 대기. 옵션을 사용자에게 제시하거나 품질에 따라 자동 선택.

---

4단계: 병렬 비평

2개의 비평가 페르소나 실행 (전체 루브릭은 references/ 참조):

// 비즈니스 비평가
sessions_spawn({
  label: "critic-business",
  task: `비즈니스 비평가 "Mike"로서 데모 비디오를 검토하세요.
  
  비디오: [경로]
  스크립트: [내용]
  
  전체 페르소나 및 루브릭은 references/critic-business.md 참조.
  
  점수: 명확성, 전문성, 비즈니스 가치 (각 1-10)
  출력: 전체 점수 및 특정 수정 사항이 포함된 구조화된 리뷰.`
})

// 기술 비평가
sessions_spawn({
  label: "critic-technical",
  task: `기술 비평가 "Senior Engineer"로서 데모 비디오를 검토하세요.
  
  비디오: [경로]
  스크립트: [내용]
  
  전체 페르소나 및 루브릭은 references/critic-technical.md 참조.
  
  점수: 기술 정확성, 신뢰성, 완전성 (각 1-10)
  출력: 전체 점수 및 특정 수정 사항이 포함된 구조화된 리뷰.`
})

---

5단계: 반복

품질 게이트:

게이트	조치
두 비평가 모두 7.5 이상, 치명적 이슈 없음	→ 전달
비평가 중 하나 7.0 미만 또는 치명적 이슈 있음	→ 반복
3회 반복 후에도 실패	→ 인간에게 에스컬레이션

반복 루프:

1. 모든 치명적/중요 이슈 수집
2. 심각도 순서대로 수정
3. 가능한 경우 영향을 받은 장면만 다시 렌더링
4. 비평가 재실행

---

6단계: 최종 검토

전달 전에 확인:

• 두 비평가 통과 (7.5+)
• 치명적 이슈 없음
• 오디오 동기화 정확
• 모든 장면 깔끔하게 렌더링
• CTA 명확

---

7단계: 전달

출력:

✅ 데모 비디오 완료!

📹 비디오: demo-video-final.mp4 (2:03)
🎯 대상: [대상]
📊 점수: 비즈니스 8.2/10 | 기술 7.8/10

포함 내용:
1. [핵심 포인트 1]
2. [핵심 포인트 2]
3. [핵심 포인트 3]

파일 저장 위치: [위치]

전달 대상:

• Slack 채널 (지정된 경우)
• workspace/outputs/에 저장

---

도구 및 종속성

도구	용도	필수
ElevenLabs	음성 해설 생성	예
Remotion	React 비디오 프레임워크 (옵션 A)	A/B 중 하나
ffmpeg	비디오 처리 (옵션 B)	A/B 중 하나
Puppeteer	슬라이드 스크린샷 (옵션 B)	A/B 중 하나
sessions_spawn	병렬 하위 에이전트	예

기본 음성: CcEB0ARKH8qIyzh2I1OR (Jeremy - 기술 튜토리얼 나레이터)

---

파일 참조

• references/critic-business.md — 비즈니스 비평가 페르소나 및 루브릭
• references/critic-technical.md — 기술 비평가 페르소나 및 루브릭
• references/script-template.md — 장면별 스크립트 구조
• templates/remotion/ — 컴포넌트가 포함된 Remotion 프로젝트 스캐폴드
• scripts/generate-voiceover.py — ElevenLabs TTS 도우미
• scripts/render-slides.sh — ffmpeg 슬라이드-투-비디오 결합기