@milenyumai/film-kit 1.0.0

package/content/ARCHITECTURE.md

@@ -0,0 +1,132 @@
+# Film Prompt System Architecture
+
+> Professional Cinematic Prompt Engineering Toolkit for Google Flow + Veo 3.1
+
+---
+
+## 📋 Overview
+
+Modular system consisting of:
+
+- **1 Specialist Agent** - Technical Prompt Engineer
+- **7 Skills** - Domain-specific knowledge modules
+- **4 Workflows** - Slash command procedures
+
+---
+
+## 🏗️ Directory Structure
+
+```plaintext
+.agent/
+├── ARCHITECTURE.md          # This file
+├── MASTER.md                # Main rules (entry point for AI tools)
+├── agents/
+│   └── prompt-engineer.md   # Primary agent
+├── skills/
+│   ├── safety-compliance/   # Platform safety & celebrity ban
+│   ├── reference-locking/   # Reference image system
+│   ├── frame-chaining/      # Shot continuity protocol
+│   ├── coverage-system/     # Mandatory coverage shots (NEW)
+│   ├── visual-modes/        # Ultra Realism & style modes
+│   ├── audio-design/        # Sound design rules
+│   └── prompt-structure/    # Prompt engineering patterns
+└── workflows/
+    ├── generate.md          # /generate command
+    ├── chain.md             # /chain command
+    └── safety-check.md      # /safety-check command
+```
+
+---
+
+## 🤖 Agent
+
+| Agent | Focus | Skills Used |
+|-------|-------|-------------|
+| `prompt-engineer` | Cinematic prompt generation for Veo 3.1 | All 7 skills |
+
+---
+
+## 🧩 Skills (7)
+
+| Skill | Description |
+|-------|-------------|
+| `safety-compliance` | **Platform safety**, celebrity name prohibition, AUTO-ANONYMOUS (otomatik anonimleştirme), AUTO-SAFETY, safe framing, content restrictions |
+| `reference-locking` | **Reference image enforcement**, EXACTLY language, repeat protocol |
+| `frame-chaining` | **Shot continuity**, last frame → first frame chaining, scene transition protocol (fade, dissolve, match cut) |
+| `coverage-system` | **Mandatory coverage shots** (Reaction, OTS, Insert, Cutaway, ECU, Wide) + L-cut/J-cut + 30° kuralı + **180° kuralı** + eyeline match + matching action + multi-character blocking |
+| `visual-modes` | **Ultra Realism** default, stylization triggers, anti-AI artifact rules + **renk sürekliliği** + magic hour + flashback/rüya görsel ayrımı |
+| `audio-design` | **Sound design** rules, voice realism, SFX, ambience, audio direction block + diegetic/non-diegetic ses ayrımı |
+| `prompt-structure` | Image/video prompt templates, camera vocabulary, seed parameter, prompt rewriter, **re-take strategy**, coverage prompt yazım standartları (≥60 kelime) |
+
+---
+
+## 🔄 Workflows (4)
+
+| Command | Description |
+|---------|-------------|
+| `/generate` | Generate shots and SAVE TO FILES |
+| `/chain` | Continue from last shot file |
+| `/safety-check` | Validate prompts before delivery |
+| `/finish` | Complete project, create summary |
+
+---
+
+## 🎯 Skill Loading Protocol
+
+```plaintext
+User Scenario → Agent Activated → Load Required Skills
+                                       ↓
+                            safety-compliance (ALWAYS)
+                            reference-locking (if refs provided)
+                            frame-chaining (ALWAYS)
+                            coverage-system (ALWAYS - mandatory)
+                            visual-modes (check for style triggers)
+                            audio-design (if dialogue/SFX needed)
+                            prompt-structure (ALWAYS)
+```
+
+---
+
+## 📊 Scenario Type Support
+
+| Type | Camera Style | Lighting | Duration |
+|------|--------------|----------|----------|
+| **DRAMA/INTIMATE** | Close-ups, shallow DOF | Soft key light | 8s |
+| **ACTION/THRILLER** | Dynamic, shake | High energy | 4s |
+| **HISTORICAL/PERIOD** | Documentary touch | Period-accurate | 8s |
+| **WAR/MILITARY** | Wide + close alternating | Harsh, dramatic | 8s |
+| **NATURE/DOCUMENTARY** | Wide angle, telephoto | Natural, golden hour | 8s |
+| **MUSICAL/PERFORMANCE** | Choreography-matched | Stage lighting | 8s |
+| **COMMERCIAL/AD** | Premium, gimbal smooth | Rim light, clean | 8s |
+| **HORROR/SUSPENSE** | Negative space, POV | Low-key, unsettling | 8s |
+| **COMEDY** | Clear sightlines | Bright, even | 8s |
+| **ROMANCE** | Two-shots, soft focus | Warm, soft | 8s |
+
+---
+
+## 🔗 Priority Hierarchy
+
+| Priority | Rule |
+|----------|------|
+| **P0** | Platform Safety (overrides everything) |
+| **P1** | Reference Fidelity (use refs EXACTLY) |
+| **P2** | Chain Continuity (mandatory chaining) |
+| **P3** | Story Integrity (user scenario fidelity) |
+| **P4** | Visual Quality (Ultra Realism/mode) |
+| **P5** | Technical Optimization |
+| **P6** | User Preference |
+
+---
+
+## 📖 Quick Start
+
+1.  Load `MASTER.md` as system prompt in your AI tool
+2.  Provide your scenario
+3.  Share reference images for key characters
+4.  Specify batch size (1-10 shots)
+5.  Start generating
+
+---
+
+**Version:** 1.3.0 | **Platform:** Google Veo 3.1 | **Method:** Start Frame → End Frame → Video (EXTEND KULLANILMAZ)
+> **Remember:** This system generates ENGLISH prompts optimized for Google Veo 3.1. Turkish headers are used for organization only.

package/content/FILM-KIT-INFO.md

@@ -0,0 +1,116 @@
+# 🎬 Film-Kit Kullanım Kılavuzu
+
+> Google Flow + Veo 3.1 için Hollywood standartında sinematik prompt mühendisliği
+
+---
+
+## 🚀 Hızlı Başlangıç
+
+1. **Editörünüzü açın** (Cursor, VS Code, Antigravity)
+2. Bu projeyi açın
+3. AI'ya bir film senaryosu verin
+4. Hollywood kalitesinde promptlar alın!
+
+---
+
+## 📁 Dosya Yapısı
+
+```
+.agent/                    ← Ana sistem klasörü
+├── MASTER.md              ← Tüm kuralların merkezi
+├── ARCHITECTURE.md        ← Sistem haritası
+├── agents/                ← Uzman ajanlar
+│   └── prompt-engineer.md ← Ana prompt üretici
+├── skills/                ← Modüler yetenekler (7 adet)
+│   ├── safety-compliance/ ← Güvenlik kuralları
+│   ├── reference-locking/ ← Referans görsel kilitleme
+│   ├── frame-chaining/    ← Kare zincirleme
+│   ├── coverage-system/   ← Detay çekimleri (YENİ!)
+│   ├── visual-modes/      ← Görsel modlar
+│   ├── audio-design/      ← Ses tasarımı
+│   └── prompt-structure/  ← Prompt şablonları
+└── workflows/             ← İş akışları
+    ├── generate.md        ← /generate komutu
+    ├── chain.md           ← /chain komutu
+    ├── safety-check.md    ← /safety-check komutu
+    └── finish.md          ← /finish komutu
+
+RULES.md                   ← AI editörler için kurallar (otomatik okunur)
+```
+
+---
+
+## 🎯 Temel Komutlar
+
+| Komut | Ne Yapar |
+|-------|----------|
+| `/generate` | Senaryodan shot'lar üretir, dosyaya kaydeder |
+| `/chain` | Önceki shot'tan devam eder |
+| `/safety-check` | Tüm promptları güvenlik kontrolünden geçirir |
+| `/finish` | Projeyi tamamlar, özet oluşturur |
+
+---
+
+## 📝 Senaryo Verme Örneği
+
+```
+Bir Çanakkale Savaşı sahnesi istiyorum:
+
+1. Sığınakta dua eden askerler
+2. Subay telefonda: "Anladım paşam. Hemen harekete geçiyoruz."
+3. Subay askerlere: "Kalkın aslanlar! Düşman zırhlıları top menziline giriyorlar!"
+4. Askerler koşarak tabya mevzilerine çıkıyor
+5. Subay dürbünle bakıyor: "Bekle, bekle... Şimdi! Ateş serbest!"
+6. Toplar ateş açıyor
+
+Referans görseller:
+- subay.jpg → Subay karakteri
+- askerler.jpg → Askerlerin kıyafetleri
+```
+
+---
+
+## ⚠️ Önemli Kurallar
+
+### 1. Ünlü İsimleri YASAK
+- ❌ "Atatürk benzeri bir adam"
+- ✅ "50'li yaşlarda, keskin yüz hatları, kısa gri saçlı, mavi gözlü, koyu takım elbiseli bir adam"
+
+### 2. Referans Görseller
+- AI, verdiğiniz referans görselleri **birebir** kullanır
+- Her shot'ta `[REFERENCE LOCK]` ile kilitleme yapılır
+
+### 3. Diyaloglar
+- Türkçe yazdığınız diyaloglar Türkçe kalır
+- AI çevirmez, aynen kullanır
+
+### 4. Süre
+- Varsayılan süre: **8 saniye**
+- Kısa aksiyon: 4-6 saniye
+
+---
+
+## 🎥 Desteklenen Türler
+
+Drama, Komedi, Aksiyon, Korku, Bilim Kurgu, Romantik, Fantastik, 
+Tarihi, Belgesel, Gerilim, Müzikal, Western, Noir, Animasyon...
+
+---
+
+## 🔄 Güncelleme
+
+```bash
+npx @bakiacikgoz/film-kit update
+```
+
+---
+
+## 📖 Daha Fazla Bilgi
+
+- Ana kurallar: `.agent/MASTER.md`
+- Sistem haritası: `.agent/ARCHITECTURE.md`
+- NPM: https://www.npmjs.com/package/@bakiacikgoz/film-kit
+
+---
+
+**İyi çekimler!** 🎬