@milenyumai/film-kit 1.0.0

package/build/lib/templates.js

@@ -0,0 +1,583 @@
+export function buildProjectFiles(config) {
+    const files = {};
+    if (config.includeAgentsMd) {
+        files["AGENTS.md"] = buildAgentsMd(config);
+    }
+    if (config.platforms.includes("cursor")) {
+        files[".cursorrules"] = buildCursorLegacyRules(config);
+        files[".cursor/rules/global.mdc"] = buildCursorMdcRules(config);
+    }
+    if (config.platforms.includes("claude")) {
+        files["CLAUDE.md"] = buildClaudeRoot(config);
+        files[".claude/CLAUDE.md"] = buildClaudeLocal(config);
+        files[".claude/rules/generate-flow.md"] = buildClaudeRuleGenerateFlow(config);
+        files[".claude/rules/output-contract.md"] = buildClaudeRuleOutputContract(config);
+        files[".claude/settings.json"] = buildClaudeSettings();
+        files[".claude/settings.local.json"] = buildClaudeSettingsLocal();
+    }
+    if (config.platforms.includes("copilot")) {
+        files[".github/copilot-instructions.md"] = buildCopilotInstructions(config);
+        files[".github/instructions/shotforge.instructions.md"] = buildCopilotScopedInstructions(config);
+    }
+    if (config.platforms.includes("antigravity")) {
+        files[".agent/skills/shotforge-generate/SKILL.md"] = buildAntigravitySkill(config);
+    }
+    return files;
+}
+/* ---------- AGENTS.md ---------- */
+function buildAgentsMd(config) {
+    return `# Film-Kit Agent Contract — Hollywood Standard
+
+> Professional Cinematic Prompt Engineering for Google Flow + Veo 3.1
+
+## System Architecture
+
+This project uses the **Film-Kit** prompt engineering system.
+All rules, skills, and workflows are located under \`.agent/\`.
+
+### Entry Points
+- **Master Rules:** \`.agent/MASTER.md\` — Complete production ruleset (690 lines)
+- **Architecture:** \`.agent/ARCHITECTURE.md\` — System map & quick reference
+- **Agent:** \`.agent/agents/prompt-engineer.md\` — Senior prompt engineer agent
+
+### Skills (7 modules)
+| Skill | Path | Priority |
+|-------|------|----------|
+| Safety Compliance | \`.agent/skills/safety-compliance/SKILL.md\` | P0 — ALWAYS |
+| Reference Locking | \`.agent/skills/reference-locking/SKILL.md\` | P1 — When refs provided |
+| Frame Chaining | \`.agent/skills/frame-chaining/SKILL.md\` | P2 — ALWAYS |
+| Coverage System | \`.agent/skills/coverage-system/SKILL.md\` | P2 — ALWAYS (mandatory) |
+| Visual Modes | \`.agent/skills/visual-modes/SKILL.md\` | P4 — ALWAYS |
+| Audio Design | \`.agent/skills/audio-design/SKILL.md\` | P4 — When dialogue/SFX |
+| Prompt Structure | \`.agent/skills/prompt-structure/SKILL.md\` | P5 — ALWAYS |
+
+### Workflows (slash commands)
+| Command | Workflow File |
+|---------|---------------|
+| \`/generate\` | \`.agent/workflows/generate.md\` |
+| \`/chain\` | \`.agent/workflows/chain.md\` |
+| \`/safety-check\` | \`.agent/workflows/safety-check.md\` |
+| \`/finish\` | \`.agent/workflows/finish.md\` |
+
+## Goal
+When the user asks \`/generate\`, convert the scenario into:
+- \`${config.outputDir}/project-info.md\` — Characters, settings, arc mapping
+- \`${config.outputDir}/shots/SHOT01.md, SHOT02.md, ...\` — Production shot files (with coverage included)
+- \`${config.outputDir}/_index.md\` — Shot list with chain & status tracking
+
+## Input
+- Preferred scenario file: \`${config.scenarioHint}\`
+- If there is an active/selected markdown file in editor, use that first.
+
+## Output Contract
+Each \`SHOTNN.md\` is a **single file** containing ALL shot details:
+- 🔗 Chain status (FIRST / CHAINED / CHAIN BREAK)
+- İLK FRAME (start frame image prompt — min 60 words)
+- SON FRAME (end frame image prompt — min 60 words)
+- VİDEO (video prompt with audio direction — min 80 words)
+- COVERAGE SHOTS (2-3 coverage shots within same file — each min 60 words)
+- 🇹🇷 Turkish summary for each section
+- Avoid line on EVERY prompt
+
+## Critical Rules
+- **AUTO-ANONYMOUS:** Replace ALL real person names with physical descriptions automatically
+- **AUTO-SAFETY:** Proactively reframe content that may trigger safety filters
+- **Frame Chaining:** Last frame of SHOT[N] = First frame of SHOT[N+1]
+- **Coverage Mandatory:** Every main shot includes 2-3 coverage sub-shots in same file
+- **Music: NONE** by default (user must explicitly request)
+- **SLOW BURN:** 8-second duration, split actions into multiple shots
+`;
+}
+/* ---------- CURSOR ---------- */
+function buildCursorLegacyRules(config) {
+    return `# Film-Kit Rules — Hollywood Standard Cinematic Prompt Engineering
+# Google Flow + Veo 3.1 | ALL GENRES SUPPORTED
+
+## CRITICAL: SKILL LOADING PROTOCOL
+Before generating ANY prompts, read the appropriate skill files from .agent/skills/:
+
+| Skill | Path | When |
+|-------|------|------|
+| Safety & Celebrity Ban | .agent/skills/safety-compliance/SKILL.md | ALWAYS |
+| Reference Locking | .agent/skills/reference-locking/SKILL.md | When refs provided |
+| Frame Chaining | .agent/skills/frame-chaining/SKILL.md | Multi-shot projects |
+| Coverage System | .agent/skills/coverage-system/SKILL.md | ALWAYS (mandatory) |
+| Visual Modes | .agent/skills/visual-modes/SKILL.md | All visual work |
+| Audio Design | .agent/skills/audio-design/SKILL.md | Dialogue/SFX needed |
+| Prompt Structure | .agent/skills/prompt-structure/SKILL.md | ALWAYS |
+
+## UNIVERSAL RULES
+1. AUTO-ANONYMOUS: Replace ALL real person names with physical descriptions. NEVER use celebrity names.
+2. AUTO-SAFETY: Proactively reframe content that may trigger safety filters.
+3. Prompts ALWAYS in English. Headers in Turkish allowed. Dialogue preserved in original language.
+4. SLOW BURN: 8s default duration. Split actions into multiple shots. "Ilmek ilmek islemek."
+5. Music: NONE by default. User must explicitly request.
+6. EVERY prompt must have an Avoid line. No exceptions.
+7. Coverage shots mandatory (2-3 per main shot, min 60 words each, included in same file).
+8. Frame chaining: Last frame of SHOT[N] = First frame of SHOT[N+1].
+9. ONE FILE PER SHOT: Each SHOTNN.md contains main shot + all coverage shots.
+
+## WORKFLOWS
+- /generate → Read .agent/workflows/generate.md
+- /chain → Read .agent/workflows/chain.md
+- /safety-check → Read .agent/workflows/safety-check.md
+- /finish → Read .agent/workflows/finish.md
+
+## OUTPUT
+- Scenario: ${config.scenarioHint}
+- Output: ${config.outputDir}/shots/SHOTNN.md (single file per shot with coverage)
+- Full rules: .agent/MASTER.md
+- Architecture: .agent/ARCHITECTURE.md
+`;
+}
+function buildCursorMdcRules(config) {
+    return `---
+description: Film-Kit production rules for Google Flow + Veo 3.1
+globs:
+alwaysApply: true
+---
+
+# Film-Kit — Hollywood Standard Prompt Engineering
+
+## Entry Point
+Read \`.agent/MASTER.md\` for complete production ruleset.
+Read \`.agent/ARCHITECTURE.md\` for system overview.
+
+## SKILL LOADING (MANDATORY)
+Before generating ANY prompts:
+1. ALWAYS load: safety-compliance, frame-chaining, coverage-system, prompt-structure, visual-modes
+2. Load if refs provided: reference-locking
+3. Load if dialogue/SFX: audio-design
+
+All skills at: \`.agent/skills/[name]/SKILL.md\`
+
+## Slash Commands
+| Command | Action |
+|---------|--------|
+| /generate | Generate shots → Read \`.agent/workflows/generate.md\` |
+| /chain | Continue from last → Read \`.agent/workflows/chain.md\` |
+| /safety-check | Validate prompts → Read \`.agent/workflows/safety-check.md\` |
+| /finish | Complete project → Read \`.agent/workflows/finish.md\` |
+
+## CRITICAL RULES
+- AUTO-ANONYMOUS: Replace ALL real names with physical descriptions
+- AUTO-SAFETY: Proactively reframe sensitive content
+- Frame chaining: Last frame SHOT[N] = First frame SHOT[N+1]
+- Coverage: 2-3 sub-shots per main shot (min 60 words each, in same file)
+- Avoid line: MANDATORY on every prompt
+- Music: NONE by default
+- Duration: 8s default, slow burn pacing
+- ONE FILE PER SHOT: SHOTNN.md contains everything
+
+## Output
+- Scenario source: ${config.scenarioHint}
+- Output directory: ${config.outputDir}
+- Per-shot format: ${config.outputDir}/shots/SHOTNN.md
+`;
+}
+/* ---------- CLAUDE ---------- */
+function buildClaudeRoot(config) {
+    return `# CLAUDE.md — Film-Kit (Hollywood Standard)
+
+> Professional Cinematic Prompt Engineering for Google Flow + Veo 3.1
+
+## System Entry Point
+Read \`.agent/MASTER.md\` for the complete production ruleset.
+Read \`.agent/ARCHITECTURE.md\` for the system overview.
+Read \`.agent/agents/prompt-engineer.md\` for agent behavior.
+
+## CRITICAL: Skill Loading Protocol
+Before generating ANY prompts, read skills from \`.agent/skills/\`:
+- \`safety-compliance/SKILL.md\` — ALWAYS (P0)
+- \`reference-locking/SKILL.md\` — When refs provided (P1)
+- \`frame-chaining/SKILL.md\` — ALWAYS for multi-shot (P2)
+- \`coverage-system/SKILL.md\` — ALWAYS, mandatory (P2)
+- \`visual-modes/SKILL.md\` — ALWAYS (P4)
+- \`audio-design/SKILL.md\` — When dialogue/SFX (P4)
+- \`prompt-structure/SKILL.md\` — ALWAYS (P5)
+
+## Universal Rules (Always Active)
+1. **AUTO-ANONYMOUS:** Replace ALL real person names with physical descriptions. NEVER use celebrity names.
+2. **AUTO-SAFETY:** Proactively reframe content that may trigger safety filters.
+3. **Language:** Prompts ALWAYS in English. Dialogue preserved in original.
+4. **Pacing:** 8s default, slow burn. "Ilmek ilmek islemek."
+5. **Music:** NONE by default.
+6. **Avoid line:** MANDATORY on every prompt (image, video, coverage).
+7. **Coverage:** 2-3 sub-shots within same SHOTNN.md file, min 60 words each.
+8. **ONE FILE PER SHOT:** No separate coverage files.
+
+## Workflows
+| Command | Workflow |
+|---------|----------|
+| \`/generate\` | \`.agent/workflows/generate.md\` |
+| \`/chain\` | \`.agent/workflows/chain.md\` |
+| \`/safety-check\` | \`.agent/workflows/safety-check.md\` |
+| \`/finish\` | \`.agent/workflows/finish.md\` |
+
+## I/O
+- Scenario source: \`${config.scenarioHint}\` (or active editor tab)
+- Output: \`${config.outputDir}/shots/SHOTNN.md\` per shot (single file with coverage)
+- Index: \`${config.outputDir}/_index.md\`
+- Project info: \`${config.outputDir}/project-info.md\`
+
+Follow rules under \`.claude/rules/\`.
+`;
+}
+function buildClaudeLocal(config) {
+    return `# Local Claude Project Rules — Film-Kit
+
+This workspace uses the Film-Kit Hollywood prompt engineering system.
+All production rules are in \`.agent/MASTER.md\`.
+
+## On /generate
+1. Read \`.agent/workflows/generate.md\` for full procedure
+2. Analyze scenario, auto-anonymize, apply safety
+3. Generate shot files at \`${config.outputDir}/shots/SHOTNN.md\`
+4. Each SHOTNN.md: İLK FRAME + SON FRAME + VİDEO + 2-3 Coverage (ALL IN ONE FILE)
+5. Maintain frame chaining continuity
+
+## Priority Hierarchy
+| Priority | Rule |
+|----------|------|
+| P0 | Platform Safety (overrides everything) |
+| P1 | Reference Fidelity |
+| P2 | Chain Continuity |
+| P3 | Story Integrity |
+| P4 | Visual Quality |
+`;
+}
+function buildClaudeRuleGenerateFlow(config) {
+    return `# Generate Flow — Film-Kit
+
+## Full Procedure
+Read \`.agent/workflows/generate.md\` for the complete generation workflow.
+
+## Quick Reference
+1. **Scenario Analysis:**
+   - Read scenario, auto-detect genre
+   - Identify characters and locations
+   - AUTO-ANONYMOUS: Replace all real names with physical descriptions
+   - AUTO-SAFETY: Proactively reframe sensitive content
+   - Determine shot count based on action beats
+   - Create \`${config.outputDir}/project-info.md\`
+
+2. **Batch Strategy:**
+   - 1-10 shots → Generate all at once
+   - 11-30 shots → Batches of 5
+   - 30+ shots → Batches of 3
+
+3. **Per Shot (SINGLE FILE: SHOTNN.md):**
+   - Analyze scene type (Dialogue / Action / Emotional / Establishing)
+   - Generate main shot (İLK FRAME + SON FRAME + VİDEO)
+   - Generate 2-3 coverage shots (in same file)
+   - Write to \`${config.outputDir}/shots/SHOT[NN].md\`
+   - Update \`${config.outputDir}/_index.md\`
+
+4. **Coverage Selection Matrix:**
+   - Dialogue → Reaction (A) + OTS (B)
+   - Action → Insert (A) + ECU (B)
+   - Emotional → Reaction (A) + ECU (B)
+   - Establishing → Wide (A) + Cutaway (B)
+
+Input source: \`${config.scenarioHint}\` or active editor file.
+`;
+}
+function buildClaudeRuleOutputContract(config) {
+    return `# Output Contract — Film-Kit
+
+## Required Files
+- \`${config.outputDir}/project-info.md\` — Characters, settings, emotional arc mapping, tension levels
+- \`${config.outputDir}/_index.md\` — Shot tracking with chain & status
+- \`${config.outputDir}/shots/SHOT01.md ... SHOTNN.md\` — Individual shot files (one file per shot)
+
+## Prompt Flow Order (Veo Optimization — MANDATORY)
+
+Veo prioritizes first sentence most heavily. Every prompt MUST follow this order:
+
+\`\`\`
+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)
+\`\`\`
+
+## Shot File Format (SHOTNN.md) — SINGLE FILE, ALL INCLUSIVE
+
+\`\`\`markdown
+# SHOT[NN] | [Duration]s | 🎭 Tension: [1-5]
+
+## 🇹🇷 Türkçe Özet
+[1-2 cümle Türkçe açıklama]
+
+## 🔗 Chain Status
+FIRST SHOT / CHAINED from SHOT[prev]_END / CHAIN BREAK - Reason
+
+## Main Shot
+
+### İLK FRAME (SHOTNN_START)
+[If chained: "→ Use SHOT[prev]_END as first frame"]
+
+\\\`\\\`\\\`
+[Image prompt — min 60 words, following prompt flow order]
+Avoid: blurry, low-res, noise, distorted faces, bad anatomy, extra limbs/fingers,
+plastic skin, waxy skin, on-screen text, watermark, logo, cartoon style, CGI look.
+\\\`\\\`\\\`
+
+### SON FRAME (SHOTNN_END)
+
+\\\`\\\`\\\`
+[Image prompt — min 60 words, following prompt flow order]
+Avoid: blurry, low-res, noise, distorted faces, bad anatomy, extra limbs/fingers,
+plastic skin, waxy skin, on-screen text, watermark, logo, cartoon style, CGI look.
+\\\`\\\`\\\`
+
+### VİDEO
+
+\\\`\\\`\\\`
+[Video prompt — min 80 words, following prompt flow order]
+
+Audio direction:
+- Language: [TURKISH/ENGLISH/etc.]
+- Type: [Dialogue/SFX/Ambience/Mixed]
+- Dialogue transcript: "[Exact lines in original language]" or NONE
+- SFX: [Specific sound effects list]
+- Ambience: [Environmental sounds]
+- Music: NONE
+- Mix target: Dialogue X%, SFX Y%, Ambience Z%
+- No on-screen subtitles/captions.
+
+Avoid: distorted faces, morphing, bad anatomy, blurry, flickering,
+inconsistent lighting, unnatural motion, on-screen text, watermark.
+\\\`\\\`\\\`
+
+---
+
+## Coverage Shots (Kurgu Detayları)
+
+### SHOT[NN]A — [Type] | [Duration]s | [Icon] [Label]
+
+🇹🇷 [Türkçe coverage özeti]
+
+\\\`\\\`\\\`
+[Coverage IMAGE prompt — min 60 words, standalone (not chained)]
+Avoid: blurry, low-res, noise, distorted faces, bad anatomy, on-screen text, watermark.
+\\\`\\\`\\\`
+\\\`\\\`\\\`
+[Coverage VIDEO prompt — min 60 words, with full audio direction block]
+
+Audio direction:
+- Language: [LANGUAGE]
+- Type: [Ambience/SFX/Dialogue]
+- Dialogue transcript: NONE or "[lines]"
+- SFX: [sounds]
+- Ambience: [environment]
+- Music: NONE
+- Mix target: [percentages]
+- No on-screen subtitles/captions.
+
+Avoid: distorted faces, morphing, blurry, flickering, unnatural motion, on-screen text.
+\\\`\\\`\\\`
+
+### SHOT[NN]B — [Type] | [Duration]s | [Icon] [Label]
+[Same format as A]
+
+### SHOT[NN]C — [Type] | [Duration]s | [Icon] [Label] (optional)
+[Same format as A]
+
+---
+
+## TECHNICAL
+- Camera: [movement type + lens + aperture]
+- Duration: [Xs] (default 8s)
+- Aspect: 16:9
+- Style: Ultra Realism
+
+---
+Generated: [timestamp]
+Total: 1 main + [N] coverage = [N+1] production shots
+\`\`\`
+
+## Coverage Type Reference
+
+| Type | Code | Icon | Duration | Camera | Audio |
+|------|------|------|----------|--------|-------|
+| Reaction | R | 👁️ LISTENER | 4-6s | CU, 85mm, f/2.0 | Ambience only |
+| Over-the-Shoulder | OTS | 📹 OTS | 4-6s | MS, 50mm, f/2.8 | Full dialogue |
+| Insert | INS | 🔍 DETAIL | 2-4s | CU/ECU, 50-100mm, f/4-5.6 | SFX only |
+| Cutaway | CUT | 🌿 ATMOSPHERE | 4s | Variable | Ambience only |
+| Extreme Close-Up | ECU | 👀 EXTREME | 2-4s | 100mm+, f/2.0, macro | Amplified SFX |
+| Wide Cutaway | WC | 🏔️ WIDE | 6-8s | 24-35mm, f/8-11 | Full ambience |
+
+## Coverage Selection by Scene Type
+
+| Scene Type | Coverage A | Coverage B | Coverage C |
+|------------|-----------|-----------|-----------|
+| Dialogue (2+ people) | 👁️ Reaction | 📹 OTS | 🔍 Insert |
+| Dialogue (1 speaker) | 👁️ Reaction | 🔍 Insert | — |
+| Action | 🔍 Insert | 👀 ECU | 🏔️ Wide |
+| Emotional/Drama | 👁️ Reaction | 👀 ECU | 🌿 Cutaway |
+| Establishing | 🏔️ Wide | 🌿 Cutaway | 🔍 Insert |
+| Suspense | 👀 ECU | 🌿 Cutaway | 👁️ Reaction |
+
+## Professional Rules
+
+### Chain Rule
+- Coverage shots are STANDALONE (not chained to each other)
+- Main shots chain: SON FRAME of SHOT[N] = İLK FRAME of SHOT[N+1]
+- Coverage exists in parallel, not in sequence
+
+### 30° Rule
+Coverage camera angles MUST differ from main shot by at least 30°.
+Insert shots are exempt (different subject entirely).
+
+### 180° Rule
+In dialogue scenes, camera stays on same side of the axis line.
+OTS pairs must be symmetrical across the axis.
+
+### Eyeline Match
+Character gaze directions must be spatially consistent between cuts.
+
+### Dramaturgy (for dialogue scenes)
+Analyze per character: Objective → Obstacle → Stakes → Subtext → Beat turns.
+Embed as physical behavior in prompts, NOT as metadata.
+
+> **CRITICAL:** Do NOT create separate coverage files.
+> Each SHOTNN.md is a complete production package.
+`;
+}
+function buildClaudeSettings() {
+    return JSON.stringify({
+        model_preferences: {
+            style: "cinematic"
+        },
+        workspace_rules: {
+            enabled: true
+        }
+    }, null, 2);
+}
+function buildClaudeSettingsLocal() {
+    return JSON.stringify({
+        local_overrides: {
+            use_selected_file_first: true
+        }
+    }, null, 2);
+}
+/* ---------- COPILOT ---------- */
+function buildCopilotInstructions(config) {
+    return `# Film-Kit — Copilot Instructions
+## Hollywood Standard Cinematic Prompt Engineering for Google Flow + Veo 3.1
+
+### System Entry Point
+Read \`.agent/MASTER.md\` for the complete production ruleset.
+Read \`.agent/ARCHITECTURE.md\` for system overview.
+
+### Skill Loading Protocol (MANDATORY)
+Before generating ANY prompts, read skills from \`.agent/skills/\`:
+1. \`safety-compliance/SKILL.md\` — ALWAYS (celebrity ban, auto-anonymous)
+2. \`reference-locking/SKILL.md\` — When reference images provided
+3. \`frame-chaining/SKILL.md\` — ALWAYS for multi-shot continuity
+4. \`coverage-system/SKILL.md\` — ALWAYS (mandatory coverage shots)
+5. \`visual-modes/SKILL.md\` — ALWAYS (Ultra Realism default)
+6. \`audio-design/SKILL.md\` — When dialogue or SFX needed
+7. \`prompt-structure/SKILL.md\` — ALWAYS (prompt templates)
+
+### When User Asks /generate
+1. Read \`.agent/workflows/generate.md\` for the full procedure
+2. Analyze scenario, auto-anonymize real names, apply safety reframing
+3. Generate shot files: \`${config.outputDir}/shots/SHOT01.md, SHOT02.md, ...\`
+4. Create index: \`${config.outputDir}/_index.md\`
+5. Create project info: \`${config.outputDir}/project-info.md\`
+
+### Critical Rules
+- **AUTO-ANONYMOUS:** Replace ALL real names with physical descriptions
+- **AUTO-SAFETY:** Proactively reframe sensitive content
+- **Frame Chaining:** Last frame of SHOT[N] = First frame of SHOT[N+1]
+- **Coverage:** 2-3 sub-shots per main shot (in same file, min 60 words each)
+- **Avoid Line:** MANDATORY on every prompt
+- **Music:** NONE by default
+- **Duration:** 8s default, slow burn pacing
+- **Language:** Prompts in English, dialogue preserved
+- **ONE FILE PER SHOT:** SHOTNN.md contains main shot + all coverage
+
+### Other Workflows
+- \`/chain\` → \`.agent/workflows/chain.md\`
+- \`/safety-check\` → \`.agent/workflows/safety-check.md\`
+- \`/finish\` → \`.agent/workflows/finish.md\`
+
+### Input
+- Scenario: \`${config.scenarioHint}\` or active editor file
+`;
+}
+function buildCopilotScopedInstructions(config) {
+    return `---
+applyTo: "**/*.md"
+---
+# Film-Kit Scoped Instructions
+
+When request is /generate, follow the Film-Kit Hollywood production system:
+1. Read \`.agent/workflows/generate.md\` for full procedure
+2. Load required skills from \`.agent/skills/\`
+3. Transform scenario into production shot package at \`${config.outputDir}\`
+4. Generate: project-info.md, _index.md, shots/SHOT01.md..SHOTNN.md
+5. Each SHOTNN.md: İLK FRAME + SON FRAME + VİDEO + 2-3 Coverage (ALL IN ONE FILE)
+6. Enforce: auto-anonymous, auto-safety, frame chaining, avoid lines
+`;
+}
+/* ---------- ANTIGRAVITY ---------- */
+function buildAntigravitySkill(config) {
+    return `---
+name: shotforge-generate
+description: Hollywood-standard cinematic prompt engineering for Google Flow + Veo 3.1. Generates production-grade shot files with coverage, frame chaining, and safety compliance.
+---
+
+# Film-Kit — ShotForge Generate Skill
+
+## System Architecture
+This skill is part of the Film-Kit prompt engineering system.
+Read \`.agent/MASTER.md\` for the complete production ruleset (690+ rules).
+
+## Skill Loading Protocol
+Before generating ANY prompts, read these skills:
+1. \`.agent/skills/safety-compliance/SKILL.md\` — ALWAYS
+2. \`.agent/skills/reference-locking/SKILL.md\` — When refs provided
+3. \`.agent/skills/frame-chaining/SKILL.md\` — ALWAYS
+4. \`.agent/skills/coverage-system/SKILL.md\` — ALWAYS (mandatory)
+5. \`.agent/skills/visual-modes/SKILL.md\` — ALWAYS
+6. \`.agent/skills/audio-design/SKILL.md\` — When dialogue/SFX
+7. \`.agent/skills/prompt-structure/SKILL.md\` — ALWAYS
+
+## Workflows
+| Command | Workflow |
+|---------|----------|
+| /generate | \`.agent/workflows/generate.md\` — Generate shots from scenario |
+| /chain | \`.agent/workflows/chain.md\` — Continue from last shot |
+| /safety-check | \`.agent/workflows/safety-check.md\` — Validate before delivery |
+| /finish | \`.agent/workflows/finish.md\` — Complete project, create summary |
+
+## Input
+- Scenario source: \`${config.scenarioHint}\` (or selected file in editor)
+
+## Output
+- Directory: \`${config.outputDir}\`
+- Per-shot files: \`${config.outputDir}/shots/SHOTNN.md\` (single file per shot with coverage)
+- Shot index: \`${config.outputDir}/_index.md\`
+- Project info: \`${config.outputDir}/project-info.md\`
+
+## Critical Rules
+1. **AUTO-ANONYMOUS:** Replace ALL real person names with physical descriptions
+2. **AUTO-SAFETY:** Proactively reframe sensitive content
+3. **Frame Chaining:** Last frame of SHOT[N] becomes first frame of SHOT[N+1]
+4. **Coverage Mandatory:** 2-3 sub-shots per main shot (in same file, min 60 words each)
+5. **Avoid Line:** MANDATORY on every prompt (image + video + coverage)
+6. **Music: NONE** by default
+7. **Ultra Realism** default visual mode
+8. **8s duration** default, slow burn pacing
+9. **ONE FILE PER SHOT:** SHOTNN.md contains main shot + all coverage
+
+## Quality Standard
+HOLLYWOOD PRODUCTION GRADE — Every frame museum-worthy, every chain seamless.
+`;
+}

package/build/lib/types.d.ts

@@ -0,0 +1,25 @@
+export type SupportedPlatform = "cursor" | "claude" | "copilot" | "antigravity";
+export interface AgentConfigOptions {
+    rootDir?: string;
+    outputDir?: string;
+    scenarioHint?: string;
+    platforms?: SupportedPlatform[];
+    overwrite?: boolean;
+    includeAgentsMd?: boolean;
+    /** Copy the full .agent/ content (MASTER.md, skills, workflows, agents). Default: true */
+    copyContent?: boolean;
+}
+export interface ResolvedAgentConfig {
+    rootDir: string;
+    outputDir: string;
+    scenarioHint: string;
+    platforms: SupportedPlatform[];
+    overwrite: boolean;
+    includeAgentsMd: boolean;
+    copyContent: boolean;
+}
+export interface ConfigureResult {
+    rootDir: string;
+    written: string[];
+    skipped: string[];
+}

package/build/lib/types.js

@@ -0,0 +1 @@
+export {};

package/build/postinstall.js

@@ -0,0 +1,22 @@
+import { resolve } from "node:path";
+import { configureAgents } from "./lib/configure.js";
+export async function runPostinstall() {
+    const root = process.env.INIT_CWD ? resolve(process.env.INIT_CWD) : process.cwd();
+    const result = await configureAgents({ rootDir: root });
+    const lines = [];
+    lines.push(`[shotforge-agent-config] configured in ${result.rootDir}`);
+    if (result.written.length > 0) {
+        lines.push(`[shotforge-agent-config] written: ${result.written.join(", ")}`);
+    }
+    if (result.skipped.length > 0) {
+        lines.push(`[shotforge-agent-config] skipped: ${result.skipped.join(", ")}`);
+    }
+    process.stdout.write(`${lines.join("\n")}\n`);
+}
+if (process.argv[1] && process.argv[1].endsWith("postinstall.js")) {
+    runPostinstall().catch((error) => {
+        const message = error instanceof Error ? error.message : "unknown error";
+        process.stderr.write(`[shotforge-agent-config] failed: ${message}\n`);
+        process.exitCode = 1;
+    });
+}