03-dynamic-analyzer

name	03-dynamic-analyzer
description	01-analysis.md의 서술적 effect/transition을 정량적 파라미터 테이블로 변환. Use when "이펙트 분석", "dynamic analysis", "파라미터 추출", "effect library", "effect-library", "이펙트 파라미터".

Dynamic Analyzer

Transforms descriptive effect/transition notes in 01-analysis.md into quantitative parameter tables for Remotion implementation.

The Insight

01-shorts-analyzer는 "무슨 effect가 있다" (what)를 기록하지만, Remotion 구현에 필요한 구체적 파라미터 — 시작값, 끝값, duration, easing — 는 빠져 있다. 예: "scale-up"이라고만 적혀 있고, 1.0→1.5인지 1.0→2.0인지, spring인지 ease-out인지 알 수 없다.

이 스킬은 서술적 기술을 정량적 파라미터 테이블로 변환한다.

Recognition Pattern

Use this skill when:

• 01-analysis.md가 완성되었고, Remotion 구현 전 effect 파라미터가 필요할 때
• "이 effect가 정확히 어떻게 움직이는지" 알아야 할 때
• 03-effect-library.md가 없거나 갱신이 필요할 때

Pipeline Position

01-shorts-analyzer → 02-visual-analyzer → 03-dynamic-analyzer → 001-pattern-extractor → 04-shorts-asset-extractor → 05a~05e-sourcer

Input

File	Required	Purpose
{videoId}/01-analysis.md	Required	Scene tree → effect/transition 서술 추출
{videoId}/02-design-system.md	Optional	레이아웃/색상 정보로 position 추정 보완
{videoId}/frames/	Required	Vision 비교 분석용 프레임 이미지

Output

{videoId}/03-effect-library.md — 정량적 effect/transition 파라미터 테이블

{videoId}/
└── 03-effect-library.md

Execution

Step 1: Effect Inventory

01-analysis.md에서 모든 effect와 transition을 추출하여 목록화한다.

1. 01-analysis.md를 전체 읽기
2. 각 Scene의 effect 항목 추출:
   • 배경 effect (카메라 움직임, 줌, 패닝 등)
   • 텍스트 entry/exit effect
   • 그래픽 entry/emphasis/exit effect
3. 각 Transition 블록 추출
4. 인벤토리 테이블 작성:

| ID | Type | Target | Name | Frame Range | Scene |
|----|------|--------|------|-------------|-------|
| E01 | entry | graphic | scale-up | 0045~0057 | 1.1 |
| E02 | emphasis | text | pulse | 0060~0072 | 1.1 |
| T01 | transition | scene | 스매시컷 | 0120~0121 | 1.1→2.1 |

• Type: entry(등장) / emphasis(강조) / exit(퇴장) / continuous(지속) / transition(전환)
• Target: text / graphic / background

Checklist

• 01-analysis.md 전체 파싱 완료
• 모든 Scene의 effect 추출 (배경/텍스트/그래픽)
• 모든 Transition 블록 추출
• 인벤토리 테이블 작성 (ID, Type, Target, Name, Frame Range, Scene)
• Effect 총 개수 기록: E{N}개 + T{M}개

Step 2: Parameter Extraction

각 effect/transition에 대해 시작 프레임과 끝 프레임을 Vision 에이전트로 비교 분석하여 정량적 파라미터를 추출한다.

1. 인벤토리의 각 항목에 대해:
   • 시작 프레임 이미지 읽기 (frames/frame_NNNN.jpg)
   • 끝 프레임 이미지 읽기
   • 필요시 중간 프레임 (overshoot 감지, 다단계 변화 확인)
2. Vision 비교로 추출할 파라미터:
   • Position: (x, y) → (x', y') — 1080×1920 캔버스 기준 px
   • Scale: 시작 배율 → 끝 배율 (1.0 = 원본)
   • Opacity: 0~1 범위
   • Rotation: degree (시계방향 +)
   • Blur: px (가우시안)
   • Color shift: brightness, saturation 변화
   • Crop/Clip: 표시 영역 변화 %
3. Transition의 경우:
   • 전환 전 마지막 프레임 + 전환 후 첫 프레임 + 중간 프레임(있으면) 비교
   • 전환 중 발생하는 blur, scale, brightness 변화 측정

Vision 최소 호출 원칙: 1~2프레임(snap/스매시컷)인 effect는 Vision 없이 "즉시 전환"으로 기록. Vision은 3프레임 이상의 점진적 변화가 있는 경우만 호출.

병렬 처리: 독립적인 effect들은 oh-my-claudecode:vision 에이전트로 병렬 분석 가능. 한 에이전트당 3~5개 effect 묶어서 처리.

Checklist

• 모든 3f+ effect에 대해 시작/끝 프레임 Vision 분석 완료
• 1~2f effect는 "snap" 처리 (Vision 불필요)
• 각 effect에 최소 2개 이상 파라미터 추출
• Position 값은 1080×1920 기준 px로 기재
• Scale 값은 소수점 1자리 (예: 1.0→1.2)
• Transition 파라미터 추출 완료

Step 3: Easing Classification

프레임 간 변화 속도 패턴을 분석하여 easing 유형을 추정한다.

1. 3프레임 이상인 effect에 대해:
   • 시작/중간/끝 프레임의 파라미터 변화량 비교
   • 초반 변화량 vs 후반 변화량 비율로 easing 유형 결정
2. 분류 기준 (상세: references/easing-types.md):
   • linear: 프레임 간 변화량 일정
   • ease-in: 초반 느림, 후반 빠름
   • ease-out: 초반 빠름, 후반 느림
   • ease-in-out: 양 끝 느림, 중간 빠름
   • spring: 목표값 초과(overshoot) 후 안착
   • snap: 1~2f 즉시 전환
   • bounce: 목표값에서 2~3회 반복 감쇠
3. Duration이 짧아(3~5f) 중간 프레임 판별이 어려운 경우:
   • 기본값 적용 (entry → ease-out, exit → ease-in, emphasis → spring)
   • references/easing-types.md의 기본값 테이블 참조

Checklist

• 모든 3f+ effect에 easing 유형 할당
• 1~2f effect는 "snap" 분류
• Overshoot 패턴 감지된 경우 spring으로 분류
• 확신도 낮은 경우 "추정" 표기

Step 4: Effect Library Synthesis

Step 1~3 결과를 종합하여 {videoId}/03-effect-library.md를 작성한다.

# Effect Library — {videoId}

Generated: {date}
Source: 01-analysis.md (01-shorts-analyzer)
Total: E{N} effects + T{M} transitions

---

## Effects

### E01: [에셋명] — [effect 이름]
- **Type**: entry | emphasis | exit | continuous
- **Target**: text | graphic | background
- **Frame**: 0123~0135 (12f, 0.2s)
- **Parameters**:
  - scale: 0.0 → 1.2 → 1.0 (overshoot)
  - opacity: 0 → 1
  - position: (540, 1100) → (540, 960)
- **Easing**: spring (stiffness ~200, damping ~15)
- **Scene**: 2.1

### E02: ...

---

## Transitions

### T01: [Scene N.N → N.M] — [transition 이름]
- **Frame**: 0217~0220 (3f, 0.05s)
- **Parameters**:
  - blur: 0 → 20px → 0
  - scale: 1.0 → 1.5 → 1.0
  - brightness: 1.0 → 2.0 → 1.0
- **Easing**: ease-in-out
- **Remotion hint**: `<TransitionSeries>` + custom presentationEffect

### T02: ...

---

## Summary

| Easing | Count | Typical Use |
|--------|-------|-------------|
| spring | N | Entry effects |
| ease-out | N | ... |
| snap | N | Scene transitions |
| ... | | |

Checklist

• {videoId}/03-effect-library.md 생성
• Effects 섹션: 모든 E{ID} 항목 포함
• Transitions 섹션: 모든 T{ID} 항목 포함
• 각 항목에 Type, Target, Frame, Parameters, Easing, Scene 기재
• Summary 테이블: easing별 빈도 + 대표 용도
• Effect 총 개수 = Step 1 인벤토리 총 개수 (누락 없음)