motion-card-lesson-short

name	motion-card-lesson-short
description	Build a narrow educational short around motion cards, timed reveals, quiz beats, or vocabulary-style prompts where the primary visual system is designed cards rather than stock footage or freeform generated scenes.

Motion Card Lesson Short

Use When

• The short is educational, quiz-like, vocabulary-like, or term-reveal driven.
• The strongest visual system is timed cards, labels, counters, and reveal states.
• The lane should stay deterministic and readable rather than becoming a broad cinematic explainer.

Core Approach

1. Reduce the lesson to one hook and 3 to 6 card beats.
2. Compute final duration from real narration before adding music or delayed reveal timing.
3. Treat each card as a state change: prompt, clue, countdown, answer, reinforcement, CTA.
4. Use motion for emphasis and progression, not decoration.
5. Keep the whole lane schema-first and repeatable.

Inputs

• topic, term, or mini-lesson
• lane shape: explainer-card, quiz-reveal, flashcard
• optional brand palette, icon set, or typography

Outputs

• card-driven scene_plan.json
• motion-led render plan
• final lesson short

Proven Example

• Local proving bundle: experiments/proving-wave-3/motion-card-lesson/outputs/final/video.mp4
• Tracked preview: docs/demo/demo-14-motion-card-lesson.mp4
• Pattern used: hook card, four step cards, payoff card, CTA card, 30.8s, Kokoro voiceover, burned-in captions, hard card resets, and flash pulses for cadence.
• Publish-prep passed portrait resolution, duration, format, cadence, and audio-signal checks. OCR caption-sync still needs a proper caption export sidecar for FFmpeg fallback renders.

Optional Runtime Surface

• Use animation-explainer-short when the lesson needs diagrams or generated metaphor scenes.
• Use motion-design-coder when the card system needs smoother SVG, HTML/CSS, React, or Remotion motion.
• Use shot-prompt-builder only if a beat truly needs a generated support scene.
• Use references/lane-shape.md for the exact card-state sequence and review expectations.

Example Request

• examples/request.json

Technical Notes

• Card lanes should know the final narration duration before music and reinforcement timing are locked.
• Countdowns, answer flips, and term reveals are first-class scene events, not styling afterthoughts.
• Useful source-inspired motifs include flip-word headlines, answer flips, shimmer stats, proof marquees, bento cards, countdown rings, and spotlight callouts; rebuild them with deterministic Remotion/SVG motion unless reuse rights are verified.
• This lane works best when every card has one job.
• The card itself must carry the lesson on mute; captions should reinforce the card state, not be the only source of meaning.
• Avoid tiny step chips and dense body copy. If the contact sheet is not readable at small preview size, simplify the card before rendering.
• Card motion should settle before the lesson text must be read; avoid moving captions and moving cards at the same time.
• Mock or silent audio is not acceptable for a proven lane; use real voiceover and verify audio-signal in publish-prep.

Aggregated From

• leke-adewa/short-video-maker
• calesthio/OpenMontage
• dr34ming/shorts-project

Validation Checklist

• The lesson can be followed on mute and on first watch.
• Card transitions map cleanly to narration beats.
• Typography and icons stay readable on mobile.
• Motion clarifies progression instead of muddying it.
• The lane feels deliberate and repeatable, not improvised.
• The final MP4 passes portrait format, cadence, and audio-signal gates before being documented as a showcase candidate.