# Stage 1: Story Understanding

You are analyzing a story to prepare it for short-form video adaptation (45-60 seconds).

## Your Task

Read the story and analyze it for visual adaptation. You will write TWO files:

1. **understanding.md** - Your detailed analysis (main deliverable)
2. **user_message.txt** - A friendly message explaining your findings and providing guidance

## Story Location

The story is at: `../01-story/current/story.md`

Read it carefully before proceeding.

## What to Analyze

### 1. Retelling
Summarize the story in your own words. Make sure you understand:
- The setup
- The conflict or situation
- The resolution/punchline

### 2. Meaning
What's the point of this story?
- What makes it funny/dramatic/engaging?
- What's the punchline or emotional payoff?
- Why would someone want to watch this?

### 3. 3-Second Hook - CRITICAL!

**This is the most important part for short-form video success.**

What will stop viewers from scrolling in the first 3 seconds?

Consider these options:
- **Emotionally engaging**: Immediate empathy, shock, curiosity, humor
- **Visual spectacle**: Striking effects, unexpected visuals, dramatic action
- **Weird/unexpected**: Something that doesn't make sense yet, creates questions
- **High energy**: Fast movement, intense situation, dramatic moment

For this story, identify:
- What specific moment/visual/action starts the video?
- Why will viewers stop scrolling?
- What question does it create in their mind that makes them want to see the resolution?

Examples of good hooks:
- Starting mid-action: "A fire truck races toward camera at high speed..."
- Starting with tension: "Three intimidating bikers surround an old man..."
- Starting with spectacle: "Massive prairie fire raging, firefighter shouting into radio..."
- Starting with weirdness: "Old man calmly walks out of diner while bikers laugh..."

The hook should create immediate curiosity: "Wait, what's happening here? I need to see what happens next!"

### 4. Visual Potential

What can actually be SHOWN in video vs what's just narrative?

Good for video:
- Physical actions (walking, eating, pushing, driving)
- Reactions (facial expressions, body language)
- Objects (fire truck, motorcycles, pie, cigarette)
- Environments (diner, prairie, road)

Bad for video:
- Internal thoughts
- Backstory that isn't shown
- Abstract concepts
- Things described only in narration

### 5. Dialogue and Caption Strategy

All dialogue will have BOTH audio and captions (users watch with sound off). Consider:

**For each key line, identify:**
- Who says it?
- When in the story?
- Delivery style: urgent, calm, comedic, dry, deadpan, etc.
- Caption timing: show immediately, delay for reveal, sync with action?
- Caption emphasis: large text for punchline, subtle for background dialogue?

**Important**: Audio and captions work together:
- Audio provides emotional tone and delivery
- Captions ensure accessibility and muted viewing
- Caption timing can enhance comedy (e.g., delay punchline reveal)
- Caption style reinforces tone (bold for emphasis, small for whispers)

### 6. What WON'T Work

Identify potential problems:
- **Perceptual tricks**: "Looks like X through fog" - models can't do subtle illusions
- **Compound actions**: "Running while eating while shouting" - too complex
- **Implicit relationships**: "React to what they see" - models need explicit description
- **Transformation illusions**: "Appears to be X but is actually Y" - difficult
- **Complex mechanisms**: Multi-part objects with intricate movements
- **Subtle emotions**: "Slight hint of sadness" - models do broad emotions better

## Output Format

Write to `understanding.md` following this exact structure:

```markdown
# Story Understanding

## Retelling
[Your summary in 2-3 sentences]

## Meaning
[What makes this story work - the core appeal]

## 3-Second Hook
[Specific description of opening that stops scrolling - be concrete and visual]

## Visual Potential
### What Works for Video
- [List specific showable elements]

### What Doesn't Work for Video
- [List things that can't be shown]

## Dialogue and Caption Strategy
### Key Lines (all will have BOTH audio and captions)
- [Character]: "[Quote]" - [Delivery style] - [Caption timing/emphasis] - [When in story]

Example:
- Paul: "He can't swim." - Deadpan, flat delivery - Caption appears after 1-second pause, large text for punchline emphasis - Final scene in truck

## What WON'T Work
- [List specific techniques/approaches to avoid]
- [Explain why each won't work]
```

## Important Notes

- Be specific and concrete - "Old man walks slowly" not "Character moves"
- Think about what the camera literally sees
- Consider what will make viewers STOP SCROLLING in first 3 seconds
- This analysis guides all future stages - be thorough

## User Message File (user_message.txt)

After creating `understanding.md`, write `user_message.txt` — a friendly message to the user.

This message should explain (2-3 paragraphs):

**1. What you found:**
- What's the core appeal of this story for video?
- What's the strongest visual element or hook you identified?
- Key strengths (dialogue, visual spectacle, character dynamics)?

**2. What challenges or risks you see:**
- What elements might be difficult to execute visually?
- Any effects that could fail or look fake?
- Anything requiring careful handling?

**3. Specific suggestions for user:**

When to **Accept**:
- The analysis captures the story's essence correctly
- The proposed hook will stop scrollers effectively
- The dialogue/visual approach makes sense
- You're ready to proceed to script generation

When to **Refine** (examples):
- "I want the hook to start with [different moment] instead"
- "The punchline caption should be delayed for dramatic reveal, not shown immediately"
- "Focus more on [character X] and less on [element Y]"
- "The tone should be more [dramatic/comedic/mysterious]"
- "This visual element seems risky — let's emphasize [safer alternative]"
- "The dialogue delivery should be [more intense/softer/faster paced]"

When to **Regenerate** (examples):
- "This interpretation misses the point — the real story is about [X]"
- "Start completely differently — I want to emphasize [different theme]"
- "The hook is wrong — it should be [completely different opening]"
- "This story needs a darker/lighter/different emotional tone throughout"

**Tone**: Be conversational and specific to THIS story. Mention actual character names, plot points, and details.

**Example message**:
```
I've analyzed Dave's water-walking dog story and found strong potential! The core joke — Paul reframing a literal miracle as a deficiency ("He can't swim") — is relatable and perfect for viral sharing.

The 3-second hook I identified: show the dog walking ON the water surface immediately, carrying a duck. No setup, just impossible spectacle. The main challenge is making this visual unambiguous — can't do subtle effects, needs to be obviously supernatural. I've recommended Paul's deadpan delivery for the audio with a delayed caption reveal (1-second pause before text appears) to maximize punchline impact.

**Accept** if this interpretation works for you. **Refine** if you'd prefer: a different opening (maybe start with Dave's excited face?), want the punchline caption to appear immediately instead of delayed, want more/less caption emphasis throughout, or have concerns about the water-walking visual. **Regenerate** if you see this story told completely differently — maybe focusing on Dave's excitement rather than Paul's pessimism, or want a more mysterious tone instead of comedy.
```
