@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/director/knowledge/cameras/cameras.json

@@ -0,0 +1,234 @@
+[
+  {
+    "id": "arri-alexa-mini-lf",
+    "brand": "ARRI",
+    "model": "Alexa Mini LF",
+    "type": "cinema-camera",
+    "sensor": "Large Format (36.7 x 25.54 mm)",
+    "resolution": "4.5K Open Gate",
+    "lookCharacter": "filmic, organic, warm shadows, beautiful skin tones",
+    "useCases": ["narrative film", "high-end commercial", "drama", "music video"],
+    "tier": "high-end",
+    "popularUsedBy": ["Roger Deakins", "Hoyte van Hoytema", "Greig Fraser"]
+  },
+  {
+    "id": "arri-alexa-35",
+    "brand": "ARRI",
+    "model": "Alexa 35",
+    "type": "cinema-camera",
+    "sensor": "Super 35 (27.99 x 19.22 mm)",
+    "resolution": "4.6K",
+    "lookCharacter": "pristine, 17 stops dynamic range, REVEAL color science",
+    "useCases": ["drama", "cinema", "premium commercial"],
+    "tier": "high-end"
+  },
+  {
+    "id": "red-v-raptor",
+    "brand": "RED",
+    "model": "V-Raptor",
+    "type": "cinema-camera",
+    "sensor": "Vista Vision 8K VV",
+    "resolution": "8K",
+    "lookCharacter": "ultra-sharp, vibrant, large color gamut, modern",
+    "useCases": ["VFX-heavy", "commercials", "music videos"],
+    "tier": "high-end"
+  },
+  {
+    "id": "red-komodo",
+    "brand": "RED",
+    "model": "Komodo",
+    "type": "cinema-camera",
+    "sensor": "Super 35 6K",
+    "resolution": "6K",
+    "lookCharacter": "compact, sharp, RED color science",
+    "useCases": ["indie cinema", "drone work", "B-camera"],
+    "tier": "mid-high"
+  },
+  {
+    "id": "sony-venice-2",
+    "brand": "Sony",
+    "model": "Venice 2",
+    "type": "cinema-camera",
+    "sensor": "Full Frame 8.6K",
+    "resolution": "8.6K",
+    "lookCharacter": "beautiful skin tones, dual-base ISO, cinematic",
+    "useCases": ["drama", "premium ad", "Netflix-approved"],
+    "tier": "high-end"
+  },
+  {
+    "id": "sony-fx9",
+    "brand": "Sony",
+    "model": "FX9",
+    "type": "cinema-camera",
+    "sensor": "Full Frame 6K",
+    "resolution": "6K",
+    "lookCharacter": "documentary-friendly, fast AF",
+    "useCases": ["documentary", "run-and-gun", "broadcast"],
+    "tier": "mid"
+  },
+  {
+    "id": "canon-eos-c500-ii",
+    "brand": "Canon",
+    "model": "EOS C500 Mark II",
+    "type": "cinema-camera",
+    "sensor": "Full Frame 5.9K",
+    "resolution": "5.9K",
+    "lookCharacter": "Canon color science, warm skin tones",
+    "useCases": ["doc", "broadcast", "commercial"],
+    "tier": "mid-high"
+  },
+  {
+    "id": "blackmagic-ursa-12k",
+    "brand": "Blackmagic",
+    "model": "URSA Mini Pro 12K",
+    "type": "cinema-camera",
+    "sensor": "Super 35 12K",
+    "resolution": "12K",
+    "lookCharacter": "affordable, raw, flexible post",
+    "useCases": ["indie cinema", "VFX-heavy"],
+    "tier": "mid"
+  },
+  {
+    "id": "sony-a7-iv",
+    "brand": "Sony",
+    "model": "A7 IV",
+    "type": "mirrorless",
+    "sensor": "Full Frame 33MP",
+    "resolution": "33MP / 4K 60p",
+    "lookCharacter": "neutral, sharp, modern, clean",
+    "useCases": ["portrait", "documentary", "social media", "B-roll"],
+    "tier": "prosumer"
+  },
+  {
+    "id": "sony-a7s-iii",
+    "brand": "Sony",
+    "model": "A7S III",
+    "type": "mirrorless",
+    "sensor": "Full Frame 12MP",
+    "resolution": "4K 120p",
+    "lookCharacter": "low-light king, S-Log3, video-first",
+    "useCases": ["low-light", "documentary", "event"],
+    "tier": "prosumer"
+  },
+  {
+    "id": "sony-fx3",
+    "brand": "Sony",
+    "model": "FX3",
+    "type": "mirrorless-cinema",
+    "sensor": "Full Frame",
+    "resolution": "4K 120p",
+    "lookCharacter": "compact cinema, hybrid",
+    "useCases": ["indie cinema", "gimbal", "documentary"],
+    "tier": "mid"
+  },
+  {
+    "id": "canon-r5-c",
+    "brand": "Canon",
+    "model": "R5 C",
+    "type": "mirrorless-cinema",
+    "sensor": "Full Frame 45MP",
+    "resolution": "8K 30p",
+    "lookCharacter": "Canon color, hybrid stills/cinema",
+    "useCases": ["hybrid shoots", "8K cinema"],
+    "tier": "mid-high"
+  },
+  {
+    "id": "canon-r6-ii",
+    "brand": "Canon",
+    "model": "R6 Mark II",
+    "type": "mirrorless",
+    "sensor": "Full Frame 24MP",
+    "resolution": "4K 60p",
+    "lookCharacter": "Canon warm color, autofocus",
+    "useCases": ["hybrid", "wedding", "events"],
+    "tier": "prosumer"
+  },
+  {
+    "id": "nikon-z9",
+    "brand": "Nikon",
+    "model": "Z9",
+    "type": "mirrorless",
+    "sensor": "Full Frame 45MP",
+    "resolution": "8K 30p",
+    "lookCharacter": "stills-first, robust video",
+    "useCases": ["sports", "wildlife", "stills+video"],
+    "tier": "high-end"
+  },
+  {
+    "id": "panasonic-gh7",
+    "brand": "Panasonic",
+    "model": "GH7",
+    "type": "mirrorless",
+    "sensor": "Micro Four Thirds",
+    "resolution": "5.7K",
+    "lookCharacter": "video-first, compact, V-Log",
+    "useCases": ["indie video", "documentary"],
+    "tier": "prosumer"
+  },
+  {
+    "id": "fujifilm-x-h2s",
+    "brand": "Fujifilm",
+    "model": "X-H2S",
+    "type": "mirrorless",
+    "sensor": "APS-C 26MP",
+    "resolution": "6.2K",
+    "lookCharacter": "film simulation, organic colors",
+    "useCases": ["hybrid", "documentary", "stylized video"],
+    "tier": "prosumer"
+  },
+  {
+    "id": "gopro-hero-13",
+    "brand": "GoPro",
+    "model": "Hero 13",
+    "type": "action",
+    "sensor": "1/1.9\" CMOS",
+    "resolution": "5.3K",
+    "lookCharacter": "wide POV, action-oriented",
+    "useCases": ["POV", "action", "extreme sports"],
+    "tier": "consumer"
+  },
+  {
+    "id": "dji-osmo-pocket-3",
+    "brand": "DJI",
+    "model": "Osmo Pocket 3",
+    "type": "action",
+    "sensor": "1\" CMOS",
+    "resolution": "4K 120p",
+    "lookCharacter": "stabilized, vlog-friendly",
+    "useCases": ["vlog", "travel", "B-roll"],
+    "tier": "consumer"
+  },
+  {
+    "id": "iphone-15-pro",
+    "brand": "Apple",
+    "model": "iPhone 15 Pro",
+    "type": "mobile",
+    "sensor": "48MP main",
+    "resolution": "4K 60p ProRes",
+    "lookCharacter": "computational, accessible, ProRes log",
+    "useCases": ["mobile creator", "social media", "indie"],
+    "tier": "consumer"
+  },
+  {
+    "id": "arriflex-435-35mm",
+    "brand": "ARRI",
+    "model": "Arriflex 435 (35mm film)",
+    "type": "film-camera",
+    "sensor": "35mm film",
+    "resolution": "Native film grain",
+    "lookCharacter": "classic film grain, organic, vintage",
+    "useCases": ["period drama", "music video", "art film"],
+    "tier": "specialty"
+  },
+  {
+    "id": "super-16-aaton",
+    "brand": "Aaton",
+    "model": "XTR Prod (Super 16)",
+    "type": "film-camera",
+    "sensor": "Super 16mm film",
+    "resolution": "Native film grain",
+    "lookCharacter": "indie/grainy, intimate",
+    "useCases": ["indie film", "music video", "documentary"],
+    "tier": "specialty"
+  }
+]

package/templates/skills/director/knowledge/cameras/cameras.md

@@ -0,0 +1,53 @@
+# Cameras — Knowledge Base
+
+> Comprehensive list of cinema and prosumer cameras used in film, commercial, and creator workflows. Use this when generating image/video prompts.
+
+## How to use
+
+Each camera has a distinct **look character** that translates to specific visual qualities in prompts:
+- ARRI = filmic, organic, warm shadows
+- RED = ultra-sharp, vibrant
+- Sony Venice = beautiful skin tones, dynamic range
+- Sony A-series = neutral, sharp, modern
+- Canon = warm color science
+- Film cameras (35mm/16mm) = organic grain
+
+## Tiers
+
+- **high-end** — cinema, narrative film, premium commercial ($50K+)
+- **mid-high** — indie cinema, broadcast ($15-50K)
+- **mid** — prosumer cinema ($5-15K)
+- **prosumer** — hybrid mirrorless ($2-5K)
+- **consumer** — accessible (<$2K)
+- **specialty** — film cameras, action cams
+
+## Format-to-camera mapping
+
+| Format | Recommended tier | Example |
+|--------|------------------|---------|
+| Feature film | high-end | ARRI Alexa Mini LF |
+| Premium commercial | high-end | Sony Venice 2 |
+| Music video | high-end / mid-high | RED V-Raptor |
+| Indie short film | mid-high / mid | RED Komodo |
+| Documentary | mid / prosumer | Sony FX9, FX3 |
+| Reel / TikTok | prosumer / consumer | Sony A7S III, iPhone 15 Pro |
+| Vlog | prosumer / consumer | Sony FX3, DJI Osmo Pocket 3 |
+| Brand reklam (high) | high-end | ARRI Alexa 35 |
+
+## Camera + sensor language for prompts
+
+When writing image prompts, mention:
+- "Shot on [camera]" — establishes look authority
+- "[focal length] lens at f/[aperture]" — depth of field control
+- "Sensor: [Full Frame / Super 35 / Large Format]" — specific quality
+
+Example prompt phrases:
+- "Shot on ARRI Alexa Mini LF with 50mm Cooke S4 at f/2.0"
+- "Sony FX3 with G Master 24mm at f/1.4, 4K"
+- "Captured on 35mm film, Arriflex 435"
+
+## DON'T mix incompatible
+
+- Don't say "shot on iPhone with anamorphic lens at 8K" — unrealistic
+- Don't say "ARRI Alexa with consumer lens" — tier mismatch
+- Match camera tier with lens tier

package/templates/skills/director/knowledge/cameras/recommendations.md

@@ -0,0 +1,75 @@
+# Camera Recommendation Engine — Logic Rules
+
+> How the system picks the right camera setup for any given shot context.
+
+## Input context
+
+```typescript
+{
+  shotType: 'wide' | 'medium' | 'close-up' | 'extreme-close-up' | 'over-shoulder' | 'pov' | 'establishing',
+  mood: string,            // 'melancholic', 'epic', 'tense', 'warm', 'cold'
+  subject: string,         // 'portrait', 'landscape', 'action', 'product'
+  budget: 'high-end' | 'mid' | 'prosumer' | 'consumer',
+  format: string,          // 'narrative-film', 'commercial', 'reel', 'documentary'
+  lookReference?: string   // 'cinematic', 'documentary', 'social-media'
+}
+```
+
+## Decision tree
+
+### Step 1: Filter by budget tier
+- high-end → ARRI / RED / Sony Venice
+- mid-high → Sony FX9, RED Komodo, Canon C500
+- mid → Sony FX3, BMD URSA
+- prosumer → Sony A7S III/FX3, Canon R5
+- consumer → iPhone, GoPro, DJI
+
+### Step 2: Match by format
+- narrative-film → ARRI Alexa family
+- premium commercial → Sony Venice / ARRI Alexa
+- music video → RED V-Raptor (sharpness) or ARRI (filmic)
+- documentary → Sony FX9 (autofocus) or Canon C500
+- reel/TikTok → Sony A7S III, FX3, or iPhone Pro
+
+### Step 3: Match look to mood
+- melancholic / drama → ARRI (filmic warmth)
+- epic / sci-fi → RED (sharpness, vibrance) or Sony Venice
+- documentary realism → Canon (color science) or Sony FX9
+- vintage / nostalgia → Film cameras (Arriflex, Aaton)
+
+## Output
+
+```typescript
+{
+  camera: { /* full Camera object */ },
+  lens: { /* see lens-knowledge */ },
+  aperture: 'f/1.4' | 'f/2.0' | 'f/2.8' | 'f/4' | 'f/5.6',
+  reasoning: {
+    cameraReason: string,
+    lensReason: string,
+    apertureReason: string
+  }
+}
+```
+
+## Sample recommendations
+
+### Portret + drama + high-end
+- ARRI Alexa Mini LF + Cooke S4 85mm @ f/1.4
+- Reason: Filmic warmth, beautiful skin, isolated subject
+
+### Establishing wide + epic
+- ARRI Alexa Mini LF + Cooke Anamorphic 32mm @ T2.3
+- Reason: Anamorphic flares, epic 2.39:1 scale
+
+### TikTok storytime + casual
+- Sony FX3 + Sony G Master 24mm @ f/2.8
+- Reason: Mobile-friendly, vlog framing, S-Log3
+
+### Brand product shot
+- Sony Venice 2 + ARRI Signature Prime 50mm @ f/2.0
+- Reason: Premium product look, neutral color
+
+## Override rules
+
+User can manually override any recommendation. The recommendation engine is **opinionated default**, not a constraint.

package/templates/skills/director/knowledge/cinematography.md

@@ -0,0 +1,87 @@
+# Cinematography Rules — Image Generation
+
+> Core cinematographic principles for ALL image prompts. Loaded with every image generation request.
+
+## MUST INCLUDE in every image prompt
+
+1. **Shot type** (wide / medium / close-up / extreme close-up / over-shoulder / POV / establishing)
+2. **Camera angle** (eye-level / low / high / dutch / overhead / Dutch tilt)
+3. **Lighting setup** (key, fill, rim, practical sources)
+4. **Aperture** (f/1.4, f/2.8, f/4 — depth of field control)
+5. **Time of day / lighting condition** (golden hour, blue hour, tungsten interior, daylight)
+6. **Color temperature reference** (warm/cool, kelvin if specific)
+7. **Camera body + lens combo** (use camera-knowledge module)
+8. **Aspect ratio** (16:9, 9:16, 1:1, 2.39:1)
+
+## NEVER USE
+
+- Generic adjectives: "beautiful", "stunning", "epic", "amazing"
+- Unspecific scale: "big", "small", "tall"
+- Mixed styles: "realistic anime", "photorealistic cartoon"
+- Over-the-top adjectives that signal AI generation
+- Emotion without anchor: "feeling sad" → use facial expression details instead
+- Brand names that conflict with style
+
+## STYLE NOTES
+
+- Default: photorealistic, cinematic
+- Always treat each image as a single frame from a film
+- Prefer specific lens names (Cooke S4, Zeiss Master Prime, ARRI Signature)
+- Specify film stock or sensor when relevant (Kodak Portra, Fuji Pro, ARRI Alexa color science)
+- Use cinematography terminology, not photography hobbyist terminology
+
+## PROMPT ANATOMY
+
+Standard order:
+```
+[Subject] + [Physical Description] + [Action/Pose] + [Setting] + 
+[Lighting] + [Camera Body + Lens + Aperture] + [Style/Mood Notes]
+```
+
+## CONSISTENCY ANCHORS (when reusing same subject across shots)
+
+These MUST stay identical:
+- Anatomical features (face, body type)
+- Distinctive features (scars, glasses, accessories)
+- Fitzpatrick skin tone scale value
+- Hair (color, length, texture) — unless intentionally changed
+- Voice description (for video)
+
+These CAN vary:
+- Clothing (outfit changes)
+- Pose, expression
+- Lighting context
+- Setting
+
+## SHOT TYPE DEFINITIONS
+
+| Type | Frame | Use |
+|------|-------|-----|
+| ECU (Extreme close-up) | Eye, mouth, hand | Emotion peak |
+| CU (Close-up) | Head and shoulders | Emotional reaction |
+| MS (Medium shot) | Waist up | Dialogue |
+| MWS (Medium wide) | Knees up | Action + context |
+| WS (Wide shot) | Full body in environment | Establishing position |
+| EWS (Extreme wide) | Tiny subject in vast environment | Scale, isolation |
+| OTS (Over-the-shoulder) | Looking past one character to another | Conversation |
+| POV (Point of view) | What character sees | Subjectivity |
+| 2-shot | Two characters in frame | Relationship |
+
+## OUTPUT FORMAT EXAMPLE
+
+GOOD:
+```
+A 35-year-old Azerbaijani man, athletic build, short dark wavy hair,
+green eyes, charcoal wool overcoat. Standing by a rain-streaked window
+in a 1960s diner, melancholic expression. Warm tungsten light from
+above creates rim on his shoulders, cool blue spill from window.
+Shot on ARRI Alexa Mini LF with 50mm Cooke S4 at f/2.0, medium close-up,
+eye-level, photorealistic, cinematic color grading.
+```
+
+BAD:
+```
+Beautiful man standing in cafe at night, sad mood, cinematic.
+```
+
+The first is generative-ready. The second produces generic AI output.

package/templates/skills/director/knowledge/composition.md

@@ -0,0 +1,94 @@
+# Composition — Image Generation
+
+> How subjects are arranged in frame. Critical for cinematic feel.
+
+## Core composition rules
+
+### Rule of Thirds
+Divide frame into 3x3 grid. Place subjects on intersections, not center.
+- Eyes typically on upper third line
+- Horizons on upper or lower third (not middle)
+
+### Leading Lines
+Use lines (roads, walls, light beams) to direct eye to subject.
+
+### Framing within frame
+Use doorways, windows, foreground objects to frame subject.
+
+### Negative Space
+Empty space around subject creates isolation, mood, scale.
+
+### Symmetry vs Asymmetry
+- Symmetry: formal, eerie, controlled (Wes Anderson, Kubrick)
+- Asymmetry: dynamic, natural, tension
+
+### Depth Layering
+Foreground + Midground + Background creates 3D feel.
+
+## Headroom & Lookroom
+
+- **Headroom**: space above head (not too much, not cropping)
+- **Lookroom/Noseroom**: space in direction subject is looking
+- **Leadroom**: space ahead of moving subject
+
+## Camera angles
+
+### Eye-level
+Neutral, default. Audience equal to subject.
+
+### Low angle (looking up)
+Subject powerful, dominant, heroic, threatening.
+
+### High angle (looking down)
+Subject vulnerable, small, weak, submissive.
+
+### Bird's eye / Top-down (90° from above)
+Detached, godlike, scale, geometry emphasis.
+
+### Dutch angle (tilted)
+Tension, unease, drunk, off-balance, psychological disturbance.
+
+### Worm's eye (extreme low)
+Heroic monumental, towering subject.
+
+## Framing types (recap from cinematography)
+
+- ECU, CU, MS, MWS, WS, EWS, OTS, POV, 2-shot
+
+## Aspect ratio composition tips
+
+### 16:9 (landscape standard)
+- Horizontal balance
+- Subjects positioned thirds-based
+- Headroom and lookroom standard
+
+### 9:16 (vertical for mobile)
+- Subject vertically centered or upper-third
+- Leave bottom for UI overlays (caption, music)
+- Avoid crucial detail at very top/bottom
+
+### 1:1 (square)
+- Subject centered
+- Strong negative space
+- Symmetry-friendly
+
+### 2.39:1 (cinemascope)
+- Wide horizontal real estate
+- Negative space possible
+- Anamorphic feel
+
+## Composition phrases for prompts
+
+- "Subject offset to right-third with empty leadroom on left"
+- "Symmetrical composition, subject centered"
+- "Low angle from below, subject dominates frame"
+- "Foreground bokeh frames midground subject"
+- "Dutch tilt 15° clockwise creates tension"
+- "Negative space above subject emphasizes isolation"
+
+## DON'T
+
+- Don't say "well-composed" without specifying how
+- Don't center every subject by default
+- Don't crop subjects awkwardly (mid-knee, mid-forehead)
+- Don't ignore where subject is looking

package/templates/skills/director/knowledge/lens-selection.md

@@ -0,0 +1,82 @@
+# Lens Selection — Image Generation
+
+> When generating image prompts, lens choice impacts subject feel. Always specify focal length and aperture.
+
+## Quick lens matrix by shot
+
+| Shot type | Focal length | Aperture | Reason |
+|-----------|--------------|----------|--------|
+| ECU (eye, hand) | 85-100mm or macro | f/2.8 | Compression + sharpness |
+| Close-up portrait | 85mm | f/1.4-f/2.0 | Subject isolation |
+| Medium shot | 50mm | f/2.0-f/2.8 | Natural perspective |
+| Two-shot conversation | 35mm | f/2.8 | Both subjects in DOF |
+| Wide environmental | 24-35mm | f/4-f/5.6 | Subject + context |
+| Establishing | 16-24mm | f/5.6-f/8 | Maximum environment |
+| POV | 8-16mm wide | f/4 | Wide perspective |
+| Anamorphic cinematic | 32-50mm anamorphic | T2.3 | Cinemascope feel |
+
+## Aperture decision tree
+
+```
+Subject isolation priority? → f/1.2 - f/1.4
+Cinematic shallow DOF? → f/2.0
+Environment matters? → f/2.8 - f/4
+Group / wide shot? → f/5.6 - f/8
+Maximum sharpness? → f/8 - f/11
+Architectural / hyperfocal? → f/11+
+```
+
+## Lens character for prompts
+
+When you want this feel, specify this lens:
+
+| Want | Specify |
+|------|---------|
+| Warm vintage glow | Cooke S4 |
+| Razor sharp clinical | Zeiss Master Prime |
+| Anamorphic flares | Cooke / Kowa Anamorphic |
+| Modern premium | ARRI Signature Prime |
+| Vintage swirly bokeh | Helios 44-2 |
+| Hybrid mirrorless cinema | Sony G Master, Canon RF |
+| Macro detail | 100mm macro lens |
+| POV action | GoPro lens / 8mm fisheye |
+
+## Prompt examples
+
+### Portrait close-up
+```
+Shot on ARRI Alexa Mini LF with Cooke S4 85mm at T2.0, medium close-up,
+shallow depth of field, soft Cooke bokeh in background, subject in
+sharp focus.
+```
+
+### Wide establishing
+```
+Shot on Sony Venice 2 with Cooke Anamorphic 32mm at T2.3, extreme wide
+establishing shot, 2.39:1 cinemascope aspect, horizontal lens flares
+visible from off-screen sun.
+```
+
+### Documentary medium
+```
+Shot on Sony FX9 with Sony G Master 35mm at f/2.8, medium shot,
+naturalistic perspective, minimal depth of field separation.
+```
+
+### Mobile vlog
+```
+Captured on iPhone 15 Pro at 4K ProRes, ultra-wide 13mm equivalent
+lens at f/2.2, vlog framing.
+```
+
+## DON'T
+
+- Don't say "with a nice lens"
+- Don't mismatch focal length to shot type (50mm for ECU is wrong)
+- Don't always max out aperture (f/1.2 is bad for groups)
+- Don't mix anamorphic with consumer cameras
+
+## Cross-reference
+
+For full lens database: [shared/lens-knowledge/lenses.json]
+For camera + lens pairing: [shared/lens-knowledge/selection-guide.md]