Commit Graph
844 Commits
Author SHA1 Message Date
ukimsanov e0ac2ccffd feat(skill): examples library batch 16 — 2 composed-UI common patterns (79 scenes)
Two more product-UI patterns common in 2026 product videos that the library was missing:

- 04-16 Notification Stack: 4 shadcn-style toast notifications cascade in from the right
  over a greyed-out mock app shell. Success ✓ green / Info ℹ blue / Warning ! amber /
  Error × red. Each has icon + title + message + timestamp + close button + auto-dismiss
  progress bar at bottom. After ~5s the first notification auto-dismisses (slides out
  right) and the stack collapses up. Canonical toast UI pattern.

- 04-17 Loading States Showcase: 6 loading-state UI patterns side-by-side. 01 SKELETON
  (gradient sweep), 02 SPINNER (rotating ring 5x), 03 PROGRESS BAR (0→78% with synced
  counter), 04 DOTS (3-dot pulser with staggered scale yoyo, 5 cycles), 05 CIRCULAR
  (SVG stroke-dashoffset 0→65%), 06 PULSE (opacity yoyo on dashed placeholder labeled
  "Building…"). All 6 patterns seekable — no setTimeout, no requestAnimationFrame.

Both lint clean, both snapshot-verified, both rendered + uploaded.
Grand Tour rebuilt with 79 scenes (9:07) at
https://www.heygenverse.com/s/12548e7f-205c-4144-a2be-4423c2ccc16c/raw.

Section 04 jumps 15 → 17 (composed-UI). Total 77 → 79.
2026-05-19 18:02:00 -07:00
ukimsanov dbcd650820 feat(skill): examples library batch 15 — 3 hand-authored common-pattern scenes (77 scenes)
Three of the most common product-video patterns the library was still missing:

- 04-15 Testimonial Card: customer quote pattern. Fraunces italic quote with red accent on
  key phrase ("forty minutes"), author row (MJ avatar + Maya Jensen / Head of Brand at
  Northshore + composed Northshore logo card), 5-star rating cascade with back.out(2),
  sub-caption "42 TESTIMONIALS · AVG TIME-TO-SHIP DOWN 89%". Quote types word-by-word.

- 10-05 CTA Hero: SaaS closer pattern. Massive headline "Ship your launch video today."
  (gradient italic accent on "today"), sub-headline, primary CTA button with gradient +
  glow halo + shimmer that sweeps twice during hold, secondary "Watch demo" link,
  credibility row (No watermark / Cancel anytime / 847 teams / 4K export). Aurora bg with
  multi-color radial bloom + 24 deterministic particles drifting.

- 12-07 Logo Cloud: customer/brand grid pattern. 4×3 grid of 12 fictional brands (Northshore,
  Atlas Labs, Prism, Voltsy, Loomwave, Sable, Rivet, Helio, Foundry, Meridian, Kestrel,
  Orbit) — each with a colored brand mark (different gradients/shapes per brand) + wordmark.
  Cells reveal via stagger.from "center" with grid [3, 4] (center-out wave). Spotlight cycles
  through 6 cells after grid completes. Bottom credibility row with number pulses.

All 3 lint clean, all 3 snapshot-verified, all 3 rendered + uploaded.
Grand Tour rebuilt with 77 scenes (8:52) at
https://www.heygenverse.com/s/417ac325-e606-48f1-b716-8f8747b44d87/raw.

Section 04 jumps 14 → 15, section 10 jumps 4 → 5, section 12 jumps 6 → 7. Total 74 → 77.
2026-05-19 17:54:06 -07:00
ukimsanov 9c667175a5 feat(skill): examples library batch 14 — 3 hand-authored gap-fillers (74 scenes)
Three more pedagogically clean reference scenes:

- 03-03 Stagger Origin Showcase: 4 panels × 15 dots, each panel running same back.out(1.7)
  stagger but with different from: origin — "start" (left→right) / "center" (middle→edges) /
  "edges" (edges→middle) / "end" (right→left). Color-coded per panel. After initial wave,
  yoyo wave runs again so the pattern is visible twice. Same elements + same easing +
  same duration — only origin differs. The reference for "stagger origin changes the feel."

- 05-03 Glitch Shader Transition: SIGNAL (deep purple) → DECODED (vivid green). Canvas 2D
  draws 12 horizontal slice bands with seeded "random" y-positions, heights, and
  x-displacements; each slice painted in 3 RGB-offset channels for chromatic-split look.
  Hero text jitters during glitch window. Section 05 now has 3 distinct shader-transition
  aesthetics (ripple = concentric, chromatic-aberration = on-image RGB, glitch = sliced
  bands) covering the most common shader transition styles.

- 09-05 Sparkline Draw: 4-card live-metrics dashboard. Active users (blue climb 142k),
  Revenue $87K MRR (green smooth climb), API calls 2.4M (amber volatile peaks), Avg
  latency 84ms (purple decline — down delta because lower is better). Each card has
  filled-area path BELOW + stroked line on TOP, both via stroke-dashoffset (fully seekable).
  End-of-line dots fade in + pulse. Value counters tick up via tl.set() in sync with
  sparkline draws. Delta arrows fade in last.

All 3 lint clean (0 errors), all 3 snapshot-verified, all 3 rendered + uploaded.
Grand Tour rebuilt with 74 scenes (8:30) at
https://www.heygenverse.com/s/aefd8761-7ae5-4399-bed4-3c33ea7dc3bf/raw.

Section 03 jumps 2 → 3, section 05 jumps 2 → 3, section 09 jumps 4 → 5. Total 71 → 74.
2026-05-19 17:41:13 -07:00
ukimsanov 21cd7f9df4 feat(skill): examples library batch 13 — 3 hand-authored gap-fillers (71 scenes)
Three common product-video patterns the library was missing:

- 04-14 Pricing Card Reveal: 3-tier SaaS pricing layout (Starter / Pro / Business). The Pro
  card is featured (dark blue, "Most Popular" amber badge) and uses a different motion shape
  (y from 80 + scale 0.92 + back.out(1.5)) so it lands with more impact than the side cards.
  Price counters tick up via deterministic tl.set() (0→29, 0→79). Feature lists fade in per
  card with stagger. The canonical SaaS pricing pattern.

- 06-03 Light-Leak Wipe: DARK (deep navy "3 a.m. · the build is broken") → LIGHT (warm cream
  "9 a.m. · ship the demo"). 3 stacked diagonal gradient strips sweep across the frame at
  slightly different speeds and angles via mix-blend-mode: screen. Scene swap happens at peak
  bloom so it's masked. The "photograph that caught a flash" transition pattern.

- 09-04 Bar Chart Rise: 6-bar quarterly growth chart (Q1 → Q2·26) with back.out(1.2)
  staggered rise. Each bar has a deterministic value counter above (89/162/248/421/612/847)
  that ticks up in 10 steps. Peak bar in amber instead of blue. Headline "Videos shipped
  847% YoY". The bar-chart-rise reference for growth-stat beats.

All 3 lint clean, all 3 snapshot-verified, all 3 rendered, all 3 uploaded.
Grand Tour rebuilt with 71 scenes (8:11) at
https://www.heygenverse.com/s/2637bc07-ef26-43f2-8ef3-83c21d7aad88/raw.

Section 04 jumps 13 → 14, section 06 jumps 2 → 3, section 09 jumps 3 → 4. Total 68 → 71.
2026-05-19 17:16:52 -07:00
ukimsanov 9513192bdc feat(skill): examples library batch 12 — 3 hand-authored gap-fillers (68 scenes)
After batch 11, sections 05 (shader transitions) and 06 (CSS transitions) were still at 1
scene each, and section 10 (particles/ambient) had no audio-reactive scene. Authored 3 more:

- 05-02 Ripple Shader Transition: dedicated single-shader A→B transition. UNDER (cool blue
  underwater) → OVER (warm amber sunset). Canvas 2D draws 8 concentric expanding rings with
  R/G/B-channel offsets to simulate chromatic aberration; central white-flash radial gradient
  peaks at midpoint; two scenes crossfade at peak distortion. Uses gsap.ticker.add() reading
  tl.time() (mandatory for seekable canvas) + bell-curve intensity sin(u·π) for the
  characteristic peak-then-fade arc of shader transitions.

- 06-02 3D Flip Transition: dedicated full-frame CSS 3D card flip. Blue card "12 teams
  shipping" (counter 0→12) → anticipation tilt → rotateY 180° flip → orange card "847 videos
  rendered" (counter 0→847). Caption swaps mid-flip from "From the team count…" to
  "…to the output count." Pattern: transform-style: preserve-3d + perspective: 2400px +
  backface-visibility: hidden. Different from the mini-cell version in scene-01.

- 10-04 Audio-Viz Hero: audio-reactive aesthetic WITHOUT real audio input. 32-tick beat
  grid + 40-bar amber spectrum + 4 corner telemetry readouts (ACCENT/TRIGGER/INSERT/PEAK) +
  "Beat drop." hero. 7 scheduled "beat" timestamps; each pulses a group of bars + brightens
  a tick + breathes the hero + ticks the peak counter via tl.set(). Pre-rendered
  deterministic bar heights (no Math.random). Fills the audio-reactive gap in section 10.

All 3 lint clean (0 errors), all 3 snapshot-verified, all 3 rendered, all 3 uploaded.
Grand Tour rebuilt with 68 scenes (7:50) at
https://www.heygenverse.com/s/bbe43a50-4eda-4fd9-b248-38c5ae73e64d/raw.

Section 05 jumps 1 → 2, section 06 jumps 1 → 2, section 10 jumps 3 → 4. Total 65 → 68.
2026-05-19 16:15:35 -07:00
ukimsanov 04b46a13f3 feat(skill): examples library batch 11 — 3 hand-authored gap-fillers (65 scenes)
Sections 03 (easing) and 08 (svg-and-path) were at 1 scene each after batch 10. Authored 3
scenes from scratch (not lifted) to bring them up to a reasonable baseline:

- 03-02 Easing Comparison Race: 7 balls race the same horizontal track over the same 2s
  duration, each driven by a different easing (power4.out / back.out(1.7) / expo.out /
  power1.out / elastic.out(1, 0.5) / expo.inOut / none). Lane labels with intent names +
  use-case hints. The fact that all balls finish together but spend the journey at radically
  different positions is the entire pedagogical payload. Visceral teaching scene for easing
  variety, pairs with _shared/easing-glossary.md.

- 08-02 Logo Stroke-Draw: Brand mark drawing itself via SVG paths. Ring + M monogram (4
  stroke segments) + serif notches + accent dot + arc text labels + italic Fraunces caption.
  Each path has pathLength=1000 + stroke-dasharray=1000 + animated stroke-dashoffset (fully
  seekable, no onUpdate callbacks). Cream parchment background with grain. The canonical
  brand-mark reveal pattern.

- 08-03 Icon Morph: Single SVG path morphs through 5 states — SQUARE -> CIRCLE -> DIAMOND
  -> STAR -> WAVE (bezier blob). Each transition uses a scale-pulse (squash + d-attribute
  swap via tl.set(el, { attr: { d: "..." } }) + expand). Phase dots cycle below to mark
  progress; state-name + caption swap in sync. Reference for icon state-machine UIs without
  needing MorphSVGPlugin.

All 3 lint clean, all 3 snapshot-verified, all 3 rendered, all 3 uploaded to Verse, gallery
patched with 3 new cards. Grand Tour rebuilt with 65 scenes (7:31) at
https://www.heygenverse.com/s/efb24629-1c60-41f9-bd3f-a78d2181d774/raw.

Section 03 jumps 1 -> 2 scenes, section 08 jumps 1 -> 3 scenes, total 62 -> 65.
2026-05-19 16:03:06 -07:00
ukimsanov 39069a1924 feat(skill): examples library batch 10 — 5 second-pass lifts (62 scenes)
After flagging that batches 1-9 hadn't thoroughly mined the production-video archives, I did a
full second-pass survey: every HTML file in launch-video, launch-video-2,
claude-design-hyperframes-video, ~/Downloads/Archive (21 projects / 89 HTML), and
~/Downloads/Archive 2 (16 projects / 174 HTML). Five genuine gap-fillers lifted:

- 04-12 Claude Code IDE: AI-agent chat panel (chrome dots + prompt type-on + tool-call badges
  + DESIGN.md output). Library had ZERO AI-agent UI mockups before — in 2026 they're the
  most common product-demo visual. Lifted from launch-video-2/act-1-cold-open .term-claude.

- 04-13 Design Inspector: Figma-style inspector with cycling values (font Inter -> Fraunces ->
  IBM Plex Mono -> Georgia, size 120 -> 360 with caret edit states, color cream -> cyan).
  Demonstrates the stacked-absolute-span + tl.set opacity swap pattern that makes value
  cycling fully seekable under tl.seek(). Lifted from Archive/inspector-logo-intro.

- 12-04 Brand Moodboard: Aurora Studio brand book — monogram + 6 swatches + sticky note +
  5 reference cards + Fraunces/Archivo typography + 6 SVG hub-spoke connectors from logo.
  The "what is this brand?" opener. Lifted from claude-design/moodboard.html.

- 12-05 Cinematic Opener: the canonical minimal opener referenced in step-3-storyboard as
  Beat 1 example. Light-ball orb -> beam -> title fade-up -> settled hold -> fade. Lifted
  from claude-design/opener.html and rebranded HYPER FRAMES.

- 12-06 Design Extraction: meta beat showing the website-to-hyperframes pipeline itself.
  MacBook with composed LUMEN landing + animated DESIGN.md panel writing line-by-line +
  callout tags pinning on screen elements + EXTRACTING -> EXTRACTED stamp. Lifted from
  launch-video-2/act-2-extraction.html, decontextualized to fictional LUMEN brand.

Build approach: I authored 04-12 myself first (set the bar), then dispatched 4 sub-agents
in parallel for the others, verifying each via snapshot before accepting. All 5 lint clean,
all 5 rendered, all 5 uploaded to Verse, gallery patched with 5 new cards.

Grand Tour reel rebuilt with 62 scenes (7:10) at
https://www.heygenverse.com/s/67bb4ee5-1c7f-4837-b144-d2527b8ade83/raw.
Gallery at https://www.heygenverse.com/a/1636f2fe-3ddc-4543-9a56-0d0b99538807.

Section 04 jumps 11 -> 13 scenes, section 12 jumps 3 -> 6 scenes, total 57 -> 62.
2026-05-19 13:37:55 -07:00
ukimsanov 2bdba5e935 docs: finalize handoff — batches 7-9 (57 scenes, 3-mode wiring, READMEs synced)
Bumps the commit list (13 → 15), adds a "what batches 8 + 9 did" section explaining
the docs-sync work, and marks the library as internally consistent (every scene in
its section README + the master lookup table).
2026-05-19 10:55:29 -07:00
ukimsanov 6bbfafe0ff docs(skill): sync remaining section READMEs (01, 02, 04, 10, 11) — 9 missing scenes
After batch 8 covered the 3 sections that received new gap-fillers in batch 7 (07, 09, 12),
this catches up the section READMEs that were stale since batches 5-6:

- 01-typography README: add scene-12-intro-kinetic-text; bump scene count 10→12
- 02-markers-and-emphasis README: add scene-07-magnetic-caption-webgl (WebGL GLSL distortion caption)
- 04-composed-ui README: add scene-11-timeline-editor-ui (video editor UI demo); update header to mention the new categories
- 10-particles-and-ambient README: add scene-03-scan-line-grid (CRT-adjacent telemetry mood)
- 11-3d-and-parallax README: add scenes 02-vercel-triangle-roll, 03-card-flyby-deck, 04-anamorphic-text-crt, 05-iphone-device-gesture (4 new entries — section was at 1/5 documented)

examples/README.md lookup-by-technique table: add the same 4 scenes (01-12, 02-07, 04-10, 04-11)
to keep the top-level lookup at 57/57 parity with on-disk scenes.

Net effect: every scene in the library now appears in both its section README and the master
lookup table, so the technique-pick checklist in step-3 (which asks for `refs:` per beat)
has a reliable source for any scene the agent searches for.
2026-05-19 10:54:08 -07:00
ukimsanov f2d1d11dac docs(skill): sync library READMEs with batch 7 — 3-mode framework + 4 new scenes
examples/README.md:
- replaces rigid "copy the closest scene" with the 3-mode framework (copy+mutate / recombine / fresh) introduced in skill wiring
- adds 4 new scenes to the lookup table (07-04 iphone-mockup-live, 07-05 macbook-mockup-live, 09-03 counter-million-showcase, 12-03 product-launch-beat) + previously-missing 07-03, 10-03, 11-02..05, 12-02
- replaces fictional _stitched/ HTML reels with the real Grand Tour MP4 reel URL + gallery URL
- corrects authoring conventions: scenes are standalone HTML5 documents at <section>/scene-NN-name/index.html, not <template> fragments

Section READMEs (07, 09, 12):
- 07: adds scene-03 (cursor-blur), scene-04 (iphone-mockup-live), scene-05 (macbook-mockup-live) with QC notes
- 09: adds scene-03 (counter-million-showcase) with QC notes on the canonical tl.set() counter pattern
- 12: adds scene-02 (binary-rain-boot) and scene-03 (product-launch-beat) with QC notes including which other scenes were borrowed-from for the recombine demo
2026-05-19 10:42:39 -07:00
ukimsanov 8f4b7eb547 feat(skill): examples library batch 7 — 4 gap-fillers + 3-mode skill wiring (57 scenes)
Adds 4 high-leverage gap-filler scenes:
- 07-04 iphone-mockup-live: CSS iPhone with live Glow meditation app UI (streak, breathing badge, bottom-sheet modal)
- 07-05 macbook-mockup-live: CSS MacBook with simulated browser session (tab, URL bar type-on, page reveal)
- 09-03 counter-million-showcase: canonical 0->1,000,000 counter with 33 deterministic tl.set() calls
- 12-03 product-launch-beat: 6 techniques in one beat (stroke-draw logo + kinetic headline + counter + marker + particles + breathing)

Restructures skill wiring around 3 explicit modes (copy+mutate / recombine / fresh) after feedback
that the prior "copy the closest example" framing was too rigid and would produce derivative work:

- SKILL.md Step -1: introduces 3 modes + non-negotiable customization rule in every mode
- step-3-storyboard.md: technique-pick checklist now requires techniques + refs + mode + customize lines per beat
- step-5-build.md: mode-aware build process; expanded scene-mapping table with new gap-fillers
- beat-builder-guide.md: 3-mode table is first mandatory read; "examples are never the finished beat"

Examples library is now 57 scenes / 13 sections / 6:26 Grand Tour reel (b9cdfa1b).
Gallery app updated to reflect 57-scene state at https://www.heygenverse.com/a/1636f2fe-3ddc-4543-9a56-0d0b99538807.
2026-05-19 10:35:20 -07:00
ukimsanov 3d7564bb21 docs: update handoff with batch 6 - 53 scenes + Grand Tour reel
Library final state captured:
- 53 scenes across 13 sections (vs 49 in initial handoff)
- 4 new scene entries added to inventory + asset IDs:
  - 01-typography scene-12 intro-kinetic-text
  - 02-markers-and-emphasis scene-07 magnetic-caption-webgl
  - 04-composed-ui scene-11 timeline-editor-ui
  - 11-3d-and-parallax scene-05 iphone-device-gesture
- Grand Tour reel URL added (single 5:58 MP4 with all 53 concatenated)
- Commit history updated 9 -> 11
2026-05-19 09:39:06 -07:00
ukimsanov 466293364f feat(skill): examples library batch 6 - 4 more archive lifts (53 scenes total)
Final batch of high-value lifts from Downloads/Archive folders.

Section 01 typography (now 12 scenes)
  scene-12-intro-kinetic-text     <- Archive 2/intro-kinetic-text
  Three-section word stacks with massive fonts (Inter 220-500px,
  Playfair italic 520px in green/cyan accents). Background-clip:text
  + animated background-position gradient sweep on the hero word
  'ship'. Sections A/B/C: 'Your story starts.' / 'Now build loud.' /
  'And ship today.' Hero word per section uses power4.out for snap.

Section 02 markers-and-emphasis (now 7 scenes)
  scene-07-magnetic-caption-webgl <- Archive/magnetic-caption-webgl
  WebGL real-time text distortion: three phrases (THIS WARPS / WATCH
  CLOSELY / REAL-TIME GPU) get RGB chromatic aberration as a virtual
  magnetic cursor sweeps across each one. WebGL1 + Canvas 2D fallback
  pattern. Uses gsap.ticker.add() for the render loop. Adds a
  categorically novel WebGL-based emphasis technique to a section
  that was previously all CSS/SVG.

Section 04 composed-ui (now 11 scenes)
  scene-11-timeline-editor-ui     <- Archive 2/timeline-editor-launch-v5
  Full video-editor UI composed from divs: syntax-colored code editor
  pane (left), live preview canvas (right), timeline scrubber strip
  (bottom) with 5 stacked clips + moving red playhead synced to GSAP
  timeline via gsap.ticker.add(), render HUD with progress bar +
  frame counter (000/540) + status (Encoding -> Complete). All
  counters use deterministic tl.set() keyframes.

Section 11 3d-and-parallax (now 5 scenes)
  scene-05-iphone-device-gesture  <- Archive/heygen-iphone-canvas-test
  CSS 3D iPhone (rotateY(20deg) rotateX(-10deg)) showing composed
  'Today' app UI inside (hero card + 5 feed cards + tab bar). Pure CSS
  tap gesture (expanding ring) and swipe gesture (elongated arc with
  comet head). Two taps + one swipe at different timestamps. Replaces
  source's PNG gesture overlays with CSS-only indicators.

Library state after this batch:
  Section 01 typography:               12 scenes (+1)
  Section 02 markers-and-emphasis:      7 scenes (+1)
  Section 03 easing-variety:            1 scene
  Section 04 composed-ui:              11 scenes (+1)
  Section 05 transitions-shader:        1 scene
  Section 06 transitions-css:           1 scene
  Section 07 html-in-canvas:            3 scenes
  Section 08 svg-and-path:              1 scene
  Section 09 counters-and-data:         2 scenes
  Section 10 particles-and-ambient:     3 scenes
  Section 11 3d-and-parallax:           5 scenes (+1)
  Section 12 combined-vignettes:        2 scenes
  Section 13 anti-patterns:             4 scenes
  Total: 53 production-grade scenes across 13/13 sections.

Grand Tour reel uploaded: a single 5:58 MP4 with all 53 scenes
concatenated in section order via ffmpeg, embedded prominently at
the top of the gallery app:
https://www.heygenverse.com/s/bd3a5ac8-8b80-4dc8-af1b-20606a50456e/raw

Gallery app: https://www.heygenverse.com/a/1636f2fe-3ddc-4543-9a56-0d0b99538807
2026-05-19 09:34:17 -07:00
ukimsanov b2f4ee2638 docs: HANDOFF-examples-library.md — 49 scenes, gallery live, full session record
Comprehensive handoff for the May 19 examples library work. Covers:
- The 49 scenes across 13 sections with techniques + durations
- Scene origin breakdown (26 net-new authoring, 19 archive lifts, 8 JSON-spec implementations)
- All 49 HeyGen Verse asset IDs with raw URLs
- Gallery app ID + how to update via edit_html patches
- Skill wiring (SKILL.md Step -1, step-3 checklist, step-5 copy-closest, beat-builder-guide examples-first)
- 6 authoring conventions every scene follows
- 6 key technical findings discovered during authoring (canvas render loop, counter pattern, DOM mutation, CSS-locked initial state, render pipeline, HeyGen upload pipeline)
- All 9 git commits this session
- Source archives mined (3 in-repo + 2 Downloads dirs = 37 production projects scanned)
- Deferred work: stitched Grand Tour reel, agent self-test, 8-10 more high-value archive lifts
- Pickup instructions for the next session

The library is the lever HANDOFF.md Recommendation 2 named. Whether it actually shifts agent output character vs the v9 baseline is what the agent self-test (deferred) would validate.
2026-05-19 09:14:23 -07:00
ukimsanov 01e0098ed7 feat(skill): examples library batch 5 - 6 lifts from team archive
Mined /Users/ularkimsanov/Downloads/Archive and Archive 2 (37 production
HyperFrames projects from the team) and lifted 6 standout techniques into
the library that fill technique gaps not covered by the 43 existing scenes.

Section 07 html-in-canvas (now 3 scenes)
  scene-03-cursor-blur-sweeps     <- Archive/vfx-text-cursor
  Canvas 2D cursor-driven light sweeps (cyan + magenta gradient bars
  follow a virtual cursor) with chromatic-aberration text passes.
  Source used WebGL + bg video; rebuilt in pure Canvas 2D + procedural
  background to eliminate asset deps.

Section 10 particles-and-ambient (now 3 scenes)
  scene-03-scan-line-grid         <- Archive 2/hyperframes-codex-plugin-announcement
  CRT-adjacent ambient with 2px gradient sweep bar (3 passes), 80px+400px
  grid overlay with parallax drift, scanline texture, viewfinder ticks,
  telemetry HUD counters. Rebranded HyperFrames/Codex -> generic OBSERVE
  wordmark + SCAN/HOLD/REPEAT tagline.

Section 11 3d-and-parallax (now 4 scenes)
  scene-02-vercel-triangle-roll   <- Archive/vercel-triangle-roll
  Three.js 3D pyramid rotating through 6 distinct orientations with
  multi-material grayscale faces. Stripped Vercel SVG mark + energy
  shader (brand IP). Replaced source's onUpdate render with
  gsap.ticker.add() reading tl.time() per beat-builder-guide rule.

  scene-03-card-flyby-deck        <- Archive 2/card-flyby
  CSS 3D card deck tumble with diagonal clip-path wipe reveal. 6 colored
  cards (EMERALD, CRIMSON, PLUM, AMBER, MIDNIGHT, COBALT) fly through
  perspective viewpoint. Stripped brand titles to generic color names.

  scene-04-anamorphic-text-crt    <- Archive 2/anamorphic-text-crt
  Three.js 3D text morphing MOTION <-> DESIGN with full CRT HUD overlay
  (scan-lines, top/bottom HUD boxes, blinking dot). Uses TextGeometry +
  CSG Boolean ops. Rebranded source HYPERFRAMES/HERMES -> MOTION/DESIGN
  (both 6 chars for symmetric morph).

Section 12 combined-vignettes (now 2 scenes)
  scene-02-binary-rain-boot       <- Archive/hermes-hyperframes
  Matrix-style binary rain (Canvas 2D, 96 columns of falling 0/1 with
  white-hot heads + green tails) as background, with centered terminal
  panel typing in a generic boot sequence:
    > system.init
    > loading kernel...
    > [OK] memory mapped
    > [OK] network ready
    > ready.
  Combines techniques from source's binary-break.html + boot-sequence.html
  into one scene. Stripped HYPERFRAMES/Hermes references.

Conversion process per scene: standalone HTML5 wrapper, composition id
renamed, scene-label at bottom-left, project-specific branding stripped,
GSAP CDN linked, data-start/data-duration on root, canvas-render-loops
use gsap.ticker.add() per the beat-builder-guide rule. Each lift was
lint-clean (0 errors) and snapshot-verified across 6-8 frames.

Library state after this batch:
  Section 01 typography:               11 scenes
  Section 02 markers-and-emphasis:      6 scenes
  Section 03 easing-variety:            1 scene
  Section 04 composed-ui:              10 scenes
  Section 05 transitions-shader:        1 scene
  Section 06 transitions-css:           1 scene
  Section 07 html-in-canvas:            3 scenes (+1)
  Section 08 svg-and-path:              1 scene
  Section 09 counters-and-data:         2 scenes
  Section 10 particles-and-ambient:     3 scenes (+1)
  Section 11 3d-and-parallax:           4 scenes (+3)
  Section 12 combined-vignettes:        2 scenes (+1)
  Section 13 anti-patterns:             4 scenes
  Total: 49 production-grade scenes across 13/13 sections.

All 49 scenes rendered at draft quality + uploaded to HeyGen Verse +
browseable in the gallery app at:
https://www.heygenverse.com/a/1636f2fe-3ddc-4543-9a56-0d0b99538807
2026-05-19 08:52:55 -07:00
ukimsanov 68235f50e1 feat(skill): examples library scene 04-10 - terminal + live preview
One more lift bringing section 04 (composed-ui) to 10 scenes.

scene-10-terminal-with-preview <- launch-video/compositions/cta.html
  Two-column 8s scene. Left: terminal emulator with 2 sequential
  commands typing in ('npx create-app starter' then 'build me a
  launch page with hero + cta') + scaffold output streaming + status
  badges. Right: preview pane slides in, mock product card builds
  incrementally (avatar -> skeleton text -> headline -> CTA button ->
  decoration ring). Status badge flips 'Building...' -> 'Ready'.
  Continuous-motion holds throughout (card breath, decoration rotate,
  button shadow pulse).

Rebranded from HyperFrames-specific (npx hyperframes init, video
composition mockup) to generic (npx create-app starter, generic
product landing card). Source's tl.call() typewriter pattern (which
doesn't fire under tl.seek()) refactored to pre-built char spans +
steps(1) opacity stagger so the scene snapshots cleanly.

Library final state:
  Section 01 typography:               11 scenes
  Section 02 markers-and-emphasis:      6 scenes
  Section 03 easing-variety:            1 scene
  Section 04 composed-ui:              10 scenes
  Section 05 transitions-shader:        1 scene
  Section 06 transitions-css:           1 scene
  Section 07 html-in-canvas:            2 scenes
  Section 08 svg-and-path:              1 scene
  Section 09 counters-and-data:         2 scenes
  Section 10 particles-and-ambient:     2 scenes
  Section 11 3d-and-parallax:           1 scene
  Section 12 combined-vignettes:        1 scene
  Section 13 anti-patterns:             4 scenes
  Total: 43 production-grade scenes across 13/13 sections.

All sections now have at least one bar scene. Future sessions can
deepen the slim sections (03, 07, 08, 11, 12 each have only 1-2 scenes)
or move to the remaining deferred work: stitched reels, HeyGen Verse
arena upload, agent self-test on a fresh worktree to verify the
wiring shifts technique usage vs the v9 baseline.
2026-05-19 07:50:21 -07:00
ukimsanov 01ef436888 feat(skill): examples library batch 4 - sections 05 + 06 complete, library reaches 13/13
Two new bar scenes filling the final empty sections.

Section 05 transitions-shader (NEW, 1 scene PASS QC):
  scene-01-shader-transitions-showcase
    4-panel grid demonstrating 4 shader-transition effects between
    A/B beats — chromatic-split (RGB channel offset + scanlines),
    sdf-iris (circle reveal with edge ring), domain-warp (organic FBM
    noise dissolve), whip-pan (horizontal motion-blur swipe).
    Implemented in Canvas 2D + GLSL-style algorithms so the scene is
    standalone (no @hyperframes/shader-transitions module dependency).
    Uses gsap.ticker.add() reading tl.time() per the new
    beat-builder-guide CANVAS RENDER LOOPS rule.

Section 06 transitions-css (NEW, 1 scene PASS QC):
  scene-01-css-transitions-grid
    2x3 grid of 6 CSS transitions between Beat A and Beat B states:
    push (translateX coordinated), scale (down+fade -> up+fade with
    back.out overshoot), blur dissolve (filter:blur ramp), 3D flip
    (preserve-3d + perspective + backface-visibility:hidden coin
    flip), light leak wipe (rotated gradient div with blur), classic
    dissolve (opacity crossfade). Transitions staggered to catch
    different completion states across snapshot frames. Frame 4
    catches the 3D flip mid-rotation — the money shot.

Top-level README lookup table:
- Replaced all .html paths with directory paths (matches actual
  scaffolded layout).
- Added all 11 newly-added scenes (typography 04-11, all of 02
  markers, 03 easing, 05/06 transitions, 07-08 svg/canvas-ascii,
  09-10 counters/particles, 11 3d, 12 combined, 13 anti-patterns).
- Lookup is now accurate to filesystem.

Library state after this batch:
  Section 01 typography:               11 scenes
  Section 02 markers-and-emphasis:      6 scenes
  Section 03 easing-variety:            1 scene
  Section 04 composed-ui:               9 scenes
  Section 05 transitions-shader:        1 scene  (new)
  Section 06 transitions-css:           1 scene  (new)
  Section 07 html-in-canvas:            2 scenes
  Section 08 svg-and-path:              1 scene
  Section 09 counters-and-data:         2 scenes
  Section 10 particles-and-ambient:     2 scenes
  Section 11 3d-and-parallax:           1 scene
  Section 12 combined-vignettes:        1 scene
  Section 13 anti-patterns:             4 scenes
  Total: 42 production-grade scenes across 13/13 sections.

Library is now structurally complete. Future work: add more scenes
per section to widen technique coverage (especially 03, 07, 08, 11,
12 which have only 1-2 scenes each), build stitched reels for the
arena, run agent self-test to verify the wiring actually shifts
technique usage.
2026-05-19 07:42:01 -07:00
ukimsanov 128e0f8829 feat(skill): examples library batch 3 - sections 02 + 13 + beat-builder-guide updates
10 new scenes filling sections 02 (markers-and-emphasis) and 13 (anti-patterns), plus 3 rule additions to beat-builder-guide.md.

Section 02 markers-and-emphasis (NEW, 6 scenes all PASS QC):
  scene-01 highlight-sweep            yellow bar scaleX 0->1 behind key word
  scene-02 hand-drawn-circle          SVG ellipse stroke-dashoffset draw
  scene-03 burst-radial               12 radial spikes from key word (back.out(2))
  scene-04 scribble-underline         wavy sine-path stroke-dashoffset draw
  scene-05 sketchout-x                two diagonal strokes + replacement phrase
  scene-06 combined-marker-cascade    all 5 marker techniques in one phrase

Section 13 anti-patterns (NEW, 4 scenes all PASS QC):
  scene-01 slideshow-trap             3 screenshot panels + Ken Burns + crossfade
  scene-02 static-after-entrance      entrance in 1.5s then 7.5s of nothing (countdown overlay)
  scene-03 power2-everywhere          side-by-side LEFT all power2.out vs RIGHT varied easings
  scene-04 screenshot-ken-burns       fake-screenshot rectangle + linear drift (the eval-default failure)

Each anti-pattern scene has on-screen red ANTI-PATTERN banner + inline THE PROBLEM source comments + counter-reference paths to the GOOD scene for that failure mode.

beat-builder-guide.md added 3 rules:
- COUNTERS: 20-30 tl.set() calls along duration is canonical seekable pattern (cite scene-05-dashboard-counters)
- CANVAS RENDER LOOPS: do NOT tl.to(proxy, onUpdate:render); doesn't fire under tl.seek(). Use gsap.ticker.add() reading tl.time() (cite scene-02-canvas-ascii)
- DOM MUTATION IN TIMELINE: do NOT tl.call() to build DOM; build all DOM upfront (cite scene-01-soft-blur-in)

Library state after this batch:
  Section 01 typography:               11 scenes
  Section 02 markers-and-emphasis:      6 scenes (new)
  Section 03 easing-variety:            1 scene
  Section 04 composed-ui:               9 scenes
  Section 07 html-in-canvas:            2 scenes
  Section 08 svg-and-path:              1 scene
  Section 09 counters-and-data:         2 scenes
  Section 10 particles-and-ambient:     2 scenes
  Section 11 3d-and-parallax:           1 scene
  Section 12 combined-vignettes:        1 scene
  Section 13 anti-patterns:             4 scenes (new)
  Total: 40 production-grade scenes across 11 of 13 sections.

Sections 05 (transitions-shader) and 06 (transitions-css) remain empty - these need fresh authoring or shader-transitions package integration.
2026-05-19 02:52:47 -07:00
ukimsanov 7a6ffc282a feat(skill): examples library batch 2 — 6 more lifts from production projects
Mined launch-video, launch-video-2, and claude-design-hyperframes-video
projects for another 6 production-grade scenes, populating 4 more sections.

Lifts (all PASS QC via contact sheet review):

  Section 04 composed-ui (now 9 scenes)
    scene-09-phone-mockups            ← claude-design/compositions/phones.html
    Two 3D iPhone mockups in perspective with realistic bezels, dynamic
    island, home indicator. Scene 1: fictional Pulse fitness app (orange
    ride card + Activity rings + Today calendar). Scene 2: fictional Echo
    music player (Road trip playlist + Echo album with waveform +
    Visualizer EQ bars). All composed from CSS+SVG, no screenshots.
    Rebranded from Strava/Spotify; replaced Photos+Camera screens (asset-
    dependent) with all-CSS Activity rings + SVG Visualizer. All 9 counter
    animations converted from onUpdate to discrete tl.set(textContent).

  Section 07 html-in-canvas (now 2 scenes)
    scene-02-canvas-ascii              ← launch-video/compositions/canvas-close.html
    Canvas 2D ASCII art with procedural noise + BFS depth map + lightning
    + 5x5 bitmap font. Lightning strikes reveal 'THE END' in amber ASCII
    glyphs with 'GO MAKE SOMETHING' subtext. Pure JS canvas (no external
    deps). **Key finding**: source's gsap proxy + onUpdate render pattern
    does NOT fire under tl.seek(); refactored to gsap.ticker.add()
    reading tl.time() each frame. This is the reliable pattern for
    canvas-render-by-time scenes under HyperFrames' seekable engine —
    documented in section README so future canvas scenes copy this.

  Section 09 counters-and-data (new, 2 scenes)
    scene-01-timeline-diagram         ← launch-video/compositions/anatomy.html
    Editorial cream/parchment background. Multi-phase build: eyebrow
    'anatomy of a composition' → div rectangles dock on timeline → SVG
    easing curve draws → teal slider follows curve via MotionPath →
    camera zooms onto curve → exit blur. Strong educational viz pattern.

    scene-02-pipeline-diagram         ← launch-video/compositions/engine.html
    Vertical scroll-pan camera through Agent → Renderer → MP4 pipeline.
    SVG dashed flow connectors with orange pip markers slide between
    stages. Climaxes with side-by-side card stack proving determinism
    + 'Identical output, every time.' badge.

  Section 10 particles-and-ambient (new, 2 scenes)
    scene-01-radial-bloom-grid        ← launch-video/compositions/flex-gsap.html
    15x25 grid of 375 dots with GSAP stagger.from='center'. Three-phase
    timeline: center-out bloom → elastic cursor-sweep ripple →
    explosion+blur exit. Duration extended from 0.69s to 3s for visible
    bloom progression across snapshot frames.

    scene-02-aurora-end-card          ← launch-video-2/act-4-end-card.html
    Radial gradient aurora (violet/cyan/mint/magenta) + 12 floating
    particles + 'MOTION STUDIO' wordmark with tri-color text gradient +
    install command 'npx create-motion-studio' typing in with cursor +
    breath accent dot. Rebranded from HyperFrames; local Inter-Variable/
    JetBrainsMono-Variable.woff2 swapped to Google Fonts CDN.

Library state after this batch:
  Section 01 typography:        11 scenes
  Section 03 easing-variety:    1 scene
  Section 04 composed-ui:       9 scenes
  Section 07 html-in-canvas:    2 scenes
  Section 08 svg-and-path:      1 scene
  Section 09 counters-and-data: 2 scenes (new)
  Section 10 particles-and-ambient: 2 scenes (new)
  Section 11 3d-and-parallax:   1 scene
  Section 12 combined-vignettes: 1 scene
  Total: 30 production-grade scenes across 9 sections.

Sections 02, 05, 06, 13 still empty. Future sessions can fill them with
fresh authoring (no obvious lifts from source projects for those
categories).
2026-05-19 02:41:09 -07:00
ukimsanov 7ec923cb0f feat(skill): examples library lifts from 3 production projects (6 scenes)
Mined launch-video, launch-video-2, and claude-design-hyperframes-video
projects for production-grade compositions and lifted 6 of them into the
examples library as the BAR scenes for previously-empty sections.

Lifts (all PASS QC via contact sheet review):

  Section 03 easing-variety
    scene-01-css-animation-grid       ← launch-video/compositions/flex-css.html
    6x3 grid of pure-CSS animations: spinners, pulses, morphs, waves,
    orbits, gradient cycles, flip cards, bars, bounces. Duration extended
    from 1.71s to 3.5s so snapshot intervals catch distinct motion states.

  Section 07 html-in-canvas
    scene-01-webgl-shader             ← launch-video/compositions/flex-shader.html
    WebGL fragment shader with domain-warp FBM noise + cosine palette.
    Canvas 2D fallback UPGRADED from static gradient to animated multi-stop
    radial + iridescent linear sweep so the fallback is also a good pattern
    to copy.

  Section 08 svg-and-path
    scene-01-vinyl-record             ← launch-video/compositions/flex-music.html
    SVG vinyl record (7 concentric grooves, label, shine, tonearm
    pivot/shaft/cartridge/stylus). Duration extended 0.58s → 3s for visible
    spin across snapshot intervals.

  Section 11 3d-and-parallax
    scene-01-css-3d-torus             ← launch-video/compositions/flex-threejs.html
    16-segment orbital ring of pastel rounded squares rotating through 3D
    space via transform-style: preserve-3d + perspective. Pure CSS, no
    Three.js library required despite the source's filename.

  Section 12 combined-vignettes
    scene-01-techniques-grid          ← claude-design-hyperframes-video/compositions/grid.html
    GOLD: 6x4 grid of 24 cells, each running a different visual technique
    (clock, rings, stripes, 3D cube, dot grid, QR, stock chart, blob morph,
    particle vortex, glowing orb, spirograph, DNA helix, neural network,
    burst rays, kinetic MOTION word, glitch SYSTEM->RENDER text, sine waves,
    code editor, spinners, binary rain, maze, audio bars, neon globe,
    weather card). Single highest-density technique reference in the library.
    Rebranded CLAUDE -> MOTION and DESIGN -> RENDER. Source's innerHTML build
    replaced with createElementNS for security-hook compliance.

  Section 01 typography (bonus scene)
    scene-11-orbital-title            ← claude-design-hyperframes-video/compositions/letters.html
    KINETIC TYPE Fraunces serif title with per-character alternating-side
    entrance + SVG accent line stroke draw + orbital ring rotation + radial
    glow breathing + 4-segment type-on tagline. Rebranded HYPER FRAMES ->
    KINETIC TYPE and HTML in. Video out. -> Code in. Motion out. (same char
    counts so stagger math is unchanged). Source's onUpdate-driven tagline
    refactored to pre-rendered char spans with autoAlpha stagger to fix
    seek determinism.

Conversion process per scene: standalone HTML5 wrapper added (was a
<template> sub-composition), composition id renamed everywhere, scene-label
added at bottom-left, project-specific branding stripped, GSAP CDN linked,
data-start/data-duration added on root. Each lift was lint-clean (0 errors)
and snapshot-verified across 6-8 frames.

Library state after this batch:
  Section 01 typography:        11 scenes
  Section 03 easing-variety:    1 scene
  Section 04 composed-ui:       8 scenes
  Section 07 html-in-canvas:    1 scene
  Section 08 svg-and-path:      1 scene
  Section 11 3d-and-parallax:   1 scene
  Section 12 combined-vignettes: 1 scene
  Total: 24 production-grade scenes across 7 sections.

Sections 02, 05, 06, 09, 10, 13 still empty. Future sessions can lift
anatomy.html and engine.html (launch-video) into section 09 counters,
flex-gsap.html into section 10 particles, and continue filling out the
library.
2026-05-19 02:07:15 -07:00
ukimsanov ba0098ca3a feat(skill): wire examples library into the workflow
Make the example library load-bearing in 4 places:

1. SKILL.md — new 'Step -1: Study the Example Library' BEFORE Step 0.
   Mandatory: read examples/README.md + at least 3 scene HTMLs before
   planning. Names which scenes are 'the bars' (04-composed-ui scene 01
   kanban + scene 02 chat). Non-negotiable rule: if you'd reach for a
   product screenshot of an interface as a primary visual, STOP and
   build that UI from divs using the matching example scene.

2. step-3-storyboard.md — Technique-pick checklist after the pacing
   table. Every beat must name 2-4 techniques AND cite the matching
   example scene path. Beats with <2 cited techniques must be redesigned.
   Forbidden: 'show the kanban' as a beat with no scene citation.

3. step-5-build.md — Copy-closest mandate added to the build section.
   Concrete map from beat type to example scene path. Do not write
   any beat from scratch; there is always a closer example.

4. beat-builder-guide.md — Example scene moved to the #1 mandatory
   read for every beat. Sub-agents copy the cited scene's index.html
   to compositions/beat-N-name.html and mutate, not write from scratch.
   Specific call-out: if the beat has narration, also study
   examples/04-composed-ui/scene-02-chat-with-typing — the canonical
   narration-sync pattern (every meaningful phrase = one visual event).

This is the lever HANDOFF Recommendation 2 named: agents pattern-match
to what they study, not to skill prose. With 18 production-grade scenes
in the library and the workflow now requiring agents to copy them as
starting points, the screenshot+Ken-Burns default has somewhere better
to go.
2026-05-19 01:41:04 -07:00
ukimsanov a877da7088 feat(skill): examples library section 04 — composed UI, 8 scenes
The highest-leverage section in the library. Every scene demonstrates a
product UI element built from divs + GSAP — zero screenshots, zero
captured assets. Directly addresses the 'every agent screenshots the
kanban / chat / dashboard / terminal' failure mode from the 11 eval runs.

Section 04 scenes (all PASS QC):
  01 kanban-board          — 3-column kanban with cards entering staggered,
                             drag-from-Todo-to-In-Progress with shadow ramp,
                             column count chip pulse on drop
  02 chat-with-typing      — chat panel with 3 messages, reaction emoji
                             burst, typing indicator (3 bouncing dots),
                             self-reply slide-in. Every visual event lands
                             at a narration anchor timestamp. THE
                             narration-sync gold standard.
  03 terminal-typeon       — terminal window with multi-line command +
                             output type-on (steps(1) ease), green exit
                             badge with elastic settle + floor glow.
  04 command-palette       — Cmd+K modal with backdrop blur, keystroke
                             entry, real-time filter, focus ring on top
                             result, dismiss + action toast + new activity.
  05 dashboard-counters    — 4 KPI cards, counter 0→128K via deterministic
                             tl.set(textContent), sparkline stroke-dashoffset
                             draw, donut fill 0→87%, multi-stat ticks,
                             live mode with status pulses.
  06 file-tree-reveal      — VS Code-style file tree, folders expand
                             progressively, selection bar slides into
                             place, editor opens parse.ts with syntax
                             colors, git modified badges pulse.
  07 code-editor-typing    — multi-line type-on with per-span syntax colors,
                             red error squiggle + tooltip + status bar
                             flip, fix typed via tl.set(textContent),
                             status returns to blue.
  08 calendar-events       — weekly grid with today highlighted, 6 events
                             slide in staggered, 'happening now' event
                             pulses, popover slides up with attendees,
                             red 'now' time indicator drifts.

Authored by hand: scenes 01 and 02 (the bars). Scenes 03-08 dispatched
to parallel sub-agents using scenes 01-02 as templates; every return was
visually QC'd via contact-sheet review before being marked PASS in the
section README.
2026-05-19 01:14:36 -07:00
ukimsanov 04827b98ce feat(skill): examples library scaffold + section 01 (typography) — 10 scenes
First slice of the HyperFrames Capability Showcase library at
skills/website-to-hyperframes/examples/. Each scene is a self-contained
mini-project (index.html in its own directory) that lints, snapshots, and
renders standalone.

Section 01 (typography) — 10 production-grade scenes, all PASS QC:
  01 soft-blur-in              — Apple keynote per-character reveal
  02 typewriter-mechanical     — stepped per-char terminal type-on
  03 kinetic-center-build      — words push in right-to-left, lock center
  04 line-reveal-staggered     — editorial mask-reveal-up with Fraunces italic
  05 stagger-wave              — center-out vs edges-in stagger origins
  06 variable-font-weight-shift — wght 100→900 animation via @property
  07 shared-axis-crossfade     — Material Design Z-axis depth transition
  08 glitch-rgb-split          — RGB channel offset with mechanical jitter
  09 scramble-decrypt          — per-char intermediate substitution decrypt
  10 per-word-emphasis         — per-word crossfade + hand-drawn marker

Plus catalog + shared assets:
  - examples/README.md             — top-level index + lookup by technique
  - 01-typography/README.md        — section spec + QC log per scene
  - _shared/hyper-shader-local.js  — copied from packages/shader-transitions/dist/
  - _shared/shared-styles.css      — design tokens
  - _shared/easing-glossary.md     — single source of truth for easings

Authoring conventions are documented in examples/README.md so future scenes
follow the same shape: full HTML doc, GSAP CDN, CustomEase, data-composition-id/
start/duration/width/height on root, scene-label at bottom-left, continuous
motion (no static periods >1.5s), easing variety (3+ different easings).

.gitignore: fixed bare 'examples/' rule (matched anywhere) to '/examples/'
(root-only), and added rule to skip snapshot artifacts inside the library.
2026-05-19 00:57:06 -07:00
ukimsanov e1bd22d4c8 fix(skill): beats must have continuous motion, not just entrance animations
The #1 quality problem: agents write entrance tweens in the first 1-2 seconds
of a beat, then nothing happens for the remaining duration. A 13-second beat
with 6 tweens = 11 seconds of static content.

step-3: Animation Sequence section now explicitly requires events spanning
the FULL beat duration. Nothing unchanged for more than ~2 seconds.

beat-builder-guide: "Continuous motion" added as the first and most important
rule — above all technical rules. Ken Burns drift, parallax, breathing,
secondary elements appearing mid-beat.
2026-05-18 12:18:47 -07:00
ukimsanov ec5edfa1df feat(snapshot): font verification + pacing-first + creative summary removal
snapshot: report loaded vs failed fonts via document.fonts API
step-3: pacing is FIRST decision at top of file
step-2 + SKILL.md: no more creative summary confirmation
step-5: sub-agent prompt includes explicit snapshot + lint commands
2026-05-18 01:45:06 -07:00
ukimsanov 7a283b6c40 fix(skill): asset selection guidance + remove creative direction summary
step-3: distinguish product assets from decorative assets — product
screenshots show what the product does, decorative images can be backgrounds
but shouldn't be the beat content. Never use contact sheets or scroll
screenshots in the video (they have grid labels baked in).

step-2: remove Creative Direction Summary confirmation — agents were
rephrasing the user's prompt and asking "does this match?" The storyboard's
Global Direction section already captures the same info. Proceed directly
to Step 3.

HeyGen TTS v3 API verified: response shape { "data": { "audio_url",
"duration", "word_timestamps" } } is correctly documented.
2026-05-18 00:33:59 -07:00
ukimsanov f5e4a67605 feat(skill): beat-builder-guide.md — self-contained sub-agent workflow
Sub-agents now read beat-builder-guide.md directly instead of relying on the
main agent to paste rules into the prompt (which truncated easing, validation,
and file references). The guide has:

- Full reference table: capabilities.md, techniques.md, text-effects.md,
  html-in-canvas-patterns.md, transitions/, css-patterns.md, audio-reactive.md,
  captions.md, typography.md, motion-principles.md, dynamic-techniques.md,
  video-composition.md + all loadable skills (gsap, animate-text, lottie, three, etc.)
- Build → lint → snapshot → verify → report workflow
- Rules, easing vocabulary, composition template
- Self-verification: sub-agents snapshot their own beats and fix issues before reporting

Step-5 template simplified: just paste beat spec + brand values + asset paths,
tell sub-agent to read beat-builder-guide.md. No more 90-line inline rules block.

SKILL.md: sub-agent mode on by default, "no sub-agents" option for sequential build.
2026-05-18 00:12:44 -07:00
ukimsanov 853d92eff8 fix(skill): move easing vocabulary into RULES section so sub-agents see it
The easing table was after the RULES section in step-5. Sub-agent prompts
paste ═══ RULES ═══ through the end of rules but stop before the easing
section. Result: 0/4 v8 agents used any non-default easing.

Fix: condensed easing guidance into a single RULES bullet that gets pasted
into every sub-agent prompt. power4.out for snap, back.out(1.7) for impact,
expo.out for soft land, elastic.out for bounce, expo.inOut for dramatic.
2026-05-17 23:30:09 -07:00
ukimsanov cefd03fcd9 fix(skill): don't ask questions the user already answered in their prompt
step-2-brief.md previously said "Do NOT skip this step" and forced agents to
ask all 5 questions even when the user's prompt already specified video type,
style, and specific scenes. Now: parse the prompt first, skip questions that
are already answered, only ask about gaps.
2026-05-17 22:37:41 -07:00
ukimsanov f606cdfc0f refactor(pipeline): strip dead capture outputs, add easing vocabulary, streamline skill
Capture CLI:
- Remove detected-libraries.json, assets-catalog.json, full-page.png generation
- Remove detectedLibraries from AGENTS.md generator and buildPrompt

Skill:
- step-5: pro easing vocabulary + stacked-beats code pattern for fast pacing
- step-3: contact sheet asset discovery, marketing assets vs screenshots distinction
- SKILL.md: lighter DESIGN.md for fast pacing, no arbitrary GSAP call count
2026-05-17 21:26:56 -07:00
ukimsanov 5e33c32565 feat(pipeline): pacing system, launch-video skill, verification gates, skill cleanup
Pipeline pacing:
- step-3: add pacing → beat structure table mapping Fast/Moderate/Slow/Arc to
  concrete beat count, duration, and architecture choices
- step-5: add architecture selection based on pacing (stacked beats for fast,
  HyperShader sub-comps for moderate/slow) with cinematic beat patterns

Launch-video skill (from upstream PR #699):
- Billboard-per-beat pattern for fast-paced videos
- Stacked divs with GSAP opacity sequencing, no sub-compositions

Verification improvements:
- step-6: Definition of Done checklist, per-beat verdict protocol, critic scoring

Skill cleanup (~1,600 lines saved per session):
- capabilities.md (704 lines) → capabilities-overview.md (34 lines)
- beat-direction.md inlined into step-3 (motion verbs + transition matrix)
- narration.md inlined into step-3 (pacing formula + hook patterns)

Other fixes:
- agentPromptGenerator.ts: fix outputDir scope crash
- step-1: font availability check
- step-3: block name ≠ shader name warning
- step-4: TTS test clip, background music prompt
- step-5: HyperShader.init() pattern, sequential track indices, GSAP FROM TRAP
- step-6: GEMINI_API_KEY export for subshell inheritance
2026-05-17 16:21:23 -07:00
ukimsanov a997f79c37 fix(pipeline): auto-load .env, second-based snapshot names, banner dismissal, critic sub-agent
cli: auto-load .env from CWD so GEMINI_API_KEY/HEYGEN_API_KEY work without
source .env — agents no longer need to manually export keys

snapshot: rename frames to seconds (e.g. frame-00-at-4.2s) instead of
pct (frame-00-at-20pct) — more useful when comparing against storyboard

screenshotCapture: dismiss marketing banners, cookie consents, and
modals before scrolling — prevents popups contaminating screenshots

step-6: replace verbose manual review instructions with:
- required reads: descriptions.md AND contact-sheet.jpg (both)
- critic sub-agent prompt for honest constructive quality assessment
  before showing anything to the user
2026-05-16 14:34:07 -07:00
ukimsanov 0df846b2c6 fix(skill): warn against published CLI for capture and snapshot
Both commands have critical fixes only in the local build:
- capture: paginated contact sheets, SVG root scan
- snapshot: sub-comp wait, local-time seek, Gemini descriptions

Published npx hyperframes 0.6.6 missing all of these.
Added warnings to step-0 and step-6 so agents cannot miss it.
2026-05-16 12:41:44 -07:00
ukimsanov 215b41dc46 fix(linter): add invalid_capture_path error rule
Catches ../capture/ in sub-composition files — the most persistent
sub-agent mistake across v1-v4 (100% failure rate on framer, 4+ rounds).
Documentation rules in sub-agent prompts were not sufficient.

The rule fires as a hard error so lint fails until paths are corrected.
../capture/ works on disk but breaks in Studio and renders (Studio rewrites
base URLs to the project root). Must use capture/ not ../capture/.

Verified: fires correctly on compositions with ../capture/ paths.
2026-05-16 12:22:05 -07:00
ukimsanov 841f877061 feat(snapshot): gemini vision descriptions + v4 skill fixes
snapshot: add --describe flag (default on) for Gemini vision analysis
- describes every frame with the default prompt or a custom question
- auto-resizes 1920x1080 PNGs via sharp to stay under Gemini 4MB limit
- writes snapshots/descriptions.md for agents to compare against storyboard
- errors visible in descriptions.md instead of silently swallowed
- silent skip when GEMINI_API_KEY not set

step-5: block-name vs shader-name, css centering, last-scene workaround
step-4: kokoro ssml tags read as literal text
skill: autonomous mode when user signals skip collaborative gates
step-6: document --describe usage and descriptions.md workflow
2026-05-16 12:18:02 -07:00
ukimsanov 07c5679019 docs: add v4 agent feedback with root cause analysis 2026-05-16 11:52:50 -07:00
ukimsanov 4ae59e5a7d fix(snapshot): two sub-composition seek bugs causing black beats
Bug 1: snapshot fired before all sub-compositions loaded
- Old: resolved when keys.length >= 2 (first sub-comp registered)
- Fix: wait until all data-composition-src hosts have timelines
- Verified: beats 2-4 now visible in huly-promo v4 snapshots

Bug 2: sub-comp timelines seeked to global time, not local time
- Old: tls[key].seek(globalTime) — with exit animations, global t=29
  clamps to GSAP end (t=7), elements at opacity:0 from exit fade
- Fix: seek to global_t - host.data_start (correct local time)
- Verified: beat-5 (starts at t=26.7) seeked to local t=2.3 at
  global t=29 — 'Join the Movement' now visible in snapshots

Both bugs confirmed via render vs snapshot comparison before fixing.

Also fix HeyGen v3 API docs: response is data.audio_url not audio_url
directly; word_timestamps uses 'word' key not 'text' — normalize before
saving as transcript.json
2026-05-16 11:48:09 -07:00
ukimsanov a5a405efd1 refactor(pipeline): reduce overengineering — cut reading burden
skill/SKILL.md: remove Step 5.5 Self-Critique (agents couldn't verify
visuals via snapshots anyway; step was theoretical without visual feedback)

step-1-design.md: 9 sections → 8
- remove Responsive Behavior section (video is fixed 1920x1080)
- remove Inputs/Forms, Navigation, Links from Component Stylings
  (these are never used in video compositions)
- rename and keep Agent Prompt Guide (most-consulted section per docs)
- remove 200-400 line target (was driving padding)

step-3-storyboard.md: remove Implementation References per-beat block
- was the most verbose part of the storyboard template
- sub-agent template in step-5 already handles targeted file reads
- agents were filling it mechanically without adding value

evidence: v2+v3 agents reporting 40% of session time spent reading docs;
storyboard writing cited as second biggest time sink
2026-05-16 06:48:36 -07:00
ukimsanov ebdc8d3725 fix(pipeline): loom v3 fixes, HeyGen v3 API, snapshot auto-clear, beat timing docs
snapshot: auto-clear png/jpg files before each run so old frames don't
mix into contact sheets (confirmed issue from loom v3 agent report)

step-4-vo: update HeyGen TTS to v3 API (current; v1/v2 deprecated Oct 2026)
- list voices: GET /v3/voices?engine=starfish, response is data[] direct list
- generate: POST /v3/voices/speech, returns audio_url + word_timestamps
- HeyGen v3 no longer needs separate transcription step
- v2 data.voices shape documented as legacy

step-5-build RULES: add HyperShader+beat timing rules from v3 findings
- timeline:tl pattern breaks scrubber — let HyperShader create timeline
- proxy+onUpdate doesn't fire in seek mode — use discrete tl.set() calls
- shader name validation: check ls registry/blocks/ before writing

step-3-storyboard: add Beat Timing section to each beat template
- agents specify transition-in time + GSAP duration so step-5 can set
  data-start and data-duration without guessing
2026-05-16 06:26:05 -07:00
ukimsanov d7d0ee6e6a docs: update HANDOFF with v3 run results and new P0 findings 2026-05-16 05:11:50 -07:00
ukimsanov ba9aa4c791 docs: data-start rule in sub-agent RULES, v3 feedback with arc root cause 2026-05-16 05:05:21 -07:00
ukimsanov f74beb8362 fix(pipeline): document data-start/data-duration rule for HyperShader beats
root cause verified from arc-launch v3 render analysis:
- all beats had data-start=0 and data-duration=26 (total video length)
- engine seeks each beat's sub-composition to global_time - data_start
- with data-start=0, beat-2 (BEAT=5.5s GSAP) is seeked to global_t=7
- gsap timeline exhausted at t=5.5, engine marks sub-comp invisible
- content disappears exactly at each beat's GSAP timeline end

fix verified: sequential data-start per transition point + data-duration
matching each beat's GSAP duration → all beats render correctly

added concrete code example to step-5-build.md with explanation
2026-05-16 04:40:25 -07:00
ukimsanov a2ccc1e6fa fix(pipeline): transcript CWD footgun and template script/style rules
cli/transcribe: default output dir to dirname(inputPath) instead of CWD
- transcript.json now lands next to narration.wav regardless of CWD
- fixes silent stale-transcript poisoning when running from repo root

step-5 sub-agent RULES: script+style inside template (verified root causes)
- mercury v3: scripts outside template caused ALL GSAP to silently fail
- workos v3: CSS style blocks inside template not applied after injection
- expanded querySelector null guard: getTotalLength crash documented
2026-05-16 04:20:13 -07:00
ukimsanov ca4c5cc18e docs: add v3 agent feedback with root cause analysis and cross-iteration comparison 2026-05-16 04:06:53 -07:00
ukimsanov 8db7300bda docs: mark v3-prep fixes in agent feedback status table 2026-05-16 02:19:31 -07:00
ukimsanov 36953172bf fix(pipeline): sfx timing rules, font wiring, asset paths, captions, kokoro
step-3: sfx placement rules grounded in audio production standards
- impact sounds: trigger at visual moment, let decay tail bleed (J-Cut)
- riser/build-up: trigger at climax_time - sfx_duration so peak lands on moment
- data-duration must equal manifest duration, never trimmed to fit beat time
- volume under narration: 0.2-0.3 max (no auto-ducking in HyperFrames)
- vo start timing: explicit storyboard decision, document in Global Direction

step-5: asset path rule as first sub-agent rule, impossible to miss
- @font-face: paste declaration into sub-agent prompt explicitly
- Inter Variable -> Inter (compiler only maps base name)
- querySelector null guard: getElementById for elements inside beat hosts
- wcag gradient false positive: data-layout-ignore for decorative elements
- captions stacking: initial opacity:0, one group visible, verify with snapshot

step-4: kokoro pronunciation guidance
- known failure patterns: Vercel, WorkOS, One API
- phonetic substitution workflow: test first sentence, fix in narration.txt
2026-05-16 02:18:30 -07:00
ukimsanov 65533efa8e docs: update HANDOFF and feedback doc with v2 run fixes and status 2026-05-16 01:59:25 -07:00
ukimsanov f8e733b976 fix(pipeline): snapshot wait, SFX ownership, VO timing, optional shader
snapshot: fix two shader pre-render wait failure modes
- Cold cache: overlay stays in DOM as display:none after hiding,
  element-absence check never resolved, always timed out at 60s
- Warm cache: IndexedDB hydration runs without overlay, absence check
  resolved instantly while prewarming was still in progress
- Fix: primary signal is window.__hf.shaderTransitions[].ready;
  overlay display:none is fallback for older builds
- Verified: huly-promo snapshots show composition content, not loader

shader-transitions: optional shader field for CSS crossfade mixing
- TransitionConfig.shader is now optional (ShaderName | undefined)
- Omitting shader = smooth CSS opacity crossfade via fallback path
- CSS-only transitions skip program compilation and prewarming
- HfTransitionMeta.shader made optional in engine/src/types.ts
- Verified: mixed CSS + WebGL composition renders all three beats correctly

step-3-storyboard: SFX assigned here with exact files, not in Step 5
- Agent reads sfx/manifest.json and assigns exact filenames per moment
- Less-is-more: most beats need zero SFX, one max per beat
- Removed duplicate HTML-in-Canvas API detail (build concern, not storyboard)

step-5-build: implement storyboard SFX exactly, zero creative decisions

step-4-vo: required timing reconciliation gate before Step 5
- Compare real audio vs planned total; if delta >15% rescale or trim
- Hard cap on CTA hold: 2-3s after last word, not extended dead silence
2026-05-16 01:55:39 -07:00
ukimsanov f4f6739510 docs: add HANDOFF.md, agent feedback, and CLAUDE.md session header
- HANDOFF.md: 747-line context doc for the May 15-16 pipeline quality session
  (git state, all skill changes, eval arena, video locations, key discoveries)
- AGENT-FEEDBACK-V2.md: 7-agent post-run friction report with priority action
  items (P0: HyperShader CSS crossfade bug, snapshot loading-screen blindspot)
- CLAUDE.md: add READ HANDOFF.md FIRST notice at top for new sessions
2026-05-16 00:55:09 -07:00
ukimsanov 309a641c38 chore: gitignore review-package and scratch files; fix SKILL.md step-1 gate 2026-05-15 23:11:58 -07:00