@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/storyboard-builder/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/storyboard-builder/knowledge/consistency-anchors.md

@@ -0,0 +1,113 @@
+# Consistency Anchors — Image Generation
+
+> The hardest problem in AI image generation: keeping the same character/location consistent across multiple shots.
+
+## The problem
+
+Each generation is independent. Prompt "young woman with red hair" produces a DIFFERENT woman every time. We need anchors to keep her recognizably the same person across 10+ generations.
+
+## Solution stack
+
+### 1. Reference images (primary mechanism)
+
+When user uploads their first generation, that image becomes the anchor. Subsequent prompts include it as **vision reference input**:
+
+```
+[Image: character_full_body.png]
+[Image: character_front_close.png]
+
+Generate the same character in a different setting:
+- Setting: hospital corridor, sterile lighting
+- Action: walking briskly toward camera
+- Camera: medium shot, 50mm at f/2.8
+- IMPORTANT: maintain exact facial features, hair, body type from references.
+```
+
+### 2. Anatomical anchor list (text-based)
+
+Even with images, prompt should re-state non-negotiable features:
+
+```
+Character: 35-year-old Azerbaijani man (refer to character sheet for
+exact face). Anatomical anchors that MUST match references:
+- Hair: short dark wavy, swept right
+- Eyes: deep green
+- Build: athletic, 5'11"
+- Distinctive: small scar above right eyebrow, slight stubble
+- Skin tone: Fitzpatrick scale 4
+```
+
+### 3. Style anchor (per project)
+
+Single style note repeated across all character generations:
+```
+Style: photorealistic cinematic, ARRI Alexa color science,
+shallow DOF, neutral exposure, 2024 contemporary realism.
+```
+
+## What can change vs what can't
+
+### MUST stay identical
+- Face shape, features, structure
+- Hair color (length/style can vary slightly)
+- Eye color
+- Body proportions
+- Skin tone
+- Scars, tattoos, glasses, distinctive marks
+
+### Can vary intentionally
+- Outfit (separate "outfit variant" prompts)
+- Pose, expression
+- Lighting and setting
+- Hair styling (tied/loose, but not color/length)
+- Time of day on subject
+
+### Should change with story
+- Age progression (over years/scenes)
+- Wardrobe based on scene
+- Emotional state via expression
+- Wet vs dry hair (weather)
+
+## Location consistency
+
+Same logic for locations:
+
+### MUST stay
+- Architecture
+- Wall colors
+- Major furniture
+- Practical light positions
+
+### Can vary
+- Time of day (sunlight angle)
+- Weather visible through windows
+- Props on tables
+- Camera angle within space
+
+## Multi-character consistency
+
+When two characters in same shot:
+1. Generate each independently first (turnaround)
+2. Use BOTH reference image sets as vision input
+3. Specify spatial relationship: "Character A on left, Character B on right, eye-line connecting"
+4. Specify both characters' features again in prompt
+
+## DON'T
+
+- Don't expect consistency without references
+- Don't change too many anchors at once
+- Don't rely only on names ("ƏLİ" doesn't anchor anything visually)
+- Don't skip the description even when sending images
+
+## Workflow recommendation
+
+1. Generate character turnaround (5 views) → pick best
+2. Upload best to library as anchor
+3. For every subsequent shot, send 1-2 best-matching references
+4. Re-state anatomical anchors in prompt text
+5. Validate: does generated character match? If not, iterate
+
+## Cross-reference
+
+- character-anatomy.md — what to describe
+- cinematography.md — how to frame for consistency

package/templates/skills/storyboard-builder/knowledge/continuity-rules.md

@@ -0,0 +1,152 @@
+# Continuity Rules — Video Generation
+
+> When making multiple clips that should connect (a scene of multiple shots), continuity must be maintained explicitly.
+
+## What continuity means
+
+Across multiple clips that depict the same scene:
+- Same character looks identical
+- Same lighting setup
+- Same wardrobe (unless intentional change)
+- Same props in same positions
+- Time of day consistent
+- Same general environment
+
+## The 4 continuity dimensions
+
+### 1. Spatial continuity
+Position of subjects and objects in space.
+- If subject ended on right side of frame, next shot should start with them on right
+- Eyeline match: where subject was looking, next shot should reflect
+
+### 2. Temporal continuity
+Time within scene.
+- If it was raining, next clip rains (unless time-passed cut)
+- If subject was holding cup, they should still hold it (or visibly put it down)
+
+### 3. Visual continuity
+Look and style.
+- Same lighting setup
+- Same color grading
+- Same lens character
+
+### 4. Audio continuity
+- Same ambient sound bed
+- Music tempo/mood consistent
+- Voice quality matches
+
+## Continuity prompt strategy
+
+### For each clip after the first
+
+Include explicit continuity reference:
+
+```
+CONTINUITY FROM PREVIOUS CLIP:
+- Subject: [same character description]
+- Wardrobe: [exact same outfit]
+- Lighting: [exact same setup]
+- Props: [what they're holding, what's around them]
+- Position: [where they are in space]
+- Mood: [emotional state]
+
+THIS CLIP'S NEW ACTION:
+[describe what changes]
+```
+
+### Example: 3-clip scene
+
+#### Clip 1 — Establishing
+```
+[Wide shot]
+A 35-year-old man enters a 1960s diner from the rain. He removes his
+coat and hangs it. Walks to counter. Sits on stool.
+
+[Audio: rain, door bell, footsteps, jazz from jukebox]
+Duration: 8 seconds.
+```
+
+#### Clip 2 — Medium (continuity)
+```
+CONTINUITY: Same man, now seated at counter from clip 1. Wet hair
+from rain, coat now hanging on hook visible in background. Same
+warm tungsten + cool window lighting. Jazz still playing.
+
+[Medium shot, eye-level]
+He looks down at the menu, then up at the empty stool beside him.
+
+[Audio: jazz continues, his quiet breathing, distant rain]
+Duration: 6 seconds.
+```
+
+#### Clip 3 — Close-up (continuity)
+```
+CONTINUITY: Same man from clips 1 and 2. Wet hair, looking at empty
+stool. Same lighting. Same audio bed.
+
+[Close-up, slight low angle]
+His expression shifts from neutral to melancholic. A subtle exhale.
+He looks back down at the menu.
+
+[Audio: jazz, his exhale]
+Duration: 5 seconds.
+```
+
+## Reference image strategy
+
+For best continuity:
+1. Generate Clip 1
+2. Extract last frame
+3. Use as reference image for Clip 2
+4. Repeat
+
+Models that support this well:
+- Runway (image-to-video)
+- Luma (image-to-video)
+- Kling (with first frame reference)
+
+## Common continuity errors
+
+### Wardrobe drift
+Solution: re-state outfit in EVERY clip prompt.
+
+### Lighting flicker
+Solution: lock lighting setup in every prompt with same exact words.
+
+### Hair changes
+Solution: re-state hair description identically.
+
+### Background props move
+Solution: simplify background, re-list in continuity.
+
+### Time-of-day shift
+Solution: explicitly state time of day each time.
+
+## Match cuts
+
+When you want a deliberate visual match between clips:
+- Same composition
+- Same focal point
+- Match action mid-motion
+
+```
+Clip 1 ends: subject reaches for cup
+Clip 2 begins: hand grasping cup at exactly same position
+```
+
+This requires very precise prompting.
+
+## Eyeline match
+
+When two characters look at each other:
+- Subject A looks screen-right at 30° down
+- Subject B should be looking screen-left at 30° up
+- Heights must match
+
+## Default approach
+
+For multi-clip scenes:
+1. Plan all clips upfront
+2. Write continuity-aware prompts
+3. Re-state EVERYTHING that should stay constant
+4. Only describe what's changing

package/templates/skills/storyboard-builder/knowledge/temporal-consistency.md

@@ -0,0 +1,115 @@
+# Temporal Consistency — Video Generation
+
+> Frame-to-frame consistency. The hardest problem in AI video. Subject morphing, lighting flicker, object disappearing — all temporal failures.
+
+## What can go wrong
+
+### Subject morphing
+- Face slowly changes between frames
+- Outfit shifts color or detail
+- Body proportions vary
+
+### Lighting flicker
+- Brightness changes between frames
+- Color temperature shifts
+- Shadows move unnaturally
+
+### Object permanence loss
+- Held object disappears mid-clip
+- Background element vanishes
+- Hand goes through solid object
+
+### Background drift
+- Walls slowly distort
+- Texture patterns shift
+- Background subjects appear/disappear
+
+## Mitigation strategies
+
+### 1. Strong reference image (most important)
+For image-to-video models (Luma, Runway, Pika):
+- Provide highest-quality starting image
+- Image should be clean, sharp, well-composed
+- Avoid busy backgrounds (more to keep consistent)
+
+### 2. Short duration
+- 4-6 seconds: most stable
+- 6-8 seconds: usable
+- 8-10 seconds: degradation likely
+- 10+ seconds: significant artifacts
+
+### 3. Minimal motion
+- Less motion = more frames look similar = less drift
+- Static or subtle motion = highest stability
+- Complex action = highest drift
+
+### 4. Simple background
+- Plain walls, gradient backgrounds, blurred backgrounds = stable
+- Detailed textures, crowds, foliage = unstable
+
+### 5. Single subject focus
+- One person in frame: stable
+- Two people: doable
+- Three+ people: high drift risk
+
+### 6. Consistent lighting setup
+- Natural single source = stable
+- Multi-source mixed lighting = drift risk
+- Practical lights that flicker (candles, screens) = use cautiously
+
+### 7. Stable camera
+- Static = best
+- Single slow movement = ok
+- Complex movement = drift compounds
+
+## Prompt phrases that help
+
+```
+Maintain exact visual consistency throughout the clip.
+Subject's appearance must NOT change frame-to-frame.
+Lighting setup remains constant.
+Background details are static and unchanging.
+No transformations or morphing.
+```
+
+## Prompt phrases that hurt
+
+```
+Dynamic transitions
+Changing perspective
+Morphing scenery
+Time-lapse
+Multiple cuts
+```
+
+These trigger model into "creative" mode = inconsistency.
+
+## Continuity between clips
+
+When making multiple clips that should connect:
+
+```
+Clip 1: Subject in scene X with lighting Y, ends at position Z.
+Clip 2: Subject continues from position Z, lighting Y unchanged,
+scene X unchanged. NEW action begins.
+```
+
+Use last frame of Clip 1 as reference image for Clip 2.
+
+## Trade-off
+
+More motion = more cinematic feel BUT less consistency.
+Less motion = more stable BUT can feel like "moving photo".
+
+For AI video right now (2026), prefer stability over dynamism.
+
+## Quality check
+
+After generating, watch for:
+- Face stability frame-by-frame
+- Outfit color consistency
+- Background object permanence
+- Smooth motion (no jumps)
+- Consistent lighting
+
+If multiple failures: regenerate with simpler prompt.