datamagic-video

name	datamagic-video
description	Use when a task involves tabular data (CSV, Excel, database result, structured table) becoming a narrated data video, animated chart, data story, DVSpec, visualization storyboard, voiceover-timed chart sequence, Remotion data-video render, or refinement of an existing data-video result.
metadata	{"tags":"datamagic, data-video, dvspec, remotion, data-visualization, narration, animation, storytelling"}

DataMagic Video

Turn tabular data into a narrated, animated data video. Core artifact: DVSpec, a renderer-agnostic screenplay for scenes, data bindings, narration, and animation. Render with any stack; Remotion is reference path.

Use

• CSV / Excel / structured table -> multi-scene narrated video
• Pasted data -> animated chart or short data story
• Existing DVSpec / render -> refine, debug, or improve
• Goal only, no render requested -> produce DVSpec plan

Do not use for raw video editing, non-data text-to-video, or live dashboards.

Core Rules

• Plan first. DVSpec before render.
• Data leads story. Pick narrative pattern from data shape, not topic.
• Narration leads viewer eye. Animation follows narration timing.
• Read only needed rule files. Heavy details live under rules/.
• Before calling work done: run rules/self-review.md.

Router

Task	Read
Profile data, find candidate insights	rules/data-analysis.md
Choose narrative pattern, scenes	rules/scene-planning.md
Pick chart type, axes, scales	rules/chart-selection.md
Author or validate DVSpec	rules/dvspec.md
Choose visual system, tokens, motion defaults	rules/design-system.md
Pick style pack	rules/styles/README.md
Render DVSpec to video with Remotion	rules/remotion-integration.md
Add TTS, audio-driven duration, subtitles	rules/voiceover.md
Write narration script	rules/narration.md
Refine existing output	rules/refinement.md
Diagnose bad output	rules/anti-patterns.md
Final quality gate	rules/self-review.md

Workflows

Full video:

data-analysis -> scene-planning -> chart-selection -> dvspec -> design-system -> styles -> remotion-integration -> voiceover -> narration -> self-review

DVSpec only:

data-analysis -> scene-planning -> chart-selection -> dvspec

Single animated chart:

data-analysis -> chart-selection -> dvspec -> design-system -> remotion-integration

Refinement:

refinement -> changed domain rule(s) -> self-review

Narrative Patterns

Pattern	Use when	Climax
freytag_default	One main finding builds over time	60-75%
hook_then_evidence	One striking number should open	first chart scene
comparison_driven	A vs B is story spine	largest contrast
time_driven	chronological change drives story	sharpest shift
drill_down	total -> segment -> cause	deepest zoom

See rules/scene-planning.md before locking pattern.