BeatMap™

CORE PIPELINE LAYER

BeatMap™

Structural Planning

The skeleton every shot hangs on.

Story InputStoryCore™BeatMap™DirectorLogic™BioFrame™ProdScale™
“A story without beats is a mood without motion.”

What This Layer Does

BeatMap breaks your story into semantically meaningful narrative beats — the structural skeleton that all directorial decisions are applied to. Each beat is classified by type (Establish Environment, Inciting Discovery, Pursuit, Escalation, Reaction, Realization, Resolution), assigned a confidence score, and mapped to a position in the story's escalation curve.

BeatMap doesn't just slice your story into scenes. It reasons about narrative momentum: which beats build tension, which beats release it, where the story turns, and how each moment connects to the next. This structural map determines how many shots are planned, how energy is distributed across acts, and where the camera grammar shifts.

High-confidence beats compile cleanly into shots with full camera specifications. Low-confidence beats get flagged for clarification — surfaced to the creator before they waste time on a direction that won't compile. BeatMap is where ambiguity becomes structure.

Receives

  • Narrative constraints from StoryCore™
  • Raw story text with extracted entities

Produces

  • Ordered beat array with type classification
  • Confidence score per beat (0.0–1.0)
  • Escalation position mapping (which act each beat belongs to)
  • Beat-to-shot planning ratios
  • Pacing boundaries (minimum/maximum duration per beat)
  • Energy curve data points

Engine Output Example

BEATMAP EXTRACTION — 14 beats identified
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Beat 01  ESTABLISH_ENVIRONMENT    Confidence: 0.94
         "Night highway — headlights cut through dust"
         Act: 1 (Setup) | Energy: 2/10

Beat 02  ESTABLISH_ENVIRONMENT    Confidence: 0.91
         "Interior of armored convoy — radio static"
         Act: 1 (Setup) | Energy: 3/10

Beat 07  ESCALATION_TRIGGER       Confidence: 0.88
         "Checkpoint lights appear — convoy slows"
         Act: 2 (Build) | Energy: 6/10

Beat 11  IMPACT_EVENT             Confidence: 0.82
         "Guard raises hand — convoy halts completely"
         Act: 3 (Peak) | Energy: 9/10

Beat 14  FINAL_RESOLUTION         Confidence: 0.79
         "Convoy passes through — silence returns"
         Act: 4 (Aftermath) | Energy: 2/10

Escalation Curve: ▁▂▃▄▅▆▇█▇▅▃▂▁▁

Actual engine output from a StoryDirector story compilation.

Why This Matters

Director's Notes

Every competitor in AI video generation skips this step entirely. They take your text and generate frames. StoryDirector takes your text and reasons about its structure before generating anything. The difference is the difference between a slideshow and a film. Films have beats. Beats have momentum. Momentum requires planning. BeatMap is that planning layer.

Technical Specifications

Classification

LLM-Assisted (beat extraction) + Deterministic (confidence scoring, escalation mapping)

Introduced

Engine 1.0.0, major upgrade in 3.0.0

Dependencies

StoryCore™

Outputs to

DirectorLogic™, MOMA™, Shot Planner

Determinism

Beat extraction is LLM-assisted (frozen after extraction); scoring and mapping are deterministic

Related Layers

Experience BeatMap™ in action.