@milenyumai/film-kit 1.0.0

package/content/skills/frame-chaining/SKILL.md

@@ -0,0 +1,342 @@
+---
+name: frame-chaining
+description: Mandatory shot continuity protocol. Ensures every shot's last frame becomes the next shot's first frame for seamless visual flow. Critical for professional-grade video sequences.
+---
+
+# Frame Chaining System
+
+> **Philosophy:** Cinema is continuous. Every cut must flow. Every frame must connect.
+> **Core Principle:** LAST FRAME → FIRST FRAME. Always. No exceptions unless declared.
+
+---
+
+## 🔗 Core Principle (Non-Negotiable)
+
+**MANDATORY CHAINING RULE:**
+
+Every shot's LAST FRAME (SHOTNN_END) MUST become the next shot's FIRST FRAME (SHOT[NN+1]_START).
+
+This is REQUIRED for seamless visual transitions.
+
+**Default:** 95% of shots MUST be chained.
+
+**P2 Priority:** Chain Continuity (mandatory chaining > convenience)
+
+---
+
+## Naming Convention
+
+| Frame Type | Naming | Usage |
+|------------|--------|-------|
+| First frame of Shot NN | `SHOTNN_START` | Only for FIRST SHOT or CHAIN BREAK |
+| Last frame of Shot NN | `SHOTNN_END` | ALWAYS generated |
+| Chained first frame | Use `SHOT(prev)_END` | Standard chained shot |
+
+---
+
+## Workflow Logic
+
+### FIRST SHOT OF PROJECT (SHOT01)
+
+```
+1. Create Image: SHOT01_START prompt → Save as SHOT01_START.png
+2. Create Image: SHOT01_END prompt → Save as SHOT01_END.png
+3. Frames to Video: SHOT01_START → SHOT01_END + full video prompt
+```
+
+**Output:**
+- Generate BOTH first frame and last frame prompts
+- Last frame must be designed for continuation
+
+### ALL SUBSEQUENT SHOTS (CHAINED)
+
+```
+1. REUSE previous shot's end frame: SHOT(prev)_END becomes SHOTNN_START
+2. Create Image: ONLY SHOTNN_END prompt → Save as SHOTNN_END.png
+3. Frames to Video: SHOT(prev)_END → SHOTNN_END + full video prompt
+```
+
+**Output:**
+- DO NOT generate first frame prompt
+- Instruct: "→ Use SHOT[prev]_END as first frame"
+- Generate ONLY last frame prompt
+
+### CHAIN BREAK (Rare Exceptions Only)
+
+**Permitted ONLY for:**
+- Location Change (different place)
+- Time Jump (hours/days later)
+- Dream/Flashback sequence
+- Character Transformation
+- Extreme Camera Reset (180° flip)
+
+```
+1. Explicitly state: "CHAIN BREAK - [Reason]"
+2. **Specify transition type** (see below)
+3. Create Image: SHOTNN_START (new first frame)
+4. Create Image: SHOTNN_END (new last frame)
+5. Frames to Video: SHOTNN_START → SHOTNN_END
+6. Chain RESUMES from SHOTNN_END into next shot
+```
+
+### Scene Transition Types (Sahne Geçişleri)
+
+Her chain break'te geçiş türü belirtilmelidir:
+
+| Geçiş | İngilizce | Anlam | Ne Zaman |
+|-------|-----------|-------|----------|
+| **Sert kesme** | Hard Cut | Aniden kes | Standart, tempo, şok |
+| **Kararmaya** | Fade to Black | Karanlığa kaybet | Zaman atlama, bölüm sonu |
+| **Çapraz erime** | Cross-Dissolve | İki görüntü üst üste erir | Nostalji, rüya, geçiş |
+| **Eşleştirme kesme** | Match Cut | Benzer şekil/hareketle kes | En sinematik geçiş |
+| **Şok kesme** | Smash Cut | Sakin → şok | Korku, komedi |
+| **Beyaza** | Fade to White | Beyazlığa kaybet | Ölüm, rüya, flashback |
+
+**Prompt'ta kullanım:**
+```
+CHAIN BREAK - Location change (bunker → shore)
+Transition: FADE TO BLACK → NEW SCENE
+```
+
+**End frame tasarımı geçiş türüne göre değişir:**
+| Geçiş | End Frame Nasıl Olmalı |
+|-------|----------------------|
+| Hard Cut | Normal end frame, next shot'a uygun |
+| Fade to Black | Karanlık/gölgeli biten frame, düşük ışık |
+| Cross-Dissolve | Her iki sahneye uyumlu orta tonda frame |
+| Match Cut | Bir sonraki sahneyle **benzer şekil/kompozisyon** |
+| Smash Cut | Sakin, huzurlu bir frame (kontrast için) |
+
+---
+
+## End Frame Composition Rules
+
+Every END FRAME must satisfy these criteria:
+
+### ✅ MUST HAVE
+
+| Requirement | Why |
+|-------------|-----|
+| Camera angle allows natural continuation | Next shot needs starting point |
+| Subject positioned for logical next action | Action must flow |
+| Framing has "room" for next shot's movement | Space for camera to go |
+| Lighting direction consistent | No jarring light jumps |
+| Sharp focus (no motion blur) | Clean frame for Flow |
+| Stable composition | Flow needs clear reference |
+
+### ❌ MUST AVOID
+
+| Avoid | Why |
+|-------|-----|
+| Extreme close-ups | Traps next shot, no room to move |
+| Off-balance compositions | Hard to continue naturally |
+| Motion blur | Flow can't read the frame |
+| Unusual angles | Limits continuation options |
+| Character exiting frame | Breaks continuity |
+
+---
+
+## 🎯 FRAME CONTINUITY CHECKLIST (CRITICAL)
+
+> **This section addresses the most common error:** First frame and last frame not matching visually.
+
+### The Problem (User Example)
+
+```
+❌ WRONG:
+Frame 1: Wide shot from BEHIND soldiers, everyone facing FORWARD
+Frame 2: Close-up from SIDE, soldier with binoculars facing LEFT
+
+→ Camera jumped 90°, subject changed, gaze direction changed = FAIL
+```
+
+### The Rules
+
+**RULE 1: Camera Position Must Be Compatible**
+
+| First Frame Camera | Last Frame Camera | Valid? |
+|--------------------|-------------------|--------|
+| Behind subjects | Behind subjects (closer/further) | ✅ YES |
+| Behind subjects | Side of subjects | ❌ NO (90° jump) |
+| Side (left) | Side (right) | ❌ NO (180° jump) |
+| Front facing | Front facing (zoom in/out) | ✅ YES |
+
+**RULE 2: Subject Gaze/Facing Must Match**
+
+| First Frame Gaze | Last Frame Gaze | Valid? |
+|------------------|-----------------|--------|
+| Looking forward | Looking forward | ✅ YES |
+| Looking forward | Looking backward | ❌ NO |
+| Looking left | Still looking left | ✅ YES |
+| Group facing sea | Individual facing camera | ❌ NO |
+
+**RULE 3: Subject Consistency**
+
+| First Frame Subject | Last Frame Subject | Valid? |
+|---------------------|-------------------|--------|
+| Group of 6 soldiers | Same 6 soldiers (closer) | ✅ YES |
+| Group of 6 soldiers | 1 soldier only | ⚠️ MAYBE (if smooth zoom) |
+| Soldier A as focus | Soldier B as focus | ❌ NO |
+
+### How to Fix (Correct Approach)
+
+```
+✅ CORRECT:
+Frame 1: Wide shot from BEHIND soldiers, everyone facing FORWARD toward ships
+Frame 2: Medium shot from BEHIND (closer), same soldiers, same direction, 
+         one soldier's hand BEGINNING to raise binoculars
+
+→ Same camera axis, same gaze direction, smooth transition = SUCCESS
+```
+
+### Frame Design Template (Continuity-Safe)
+
+When writing END frame prompts, explicitly state:
+
+```
+Camera: [Same position as start / Slightly closer from same angle]
+Subject: [Same characters in frame, consistency note]
+Gaze Direction: [Still facing X / Eyes remain on Y]
+Action State: [Beginning of action that continues in next shot]
+```
+
+### Example Continuity-Safe Prompt
+
+```
+Ottoman soldiers at artillery position, camera behind them at medium distance.
+All soldiers still facing the sea, watching the approaching ships.
+The officer on the right is BEGINNING to raise binoculars to his eyes.
+Same smoke, same lighting angle, same composition axis as first frame.
+Stable, no motion blur, ready for next shot to push in on the officer.
+```
+
+---
+
+## Chain Status Declaration
+
+Every shot output must clearly state chain status:
+
+| Status | Icon | Meaning |
+|--------|------|---------|
+| `FIRST SHOT` | 🔗 | First shot of project |
+| `CHAINED from SHOT[prev]_END` | 🔗 | Continuing from previous |
+| `CHAIN BREAK - [Reason]` | ⛓️‍💥 | Intentional break |
+
+### Format Example
+
+```
+**SHOT05** | 8s | 🔗 CHAINED from SHOT04_END
+```
+
+```
+**SHOT08** | 4s | ⛓️‍💥 CHAIN BREAK - Location change to British ship
+```
+
+---
+
+## Scene Transition Strategies
+
+### Within Same Location (Always Chain)
+
+```
+Shot 1: Wide establishing → END on medium shot of soldier
+Shot 2: START reuses Shot 1 END → push in to close-up → END on face
+Shot 3: START reuses Shot 2 END → slight pull back → END with room for action
+```
+
+### Location Change (Chain Break)
+
+```
+Shot 7: In Ottoman bunker → END on commander's face
+Shot 8: CHAIN BREAK - Cut to British ship bridge → START new on Admiral
+Shot 9: CHAINS from Shot 8 END on bridge → continues...
+```
+
+### Time Jump (Chain Break)
+
+```
+Shot 12: Sunset scene → END on silhouette
+Shot 13: CHAIN BREAK - Time jump to next morning → START on sunrise
+Shot 14: CHAINS from Shot 13 → continues...
+```
+
+---
+
+## End Frame Design Templates
+
+### For Action Continuation
+
+```
+[Character] in [position], framing allows natural movement [direction].
+Camera angle at [degrees] enables smooth transition. Composition balanced with 
+[amount]% negative space on [side] for next shot's action.
+No motion blur, crisp focus, stable lighting from [direction].
+```
+
+### For Dialogue Continuation
+
+```
+[Character] in medium shot, slight [direction] angle. Expression [state],
+mouth closed (ready for next line). Eye-line at [direction].
+Framing leaves headroom for emotional continuation.
+Lighting soft, no harsh shadows to maintain across cut.
+```
+
+### For Dramatic Transition
+
+```
+[Character/scene] at moment of [peak/pause]. Composition centered,
+allowing next shot to push in or pull back. Dramatic lighting locked.
+Sharp focus on [subject], background [in/out of focus].
+Frame composition stable for next shot's emotional beat.
+```
+
+---
+
+## Quick Reference: First Frame Rules
+
+| Shot Type | First Frame |
+|-----------|-------------|
+| First of project | Generate SHOT01_START |
+| Chained | "→ Use SHOT[prev]_END as first frame" |
+| Chain Break | Generate new SHOTNN_START |
+
+## Quick Reference: Last Frame Rules
+
+| Any Shot | Last Frame |
+|----------|------------|
+| ALL shots | ALWAYS generate SHOTNN_END |
+| Must be chain-ready | Design for continuation |
+| Exception | Only if explicitly end of sequence |
+
+---
+
+## Çanakkale Scenario Example
+
+```
+Shot 1 (FIRST): Bunker interior, soldiers praying
+  - SHOT01_START: Wide shot, soldiers huddled
+  - SHOT01_END: Medium on officer picking up phone (ready for Shot 2)
+
+Shot 2 (CHAINED from SHOT01_END): Officer on phone
+  - First frame: USE SHOT01_END
+  - SHOT02_END: Officer's face, expression changing to hope
+
+Shot 3 (CHAINED from SHOT02_END): Officer announces to soldiers
+  - First frame: USE SHOT02_END  
+  - SHOT03_END: Soldiers beginning to rise (allows Shot 4 action)
+
+Shot 4 (CHAINED from SHOT03_END): Soldiers rushing to positions
+  - First frame: USE SHOT03_END
+  - SHOT04_END: Wide on artillery position (ready for battle shots)
+
+...
+
+Shot 8 (CHAIN BREAK - Location Change): British ship bridge
+  - SHOT08_START: NEW - Admiral on bridge observing
+  - SHOT08_END: Admiral's shocked expression
+```
+
+---
+
+> **Remember:** Chaining is not optional. It's the foundation of cinematic flow. Every end frame is a promise to the next shot. Keep that promise.