@milenyumai/film-kit 1.0.1 → 1.0.3

package/build/cli.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { configureAgents } from "./lib/configure.js";
+const args = process.argv.slice(2);
+const command = args[0];
+if (command === "init") {
+    console.log("🎬 Film-Kit: Configuring AI agents...\n");
+    try {
+        const result = await configureAgents({ rootDir: process.cwd() });
+        if (result.written.length > 0) {
+            console.log(`✅ Files written: ${result.written.length}`);
+            result.written.forEach(f => console.log(`   ${f}`));
+        }
+        if (result.skipped.length > 0) {
+            console.log(`⏭️  Files skipped (already exist): ${result.skipped.length}`);
+        }
+        console.log("\n🎬 Done! Your AI agents are configured for Hollywood-grade prompt engineering.");
+        console.log("   Use /generate in your AI editor to start creating shots.\n");
+    }
+    catch (err) {
+        console.error("❌ Error:", err.message);
+        process.exit(1);
+    }
+}
+else {
+    console.log(`
+🎬 @milenyumai/film-kit — Hollywood-grade prompt engineering for Veo 3.1
+
+Usage:
+  npx @milenyumai/film-kit init    Configure AI agents in current directory
+
+Or install as a dependency (auto-configures on install):
+  npm install --save-dev @milenyumai/film-kit
+`);
+}

package/content/agents/prompt-engineer.md

@@ -71,188 +71,136 @@ Tercihiniz:"
 
 | Feature | Value |
 |---------|-------|
-| **Resolution** | 720p or 1080p (never claim 4K/8K) |
+| **Resolution** | 1080p (never claim 4K/8K) |
 | **Frame Rate** | 24 fps (fixed) |
 | **Aspect Ratios** | 16:9 (landscape) or 9:16 (portrait) |
 | **Base Duration** | 8s default (4s, 6s, 8s available) |
-| **Scene Extension** | Up to 148 seconds via chaining |
-| **Reference Images** | 1-4 images for character/object/style |
 | **Native Audio** | Dialogue, SFX, ambience (experimental) |
 
-### Available Features
-
-- ✅ Frames to Video (First + Last) — PRIMARY METHOD
-- ✅ Scene Extension — continuity from last second
-- ✅ Ingredients to Video — multi-reference control
-- ✅ Add/Remove Object — editing only
-- ⚠️ Audio quality experimental
-
 ---
 
-## Scenario Analysis
+## PROMPT FLOW ORDER (Veo Optimization — MANDATORY)
 
-When receiving a scenario, analyze and classify:
-
-### Genre Detection (ALL GENRES SUPPORTED)
+Veo prioritizes first sentence most heavily. Every prompt MUST follow this order:
 
-| Genre | Keywords | Camera Style | Lighting | Duration |
-|-------|----------|--------------|----------|----------|
-| **DRAMA** | dram, duygu, aile | Close-ups, shallow DOF | Soft, natural | 8s |
-| **COMEDY** | komedi, gülmek, espri | Wide, clear sightlines | Bright, even | 8s |
-| **ACTION** | aksiyon, kovalamaca, dövüş | Dynamic, handheld, shake | High contrast | 4s |
-| **HORROR** | korku, gerilim, hayalet | POV, negative space | Low-key, shadows | 8s |
-| **ROMANCE** | aşk, romantik, öpüşme | Two-shots, soft focus | Warm, golden hour | 8s |
-| **SCI-FI** | bilim kurgu, uzay, robot | Geometric, symmetrical | Controlled, neon | 8s |
-| **FANTASY** | fantastik, büyü, ejderha | Epic wide + intimate close | Ethereal, magical | 8s |
-| **THRILLER** | gerilim, suç, dedektif | Tracking, surveillance | High contrast | 8s |
-| **WAR/MILITARY** | savaş, asker, bomba | Wide establishing + tight | Harsh, dramatic | 8s |
-| **HISTORICAL** | tarihi, dönem, paşa | Documentary touch | Period-accurate | 8s |
-| **DOCUMENTARY** | belgesel, gerçek | Observational | Natural available | 8s |
-| **MUSICAL** | müzikal, dans, şarkı | Choreography-matched | Stage/performance | 8s |
-| **WESTERN** | kovboy, vahsi batı | Wide landscapes + faces | Harsh sun, dusty | 8s |
-| **NOIR** | noir, dedektif, gece | Shadows, high contrast | B&W or desaturated | 8s |
-| **ANIMATION** | animasyon, çizgi film | Style-specific | Stylized | Per style |
-
-### Dramaturji Analizi (Diyalog Sahneleri İçin)
-
-Her diyalog sahnesi için şu iskeleti zihinsel olarak doldur:
-1. **Amaç:** Her karakter bu sahnede ne istiyor?
-2. **Engel:** Neden hemen alamıyor?
-3. **Risk:** Kaybederse ne olur?
-4. **Alt metin:** Söylediği ile kastettiği aynı mı?
-5. **Beat/Dönüş:** Her 1-2 replikte mini yön değişimi
-
-Bu bilgiyi prompt'a kuru bilgi olarak değil, **oyunculuk davranışı** olarak göm.
-Detay için → `MASTER.md` TIER 0.5: DRAMATÜRJİ & OYUNCULUK
-
-### Character Tracking
-
-For each character mentioned:
-1. Check if reference image provided
-2. Create consistent physical description
-3. Track costume changes
-4. Maintain continuity across shots
-5. **Use same seed** for coverage shots of the same character
-
-### Location Tracking
-
-For each location:
-1. Establish visual style
-2. Track lighting conditions
-3. Note atmosphere elements
-4. Maintain consistency
-5. **Use same seed** for same-location shots
+```text
+1. [Scene summary — single sentence] "Cinematic close-up of a young soldier in a dim bunker."
+2. [Who/What/Where] Character physical description, costume, position
+3. [Action] Micro-behavior, acting cue, physical gesture
+4. [Camera + Lens] "85mm f/2.0, shallow DOF, static with handheld micro-movement"
+5. [Light + Atmosphere] "Warm oil lamp key light from screen-left, deep shadows"
+6. [Audio direction block] (VIDEO prompts only)
+7. [Avoid line] (EVERY prompt — MANDATORY)
+```
 
 ---
 
-## Pre-Delivery Checklist
+## AUDIO DIRECTION BLOCK (Mandatory for Video)
 
-Before outputting ANY shot:
+Every video prompt must include this exact block at the end:
 
-### 1. Celebrity/Safety (CRITICAL - CHECK FIRST)
-- [ ] Does prompt contain any real person's name? → REMOVE
-- [ ] Any celebrity reference, even indirect? → REPLACE with physical description
-- [ ] Active violence, gore? → Apply safe framing
-
-### 2. Reference Compliance
-- [ ] `[REFERENCE LOCK]` section at prompt start? (if refs provided)
-- [ ] "EXACTLY" / "PRECISELY" language used?
-- [ ] Reference reminders repeated 2-3 times?
-- [ ] "Do not invent new features" included?
-
-### 3. Chain Continuity
-- [ ] Chain status correct? (First Shot / Chained / Chain Break)
-- [ ] End frame designed for smooth continuation?
-- [ ] No extreme close-up trapping next shot?
-
-### 4. Output Format
-- [ ] Main shot: THREE code blocks (İLK FRAME + SON FRAME + VİDEO)?
-- [ ] Coverage: TWO code blocks each (image + video)?
-- [ ] 2-3 coverage sub-shots per main shot?
-- [ ] Each block contains ONLY prompt text?
-- [ ] All prompts copy-paste ready?
+```text
+Audio direction:
+- Language: [Original language of dialogue]
+- Type: [Dialogue/SFX/Ambience/Mixed]
+- Dialogue transcript: "[Exact lines]" or NONE
+- SFX: [Specific sound effects list]
+- Ambience: [Environmental sounds]
+- Music: NONE (unless strictly requested)
+- Mix target: Dialogue X%, SFX Y%, Ambience Z%
+- No on-screen subtitles/captions.
+```
 
 ---
 
-## Output Format
+## SCENARIO ANALYSIS
+
+### Genre Detection (ALL GENRES SUPPORTED)
+Detect genre (Drama, Action, Horror, Sci-Fi, etc.) and adapt camera/lighting style accordingly.
 
-For EACH shot, output exactly:
+### Dramaturgy (Dialogue Scenes)
+Analyze per character: **Objective**, **Obstacle**, **Stakes**, **Subtext**, **Beat Turn**.
+Embed this as physical behavior in the prompt, NOT as abstract metadata.
 
-```
 ---
 
-**SHOT[NN]** | [Duration]s | 🔗 [Status]
-
-**İLK FRAME (SHOTNN_START):**
-[If CHAINED: "→ Use SHOT[prev]_END as first frame"]
-[If FIRST/BREAK: code block with image prompt]
+## PRE-DELIVERY CHECKLIST
 
-**SON FRAME (SHOTNN_END):**
-[code block with image prompt - ALWAYS]
+Before outputting ANY shot:
 
-**VİDEO:**
-[code block with video prompt + audio direction]
+### 1. Safety & Anonymity (CRITICAL)
+- [ ] No real person's name? (Use physical descriptions)
+- [ ] No celebrity references?
+- [ ] No active violence/gore?
 
-**COVERAGE SHOTS (in same file):**
-[2-3 sub-shots, each with image + video code blocks]
+### 2. Prompt Structure
+- [ ] Follows 1-7 Flow Order?
+- [ ] Avoid Line present on EVERY prompt (Image + Video + Coverage)?
+- [ ] Audio Direction Block present on EVERY video prompt?
+- [ ] 2-3 Coverage shots included in the same file?
 
 ---
-```
 
-### Status Options
-- `FIRST SHOT` - First shot of project
-- `CHAINED from SHOT[prev]_END` - Continuing from previous
-- `CHAIN BREAK - [Reason]` - Location/time change
+## OUTPUT FORMAT
 
----
+For EACH shot, output exactly one file (`SHOTNN.md`) containing Main Shot + Coverage:
 
-## Failure Mode Recovery
+```markdown
+# SHOT[NN] | [Duration]s | 🎭 Tension: [1-5]
 
-| Failure | Recovery |
-|---------|----------|
-| Safety filter blocked | Apply safe reframe, add documentary framing |
-| Reference not matching | Add stronger "EXACTLY" language, repeat 3x |
-| Celebrity name detected | Remove ALL names, use physical descriptions |
-| Chain discontinuity | Declare CHAIN BREAK, generate new START |
-| Audio fail | Fall back to SFX + ambience only |
+## 🇹🇷 Türkçe Özet
+[1-2 cümle Türkçe açıklama]
 
----
+## Chain Status
+🔗 [FIRST SHOT / CHAINED from SHOT[prev]_END / CHAIN BREAK]
+
+## Main Shot
 
-## Final Reminders
+### İLK FRAME (SHOTNN_START)
+[If CHAINED: "→ Use SHOT[prev]_END as first frame"]
+[If FIRST/BREAK: Code block with Image Prompt (Flow Order + Avoid Line)]
 
-**DO:**
-- Ask batch size BEFORE generating
-- Start every prompt with [REFERENCE LOCK] when refs provided
-- Chain shots unless explicit CHAIN BREAK
-- Design end frames for smooth continuation
+### SON FRAME (SHOTNN_END)
+```
+[Image Prompt (Flow Order + Avoid Line)]
+avoid: blurry, low-res, text, watermark, bad anatomy, distorted face ...
+```
 
-**DON'T:**
-- NEVER mention celebrity/public figure names
-- Generate before asking batch size
-- Add characters/locations not specified
-- Claim 4K/8K resolution
-- Include active violence
+### VİDEO
+```
+[Video Prompt (Flow Order)]
 
----
+Audio direction:
+- Language: ...
+- ...
+- No on-screen subtitles.
 
-## 🎬 Hollywood Standard Cinematography
+avoid: blurry, low-res, text, watermark, bad anatomy, distorted face ...
+```
 
-### Visual Excellence Checklist
+---
 
-- [ ] **Composition:** Rule of thirds, golden ratio, leading lines applied
-- [ ] **Lighting:** Three-point setup, motivated sources, proper color temp
-- [ ] **Camera:** Professional movements, intentional lens selection
-- [ ] **Color:** Graded for mood, consistent palette
-- [ ] **Depth:** Foreground, midground, background layers
-- [ ] **Focus:** Selective focus for emphasis, rack focus for reveals
+## Coverage Shots (Kurgu Detayları)
 
-### Professional Terminology
+### SHOT[NN]A - [Type] | [Duration]s | [Icon] [Label]
+🇹🇷 [Özet]
+```
+[Image Prompt (Flow Order + Avoid Line)]
+```
+```
+[Video Prompt (Flow Order + Audio Block + Avoid Line)]
+```
 
-- **Movements:** dolly push-in, pull-out, crane rise/descend, orbit, tracking
-- **Stabilization:** gimbal smooth, handheld organic, Steadicam, locked tripod
-- **Lighting:** key, fill, rim/hair, practical, motivated, diffused
-- **Lenses:** wide (24mm), standard (50mm), portrait (85mm), telephoto (135mm+)
+### SHOT[NN]B ...
+[Same format]
 
 ---
+generated: [timestamp]
+```
+
+## Failure Mode Recovery
+- **Safety Blocked:** Reframe safely, use documentary style framing.
+- **Celeb Detected:** Remove name, describe physique (e.g., "tall man with beard").
+- **Audio Fail:** Fall back to SFX/Ambience only.
 
-> **Remember:** You are crafting HOLLYWOOD-GRADE cinema. Every frame museum-worthy. Every chain seamless. Every prompt technically precise and emotionally resonant. Production value is NON-NEGOTIABLE.
+> **Remember:** You are crafting HOLLYWOOD-GRADE cinema. Every frame museum-worthy. Every chain seamless. Every prompt technically precise.

package/content/workflows/generate.md

@@ -8,16 +8,16 @@ $ARGUMENTS
 
 ---
 
-## Task
-
-Generate production-ready shot prompts from scenario and **SAVE TO FILES**.
-
-## Scenario Source
-
-- Preferred scenario file: `$SCENARIO_HINT`
-- If an active/selected editor file exists, use it first.
-
----
+## Task
+
+Generate production-ready shot prompts from scenario and **SAVE TO FILES**.
+
+## Scenario Source
+
+- Preferred scenario file: `$SCENARIO_HINT`
+- If an active/selected editor file exists, use it first.
+
+---
 
 ## Output Directory Structure
 
@@ -69,8 +69,9 @@ For EACH shot:
    - Alt metin ve beat dönüşlerini planla
    - Oyunculuk davranışlarını prompt'a göm (MASTER.md TIER 0.5)
 3. **Generate main shot prompts** (İLK FRAME, SON FRAME, VİDEO)
-   - Image prompts: MIN 60 words + Avoid line
-   - Video prompts: MIN 80 words + Audio direction + Avoid line
+   - **MANDATORY FLOW:** Subject → Action → Camera → Light → Audio → Avoid
+   - **Avoid Line:** Her prompt'un sonunda ZORUNLU
+   - **Audio Block:** Her video prompt'unda ZORUNLU (Language, Type, Mix...)
    - **🇹🇷 Türkçe özet:** Her shot başlığına 1 cümlelik Türkçe özet yaz
 4. **Select coverage types** based on scene type:
    - Dialogue → Reaction (A) + OTS (B)
@@ -104,20 +105,34 @@ Each `$OUTPUT_DIR/shots/SHOTNN.md` file:
 ### İLK FRAME (SHOTNN_START)
 [If chained: "→ Use SHOT[prev]_END as first frame"]
 
-```
-[Image prompt - if first shot or chain break]
+```text
+[Image prompt — Flow Order: Scene > Who > Action > Camera > Light]
+avoid: blurry, low-res, text, watermark, bad anatomy, distorted face ...
 ```
 
 ### SON FRAME (SHOTNN_END)
 
-```
-[Image prompt - ALWAYS]
+```text
+[Image prompt — Flow Order: Scene > Who > Action > Camera > Light]
+avoid: blurry, low-res, text, watermark, bad anatomy, distorted face ...
 ```
 
 ### VİDEO
 
-```
-[Video prompt with audio direction]
+```text
+[Video prompt — Flow Order: Scene > Who > Action > Camera > Light]
+
+Audio direction:
+- Language: [Original language]
+- Type: [Dialogue/SFX/Ambience]
+- Dialogue transcript: "[Exact lines]"
+- SFX: [Specific sounds]
+- Ambience: [Environment]
+- Music: NONE
+- Mix target: Dialogue 80%, Ambience 20%
+- No on-screen subtitles.
+
+avoid: blurry, low-res, text, watermark, bad anatomy, distorted face ...
 ```
 
 ---
@@ -128,38 +143,20 @@ Each `$OUTPUT_DIR/shots/SHOTNN.md` file:
 
 🇹🇷 [Türkçe coverage özeti]
 
+```text
+[Coverage IMAGE prompt — Flow Order + Avoid Line]
 ```
-[Standalone image prompt — min 60 words + Avoid line]
-```
-```
-[Video prompt with audio direction — min 60 words + Avoid line]
+```text
+[Coverage VIDEO prompt — Flow Order + Audio Block + Avoid Line]
 ```
 
 ---
 
 ### SHOT[NN]B - [Type] | [Duration]s | [Icon] [Label]
-
-🇹🇷 [Türkçe coverage özeti]
-
-```
-[Standalone image prompt — min 60 words + Avoid line]
-```
-```
-[Video prompt with audio direction — min 60 words + Avoid line]
-```
-
----
+[Same format as A]
 
 ### SHOT[NN]C - [Type] | [Duration]s | [Icon] [Label] (optional)
-
-🇹🇷 [Türkçe coverage özeti]
-
-```
-[Standalone image prompt — min 60 words + Avoid line]
-```
-```
-[Video prompt with audio direction — min 60 words + Avoid line]
-```
+[Same format as A]
 
 ---
 Generated: [timestamp]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milenyumai/film-kit",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Hollywood-standard cinematic prompt engineering toolkit for Google Flow + Veo 3.1. Auto-configures AI agents (Cursor, Claude Code, VS Code Copilot, Antigravity) with production-grade shot generation system.",
   "type": "module",
   "main": "./build/index.js",