PAIL™

ENGINE MODULE

PAIL™

Pre-Action Inference Layer

Cinematic grammar before the first frame.

Runs within DirectorLogic™ orchestration
“Every cinematic scene opens with grammar. PAIL writes that grammar automatically.”

What This Layer Does

PAIL guarantees cinematic scene entry grammar by enforcing the ESTABLISH → PRE_ACTION → ACTION sequence. When a scene begins, PAIL detects whether the author's text opens with an establishing context or jumps directly into action — and infers the appropriate pre-action framing automatically.

PAIL uses 35+ author pre-action signal detectors and 60+ action verb inference patterns to determine: does this scene need an environment-first entry (wide shot of the location before introducing the subject)? Or does the author's intent call for an in-media-res opening that drops the viewer into action immediately?

This is fully deterministic — no LLM. PAIL reads the scene entry text, applies its detection patterns, and selects from 9 setting templates that match the scene's characteristics. The result is that every scene opens with proper cinematic grammar, even when the author didn't explicitly write it.

Receives

  • Scene entry text from beat extraction
  • Scene metadata (location, time, energy level)
  • Film Grammar Profile rules

Produces

  • Scene entry grammar classification (ESTABLISH → PRE_ACTION → ACTION or direct ACTION)
  • Pre-action injection content (when needed)
  • Environment-first entry shot specifications
  • Setting template selection (from 9 deterministic templates)
  • Injection Pack classification (TRAVEL_MARCH, REVEAL, AMBUSH, GENERAL, etc.)

Engine Output Example

PAIL — Scene 1 Entry Analysis
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Author Entry:   "The convoy moves through the desert night"
Detection:      Action-first entry detected (no establish context)
Decision:       Inject ENVIRONMENT_ESTABLISH before action

Injection Pack: TRAVEL_MARCH
Template:       environment-first entry from 9 setting templates
Grammar:        ESTABLISH → PRE_ACTION → ACTION

Injected Shot: Wide establishing — desert highway at night,
  headlights visible on horizon, dust haze in ambient light.
  Duration: 4s | Camera: Static, 24mm wide | Energy: 1/10

Classification: Deterministic. No LLM.

Actual engine output from a StoryDirector story compilation.

Why This Matters

Director's Notes

Professional filmmakers open scenes with establishing shots instinctively. Emerging creators often jump straight into action because they're thinking about what happens, not how to show it. PAIL bridges that gap without rewriting the story — it infers the cinematic grammar the author intended (or would have intended, given professional conventions) and inserts it before the first action frame. The result: every scene opens like a film, not a TikTok.

Technical Specifications

Classification

Fully Deterministic (no LLM)

Introduced

Engine 3.0.0, v2 upgrade in 6.0.0

Dependencies

BeatMap™ (scene entry text), StoryCore™ (location/time), Film Grammar Profile

Outputs to

DirectorLogic™ (shot plan), Prompt Builder

Determinism

100% — pattern matching + template selection, no randomness

Related Layers

Experience PAIL™ in action.