Film-Kit: Hollywood-Standard Cinematic Prompt Engineering

Film-Kit, model-seçilebilir sinematik prompt mühendisliği ajanlarını (Claude Code, Cursor, VS Code Copilot, Antigravity) projenize kuran bir araç setidir.

İki versiyonu vardır:

1. Film-Kit (Core): Tek ajanlı, manuel kontrollü üretim.
2. Film-Kit Multi (Pro): Çok ajanlı, paralel üretim ve uzman denetimi.

🧱 Repository Modeli (Tek Repo)

Bu proje tek GitHub repository (monorepo) olarak yönetilir:

• Core paket: repo kökü (@milenyumai/film-kit)
• Multi paket: packages/multi (@milenyumai/film-kit-multi)

Yani kaynak kod için tek "source of truth" vardır: film-kit reposu.

🎯 Model Desteği

| Model ID | Durum | Not | |----------|-------|-----| | veo31 | ✅ Destekleniyor | Flow/Veo prompt akışı, Image-to-Video, Re-Take Strategy | | kling-3.0 | ✅ Destekleniyor | Start+End, Multi-Shot (2-6), Element Binding, vCoT, Native Audio |

Soft geçiş politikası:

• --model verilmezse geçici olarak veo31 atanır.
• CLI bir deprecation warning basar: gelecek major sürümde model zorunlu olacak.
• Alternatif: FILM_KIT_MODEL=kling-3.0 environment variable ile default ayarlanabilir.

Kling preset:

• Varsayılan: ultra-realism
• Varsayılan CFG hedefi: 0.45

v1.2.0 — Yeni Özellikler

Kling 3.0:

• Golden Prompt Skeleton (6-step Start+End)
• 3 copy-paste template (Minimal Realism, Swap, Loop)
• Multi-Shot Protocol (2-6 shots, Shot X, prefix)
• Element Binding (karakter/nesne tutarlılığı)
• Advanced Camera (vCoT triggers: Dolly Zoom, Dutch angle, Bird's-eye)
• Native Audio (tonlama, lip sync, narrative SFX)
• Troubleshooting guide + 10-point checklist

Veo 3.1:

• Image-to-Video entropy rule (stil tekrarı yok)
• Re-Take Strategy table (7 hata tipi + seed yönetimi)

📦 Paket 1: Film-Kit (Core)

Kullanım: Bireysel projeler, öğrenme, <10 shot senaryolar. Platformlar: Claude Code + Cursor + Copilot + Antigravity

Kurulum (Tek Komut)

Boş bir klasörde terminali açın:

npx @milenyumai/film-kit init
npx @milenyumai/film-kit init --model veo31
npx @milenyumai/film-kit init --model kling-3.0 --kling-preset ultra-realism

Kullanım

Claude Code içinde:

/generate

Tek bir ajan ("Prompt Engineer") senaryoyu okur, analiz eder ve shotları sırayla üretir.

Antigravity içinde:

• Skill: .agent/skills/shotforge-generate/SKILL.md
• Çalışma şekli: tek ajanlı, yüksek kontrol, shot-by-shot üretim

Özellikler:

• Veo 3.1 Prompt Flow (Subject > Action > Camera > Light)
• Kling 3.0 Start+End geçiş kuralları (model-profile üzerinden)
• Profesyonel Audio Blocks (Dialogue, SFX, Mix)
• Zorunlu Avoid Line
• Auto-Safety & Auto-Anonymous
• Hard Quality Gate: ILK>=80, SON>=80, VIDEO>=120, Coverage>=70 kelime
• Specificity Gate: lens + ışık + FG/MG/BG aksiyon detayı zorunlu

🚀 Paket 2: Film-Kit Multi (Pro)

Kullanım: Profesyonel stüdyo işleri, uzun metraj, 10+ shot senaryolar. Platformlar: Claude Code Agent Teams + Antigravity Mission Control

Kurulum (Tek Komut)

Boş bir klasörde terminali açın:

npx @milenyumai/film-kit-multi init
npx @milenyumai/film-kit-multi init --model veo31
npx @milenyumai/film-kit-multi init --model kling-3.0 --kling-preset ultra-realism

Kullanım

Claude Code içinde:

/generate

Lead Director ajanı ekibi kurar ve yönetir.

Antigravity içinde:

• Skill: .agent/skills/shotforge-generate/SKILL.md
• Alias: .agent/skills/shotforge-generate-multi/SKILL.md
• Çalışma şekli: Mission Control'de Lead + paralel Shot Generator + Specialist quality gates
• Not: Skill içinde copy-paste Lead/Worker/Specialist görev şablonları ve hard quality gate bulunur.

Süreç:

1. Planning: Lead Director senaryoyu analiz eder, team-plan.json oluşturur.
2. Casting: İhtiyaca göre 5'e kadar Shot Generator ajanı spawn eder.
3. Execution: Ajanlar shotları hard quality gate ile paralel üretir (ILK>=80, SON>=80, VIDEO>=120, Coverage>=70).
4. Validation: 3 Uzman Ajan devreye girer:
   • continuity-editor: Zincirleme (chain) hatalarını yakalar.
   • safety-auditor: Güvenlik ve anonimlik ihlallerini tarar.
   • delivery-editor: Dosya bütünlüğünü ve formatı denetler.
5. Recovery: Hata varsa /recover workflow'u otomatik düzeltir.

⚙️ Config Dosyaları

Core (shotforge-agent.config.json):

{
  "outputDir": "./outputs",
  "scenarioHint": "scenario.md",
  "model": "kling-3.0",
  "klingPreset": "ultra-realism"
}

Multi (film-kit-multi.config.json):

{
  "outputDir": "./outputs",
  "scenarioHint": "scenario.md",
  "model": "kling-3.0",
  "klingPreset": "ultra-realism",
  "maxTeammates": 5,
  "batchSize": 4
}

⚡ Komut Referansı (Slash Commands)

| Komut | Paket | İşlev | |-------|-------|-------| | /generate | Core / Multi | Kurulu moda göre tekli veya multi üretim başlatır. | | /chain | Her İkisi | Son üretilen shot'ın bitiş karesinden devam eder. | | /finish | Her İkisi | Projeyi sonlandırır ve FINAL-SUMMARY.md yazar. | | /recover | Her İkisi | Başarısız üretimleri veya kalite kontrol takılanlarını onarır. | | /safety-check | Her İkisi | Manuel güvenlik taraması yapar. |

🆚 Karşılaştırma

| Özellik | Film-Kit (Core) | Film-Kit Multi (Pro) | |---------|-----------------|----------------------| | Mimari | Tek Ajan | Lead + Teammates + Specialists | | Hız (20 Shot) | ~60 dk | ~20 dk (Paralel) | | Kalite Gate | Hard prompt gate | Hard prompt gate + specialist gate | | Tutarlılık | Manuel Kontrol | continuity-editor Denetimi | | Güvenlik | Prompt İçi Filtre | safety-auditor Taraması | | Planlama | Yok | team-plan.json Kontratlı | | Recovery | Manuel | Otomatik /recover |

🛠 Gereksinimler

• Node.js: v20+
• Claude Code: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 (Sadece Multi için)
• Editör/Platform: VS Code, Cursor, Claude Code veya Antigravity

📄 Lisans

MIT