KI™

ENGINE MODULE

KI™

Kinetic Intelligence

Action scored. Motion calibrated.

Runs within DirectorLogic™ orchestration
“Every action line carries an intensity score that governs how much motion the frame contains.”

What This Layer Does

Kinetic Intelligence scores the action intensity of every shot and maps it to a calibrated motion tier. KI scans the narrative action text for keywords across multiple intensity groups, computes an Action Intensity Score (AIS, 0-10), and assigns one of five motion tiers: Static (0-2), Subtle (3-4), Moderate (5-6), Dynamic (7-8), or Intense (9-10).

The AIS directly governs how much motion the generation model should produce for each shot. A Static shot (AIS 2) gets minimal movement — ambient drift, slow environmental change. A Dynamic shot (AIS 8) gets pronounced movement — fast action, camera response, environmental reaction. An Intense shot (AIS 10) gets maximum motion density.

KI also feeds into the Prompt Assembly V2 format, where the AIS determines the ACTION line's specificity and the CINEMA line's camera response. This ensures that calm scenes aren't over-animated and action scenes aren't under-animated — a calibration that raw prompting cannot achieve.

Receives

  • Action text per shot
  • Shot role classification
  • Energy level from MOMA™

Produces

  • Action Intensity Score (AIS, 0-10) per shot
  • Motion tier classification (Static / Subtle / Moderate / Dynamic / Intense)
  • Motion tier modifiers for Prompt Assembly
  • Action-to-motion escalation mapping
  • Keyword density analysis

Engine Output Example

KI — Action Intensity Scoring
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Shot 1:  "Convoy moves through desert night"
         AIS: 3 (Subtle) — locomotion + ambient
         Motion: Slow, environmental drift

Shot 7:  "Convoy accelerates through the checkpoint"
         AIS: 7 (Dynamic) — acceleration + passage
         Motion: Pronounced vehicle movement, dust response

Shot 11: "Guard slams barrier — convoy halts"
         AIS: 8 (Dynamic) — impact + forced stop
         Motion: Abrupt deceleration, physical impact

Shot 14: "Silence returns to the empty road"
         AIS: 1 (Static) — ambient only
         Motion: Near-still, dust settling

Tier Distribution:
  Static:   3 shots (16%)
  Subtle:   4 shots (21%)
  Moderate: 5 shots (26%)
  Dynamic:  6 shots (32%)
  Intense:  1 shot  (5%)

Actual engine output from a StoryDirector story compilation.

Why This Matters

Director's Notes

Without action intensity scoring, every shot gets the same amount of motion — or random amounts. KI ensures that motion density is proportional to narrative energy. A quiet aftermath shot shouldn't have the same kinetic density as a pursuit scene. A confrontation should feel more physically urgent than an establishing shot. KI is the calibration layer that makes motion feel intentional.

Technical Specifications

Classification

Fully Deterministic

Introduced

Engine 5.1.0 (as ActionMotionEscalator), branded in 6.0.0

Dependencies

MOMA™ (energy context), shot role classifications, action text

Outputs to

Prompt Assembly V2 (ACTION line, motion tier), LO (camera response)

Determinism

100% — keyword scanning + additive scoring + tier clamping

Related Layers

Experience KI™ in action.