feat(data): add motion-principles domain (Emil Kowalski)

[najamali]

Summary

Adds a new motion search domain covering 37 motion-design principles synthesized from Emil Kowalski's open-source design engineering skill. Emil built Sonner and Vaul, runs animations.dev, and is widely regarded as the motion authority for modern web UI. This PR ports his rules into ui-ux-pro-max as a searchable, BM25-indexable CSV.

Coverage (37 rules across 8 categories)

• Decision — Frequency-based animation gating, never-animate-keyboard-actions, every-animation-has-a-purpose
• Easing — Custom cubic-beziers (the built-in CSS easings are too weak), ease-out for entries, ease-in-out for on-screen movement, linear for constant motion
• Duration — Per-element ranges (button 100-160ms, dropdown 150-250ms, modal 200-500ms), sub-300ms rule, asymmetric enter/exit
• Spring — When to use vs. tween, Apple-style config ({ duration, bounce }), subtle bounce in product UI
• Component — :active scale(0.97), never animate from scale(0), popover transform-origin (with modal exception), skip tooltip delay on subsequent hovers, blur to mask imperfect crossfades, @starting-style
• Performance — transform/opacity only, the CSS-vars-on-parent recalc trap, Framer Motion shorthand isn't hardware-accelerated, CSS animations beat JS under load, WAAPI for programmatic CSS animations
• Gesture — Velocity-based dismissal (>0.11), boundary damping, pointer capture, multi-touch protection
• A11y — prefers-reduced-motion (gentler not zero), hover gating with @media (hover: hover) and (pointer: fine)
• Polish — Stagger 30-80ms, cohesion (motion personality matches component personality), next-day review, real-device gesture testing

Files

• data/motion-principles.csv (37 rows; Category, Principle, Keywords, Why It Matters, Do, Don't, Code Good, Code Bad, Severity, Source)
• data/motion-principles-CREDITS.md (source attribution + credit guidance for derived work)
• scripts/core.py — register motion in CSV_CONFIG and detect_domain
• CLAUDE.md — document new domain
• templates/base/skill-content.md — add Motion Review workflow section
• cli/assets/ — synced per CLAUDE.md sync rules

Test plan

• python3 src/ui-ux-pro-max/scripts/search.py "ease out animation" --domain motion → hits Easing rows
• python3 src/ui-ux-pro-max/scripts/search.py "framer motion drops frames" → auto-detects motion domain
• python3 src/ui-ux-pro-max/scripts/search.py "scale on press button feedback" --domain motion → returns Component rule
• python3 src/ui-ux-pro-max/scripts/search.py "purple gradient" --domain antipattern → no regression on existing domains

Attribution

Each row's Source column attributes specifically. Most trace to Emil directly; Vaul-derived gesture rules and Sonner library principles credit those projects; prefers-reduced-motion and easing-curve resources cite WCAG and easing.dev. Full credit guidance in motion-principles-CREDITS.md recommends linking to emilkowal.ski and animations.dev in derived work.

Why this PR is a separate one from #295

Independent and non-overlapping. Anti-patterns / philosophies / asset protocol is about what to design; motion principles is about how to animate. Easier to review, easier to reject one without losing the other.

🤖 Generated with Claude Code

[najamali]

Note: this PR is stacked on #295 (anti-patterns + philosophies + asset protocol).

The diff currently shows +1186 / 21 files because #295 hasn't merged yet. The actual content of this PR is ~190 lines / 9 files — only the motion-principles additions:

• data/motion-principles.csv (37 rows)
• data/motion-principles-CREDITS.md
• scripts/core.py — adds the motion block to CSV_CONFIG + keyword set
• CLAUDE.md, skill-content.md — documents the new domain
• cli/assets/ — synced

If #295 merges first, this PR's diff will auto-shrink to its actual scope.
If #295 is closed without merging, I'll rebase this branch onto main and the diff will clean up automatically.
If you want to merge them in either order, just say which — happy to split or restack.

Either PR can be reviewed independently of the other; they touch the same CSV_CONFIG dict but otherwise are logically separate (anti-patterns = what to avoid; motion = how to animate).