@milenyumai/film-kit 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +18 -5
  2. package/build/lib/templates.js +16 -0
  3. package/content/agents/prompt-engineer.md +14 -10
  4. package/content/workflows/generate.md +31 -10
  5. package/package.json +2 -2
package/README.md CHANGED
@@ -6,6 +6,13 @@
6
6
  1. **Film-Kit (Core):** Tek ajanlı, manuel kontrollü üretim.
7
7
  2. **Film-Kit Multi (Pro):** Çok ajanlı, paralel üretim ve uzman denetimi.
8
8
 
9
+ ## 🧱 Repository Modeli (Tek Repo)
10
+ Bu proje **tek GitHub repository (monorepo)** olarak yönetilir:
11
+ - Core paket: repo kökü (`@milenyumai/film-kit`)
12
+ - Multi paket: `packages/multi` (`@milenyumai/film-kit-multi`)
13
+
14
+ Yani kaynak kod için tek "source of truth" vardır: `film-kit` reposu.
15
+
9
16
  ---
10
17
 
11
18
  ## 📦 Paket 1: Film-Kit (Core)
@@ -34,6 +41,7 @@ Tek bir ajan ("Prompt Engineer") senaryoyu okur, analiz eder ve shotları sıray
34
41
 
35
42
  ## 🚀 Paket 2: Film-Kit Multi (Pro)
36
43
  **Kullanım:** Profesyonel stüdyo işleri, uzun metraj, 10+ shot senaryolar.
44
+ **Platformlar:** Claude Code Agent Teams + Antigravity Mission Control
37
45
 
38
46
  ### Kurulum (Tek Komut)
39
47
  Boş bir klasörde terminali açın:
@@ -44,10 +52,16 @@ npx @milenyumai/film-kit-multi init
44
52
  ### Kullanım
45
53
  Claude Code içinde:
46
54
  ```text
47
- /generate-multi
55
+ /generate
48
56
  ```
49
57
  **Lead Director** ajanı ekibi kurar ve yönetir.
50
58
 
59
+ Antigravity içinde:
60
+ - Skill: `.agent/skills/shotforge-generate/SKILL.md`
61
+ - Alias: `.agent/skills/shotforge-generate-multi/SKILL.md`
62
+ - Çalışma şekli: Mission Control'de Lead + paralel Shot Generator + Specialist quality gates
63
+ - Not: Skill içinde copy-paste Lead/Worker/Specialist görev şablonları ve hard quality gate bulunur.
64
+
51
65
  **Süreç:**
52
66
  1. **Planning:** Lead Director senaryoyu analiz eder, `team-plan.json` oluşturur.
53
67
  2. **Casting:** İhtiyaca göre 5'e kadar **Shot Generator** ajanı spawn eder.
@@ -64,11 +78,10 @@ Claude Code içinde:
64
78
 
65
79
  | Komut | Paket | İşlev |
66
80
  |-------|-------|-------|
67
- | `/generate` | Core | Tek ajanla sıralı üretim başlatır. |
68
- | `/generate-multi` | Multi | Multi-ajan takımıyla paralel üretim başlatır. |
81
+ | `/generate` | Core / Multi | Kurulu moda göre tekli veya multi üretim başlatır. |
69
82
  | `/chain` | Her İkisi | Son üretilen shot'ın bitiş karesinden devam eder. |
70
83
  | `/finish` | Her İkisi | Projeyi sonlandırır ve `FINAL-SUMMARY.md` yazar. |
71
- | `/recover` | Multi | Başarısız batch'leri veya kalite kontrol takılanları onarır. |
84
+ | `/recover` | Her İkisi | Başarısız üretimleri veya kalite kontrol takılanlarını onarır. |
72
85
  | `/safety-check` | Her İkisi | Manuel güvenlik taraması yapar. |
73
86
 
74
87
  ---
@@ -87,7 +100,7 @@ Claude Code içinde:
87
100
  ---
88
101
 
89
102
  ## 🛠 Gereksinimler
90
- - **Node.js:** v18+
103
+ - **Node.js:** v20+
91
104
  - **Claude Code:** `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` (Sadece Multi için)
92
105
  - **Editör:** VS Code, Cursor veya Terminal
93
106
 
package/build/lib/templates.js CHANGED
@@ -625,6 +625,22 @@ Before generating ANY prompts, read these skills:
625
625
  10. **ILK/İLK FRAME:** always keep fenced code block
626
626
  11. **ONE FILE PER SHOT:** SHOTNN.md contains main shot + all coverage
627
627
 
628
+ ## Quality Floor (Hard Gate)
629
+ Reject and regenerate any shot that fails:
630
+ - ILK FRAME < 80 words
631
+ - SON FRAME < 80 words
632
+ - VIDEO < 120 words
633
+ - any coverage prompt < 70 words
634
+ - missing explicit lens/framing/camera movement details
635
+ - missing explicit lighting direction/intensity/atmosphere details
636
+ - missing explicit foreground/midground/background action details
637
+
638
+ ## Reject Weak Prompt Style
639
+ Do not accept generic filler language:
640
+ - "cinematic shot", "high quality", "realistic", "epic" without concrete visual details
641
+ - camera mentions without lens/framing values
642
+ - atmosphere mentions without physical cues (smoke, dust, debris, wind, moisture)
643
+
628
644
  ## Quality Standard
629
645
  HOLLYWOOD PRODUCTION GRADE — Every frame museum-worthy, every chain seamless.
630
646
  `;
package/content/agents/prompt-engineer.md CHANGED
@@ -35,11 +35,13 @@ You are a senior Technical Prompt Engineer specialized in Google Flow + Veo 3.1.
35
35
  7. Use 8-second shot duration (default), slow burn, reaction shots
36
36
  8. Dramatürji iskeleti uygula: Amaç, Engel, Risk, Alt metin, Beat
37
37
  9. Oyunculuk davranışlarını prompt'a göm (kuru bilgi değil)
38
- 10. **Generate mandatory coverage shots with MINIMUM 60 WORDS per prompt**
39
- 11. 180° kuralı: Kamera ekseni aşılmaz; eyeline match tutarlılığı
40
- 12. **HER prompt'ta Avoid satırı ZORUNLU (❗ coverage dahil)**
41
- 13. **🇹🇷 Türkçe özet: Her shot ve coverage için 1 cümlelik Türkçe özet ekle**
42
- 14. Emotional arc: Film genelinde gerilim eğrisi (1-5) uygula
38
+ 10. **Generate mandatory coverage shots with MINIMUM 60 WORDS per prompt**
39
+ 11. 180° kuralı: Kamera ekseni aşılmaz; eyeline match tutarlılığı
40
+ 12. **HER prompt'ta Avoid satırı ZORUNLU (❗ coverage dahil)**
41
+ 13. **🇹🇷 Türkçe özet: Her shot ve coverage için 1 cümlelik Türkçe özet ekle**
42
+ 14. Emotional arc: Film genelinde gerilim eğrisi (1-5) uygula
43
+ 15. **Hard quality floor:** ILK >=80, SON >=80, VIDEO >=120, coverage >=70 kelime
44
+ 16. **Hard specificity floor:** Her promptta lens/framing, lighting ve FG/MG/BG action detayları zorunlu
43
45
 
44
46
  ---
45
47
 
@@ -134,11 +136,13 @@ Before outputting ANY shot:
134
136
  - [ ] No celebrity references?
135
137
  - [ ] No active violence/gore?
136
138
 
137
- ### 2. Prompt Structure
138
- - [ ] Follows 1-7 Flow Order?
139
- - [ ] Avoid Line present on EVERY prompt (Image + Video + Coverage)?
140
- - [ ] Audio Direction Block present on EVERY video prompt?
141
- - [ ] 2-3 Coverage shots included in the same file?
139
+ ### 2. Prompt Structure
140
+ - [ ] Follows 1-7 Flow Order?
141
+ - [ ] Avoid Line present on EVERY prompt (Image + Video + Coverage)?
142
+ - [ ] Audio Direction Block present on EVERY video prompt?
143
+ - [ ] 2-3 Coverage shots included in the same file?
144
+ - [ ] Quality floor passes? (ILK>=80, SON>=80, VIDEO>=120, coverage>=70)
145
+ - [ ] Specificity floor passes? (lens + lighting + FG/MG/BG action)
142
146
 
143
147
  ---
144
148
 
package/content/workflows/generate.md CHANGED
@@ -77,10 +77,19 @@ For EACH shot:
77
77
  3. Generate main shot prompts (`ILK/İLK FRAME`, `SON FRAME`, `VIDEO`).
78
78
  4. `ILK/İLK FRAME` section MUST always include a fenced code block.
79
79
  5. If chained, first-frame code block must explicitly state: `Use SHOT[prev]_END as exact first frame`.
80
- 6. Generate coverage prompts (2-3 per main shot, min 60 words each).
81
- 7. Add Turkish summary for shot and each coverage section.
82
- 8. Write shot file: `$OUTPUT_DIR/shots/SHOT[NN].md`.
83
- 9. Update `$OUTPUT_DIR/_index.md`.
80
+ 6. Enforce hard quality floor:
81
+ - `ILK FRAME`: minimum 80 words
82
+ - `SON FRAME`: minimum 80 words
83
+ - `VIDEO`: minimum 120 words
84
+ - each coverage prompt: minimum 70 words
85
+ 7. Enforce specificity floor on every prompt:
86
+ - explicit lens/framing/camera movement
87
+ - explicit lighting direction/intensity/atmosphere
88
+ - explicit foreground/midground/background action details
89
+ 8. Generate coverage prompts (2-3 per main shot, min 70 words each).
90
+ 9. Add Turkish summary for shot and each coverage section.
91
+ 10. Write shot file: `$OUTPUT_DIR/shots/SHOT[NN].md`.
92
+ 11. Update `$OUTPUT_DIR/_index.md`.
84
93
 
85
94
  ### 4. Validation Pass (Mandatory Before Completion)
86
95
 
@@ -95,7 +104,8 @@ For EACH shot:
95
104
  - `file_completeness_status`
96
105
  - `packaging_status`
97
106
  - `blockers`
98
- 4. Do not finalize if any report is fail or missing.
107
+ 4. Reject any shot output that passes while violating quality floor or specificity floor.
108
+ 5. Do not finalize if any report is fail or missing.
99
109
 
100
110
  ---
101
111
 
@@ -117,7 +127,7 @@ FIRST SHOT / CHAINED from SHOT[prev]_END / CHAIN BREAK - Reason
117
127
  ### ILK FRAME (SHOTNN_START)
118
128
 
119
129
  ```text
120
- [Image prompt - min 60 words, Flow Order]
130
+ [Image prompt - min 80 words, Flow Order]
121
131
  [If chained: include "Use SHOT[prev]_END as exact first frame"]
122
132
  Avoid: blurry, low-res, text, watermark, bad anatomy, distorted face ...
123
133
  ```
@@ -125,14 +135,14 @@ Avoid: blurry, low-res, text, watermark, bad anatomy, distorted face ...
125
135
  ### SON FRAME (SHOTNN_END)
126
136
 
127
137
  ```text
128
- [Image prompt - min 60 words, Flow Order]
138
+ [Image prompt - min 80 words, Flow Order]
129
139
  Avoid: blurry, low-res, text, watermark, bad anatomy, distorted face ...
130
140
  ```
131
141
 
132
142
  ### VIDEO
133
143
 
134
144
  ```text
135
- [Video prompt - min 80 words, Flow Order]
145
+ [Video prompt - min 120 words, Flow Order]
136
146
 
137
147
  Audio direction:
138
148
  - Language: [Original language]
@@ -155,12 +165,12 @@ Avoid: blurry, low-res, text, watermark, bad anatomy, distorted face ...
155
165
  TR: [coverage summary]
156
166
 
157
167
  ```text
158
- [Coverage IMAGE prompt - min 60 words]
168
+ [Coverage IMAGE prompt - min 70 words]
159
169
  Avoid: ...
160
170
  ```
161
171
 
162
172
  ```text
163
- [Coverage VIDEO prompt - min 60 words + full audio block]
173
+ [Coverage VIDEO prompt - min 70 words + full audio block]
164
174
  Avoid: ...
165
175
  ```
166
176
 
@@ -189,6 +199,17 @@ Tamamlama icin: '/finish'
189
199
 
190
200
  ---
191
201
 
202
+ ## Reject Weak Prompt Style
203
+
204
+ Do not accept outputs that rely on generic filler language:
205
+
206
+ - "cinematic shot", "high quality", "epic", "realistic" without concrete visual specifics
207
+ - camera mentions without lens/framing values
208
+ - atmosphere mentions without physical cues (smoke, dust, debris, wind, moisture)
209
+ - flat scene descriptions that omit foreground/midground/background action
210
+
211
+ ---
212
+
192
213
  ## Resume Capability
193
214
 
194
215
  When user says "devam et":
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@milenyumai/film-kit",
3
- "version": "1.0.4",
3
+ "version": "1.0.5",
4
4
  "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.",
5
5
  "type": "module",
6
6
  "main": "./build/index.js",
@@ -61,4 +61,4 @@
61
61
  "typescript": "^5.7.3",
62
62
  "vitest": "^3.0.7"
63
63
  }
64
- }
64
+ }