plan-storyboard-phase1

name	plan-storyboard-phase1
description	Produce the first-pass storyboard panel plan for each screenplay clip.

Plan Storyboard Phase 1

Purpose

Generate the initial storyboard panel plan from screenplay clips. This skill creates the base panel structure that all later storyboard refinement skills depend on.

Use This Skill When

• clip.screenplay exists and the storyboard pipeline is starting.
• Storyboard panel planning needs to be regenerated after screenplay changes.
• Downstream cinematography and acting passes need a fresh phase-1 panel set.

Do Not Use This Skill When

• Screenplay artifacts are missing or stale.
• The workflow only needs a later storyboard refinement rerun with a guaranteed compatible phase-1 artifact.
• The caller expects final detailed storyboard output immediately.

Inputs

• clip.screenplay
• Prompt template for phase-1 storyboard planning
• Clip-local screenplay content and project analysis context

Outputs

• First-pass storyboard panels for each clip.
• Persistable payload for the storyboard.phase1 artifact.
• UI summary of total clips and total panels produced.

Artifact Contract

• Reads: clip.screenplay
• Writes: storyboard.phase1
• May invalidate downstream storyboard phase-2, phase-3, panel set, and voice artifacts.

Execution Rules

• Must run before any storyboard refinement skill.
• Generate at least one valid panel set for every screenplay clip.
• Preserve clip-to-panel mapping so later phases can align their outputs.
• Fail explicitly instead of synthesizing placeholder panels.

Failure Conditions

• Screenplay artifact is missing or invalid.
• A clip returns zero valid panels.
• Model output fails schema validation.
• Generated panels cannot be traced back to the source clip.

Quality Bar

• Phase-1 panels should be structurally complete enough for later enrichment.
• Output must preserve clip ordering and stable identifiers.
• Panels should be concise, not overloaded with later-phase detail.