mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-17 23:47:33 +00:00
d001c7bb9cb42a8a2ad6b6832ac27b0abe293177
850
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
d001c7bb9c |
revert(skill): remove examples library + scrub workflow wiring
Removes the 81-scene examples library at skills/website-to-hyperframes/examples/ (introduced over 22 commits between |
||
|
|
6ee54ef66d |
feat(skill): examples library batch 20 — 3 more full-video refs (6 total, 6 architectures)
Adds 3 more production-grade full-video references to examples/_full-video-refs/,
bringing the tier to 6 refs covering 6 distinct architectural patterns. Also fixes
a pre-existing bug from batch 19 where the global compositions/ gitignore rule
silently dropped per-ref compositions/ subdirs.
• ref-04 inspector-logo-intro (12.77s, 1344-line single composition):
Pattern: single composition, no sub-comps. Halftone-canvas BG + 5 mini-beats
inside one timeline — logo flash → reverse stroke → magnifying glass enter →
inspector panel with cycling values → color picker hover. Source for the
cycling-spans pattern in 04-13-design-inspector. Production-density mini-reveal
arc that doesn't need HyperShader.
MP4: https://www.heygenverse.com/s/e0474ffa-9c3b-4f50-b8aa-03c92ba72bf2/raw
• ref-05 fadeglow-music-video-v4 (41.6s, 8 sequential beats):
Pattern: music-video grammar — no narration, music-driven cuts. 8 sub-comp
slots all on track 1 (no overlap), one music track, no captions, no SFX.
Beat durations vary 2.11s → 9.74s driven by the song. Warm cream + red +
amber palette + CRT scanlines + kinetic typography across 8 distinct beats.
Closer beat (beat-08-div-timeline.html) is the canonical "code editor +
gradient canvas with kinetic text" pattern. Fills the missing music-video
mode in the library.
MP4: https://www.heygenverse.com/s/5eee1ed3-3255-473b-a0e0-f488eda984df/raw
• ref-06 webgl-textures-playground (12.0s, Three.js + HTML overlay):
Pattern: shader-as-the-beat. Three.js fullscreen plane running a custom
domain-warp FBM + cosine-palette + iridescent-sweep fragment shader, with
kinetic typography overlay using mix-blend-mode: screen so text glows
through the colored shader. Demonstrates the seekable-WebGL pattern
(gsap.ticker.add() reading tl.time(), NOT requestAnimationFrame) at
scene scale. Library had shaders as transitions and as layer effects but
nothing for "shader IS the load-bearing visual for the whole beat."
MP4: https://www.heygenverse.com/s/094d6602-c8cf-4c08-99a0-80345a60958f/raw
Architectural pattern coverage now at 6 (was 3):
1. Stacked live sub-comps (ref-01 launch-video-2)
2. Pre-rendered clip stitching (ref-02 claude-design)
3. Single composition with many beats (ref-03 hermes)
4. Single composition, no sub-comps (ref-04 inspector-logo-intro)
5. Sequential sub-comp slots, same track (ref-05 fadeglow music video)
6. Three.js shader + HTML overlay (ref-06 webgl-textures)
Gap: HyperShader.init() orchestrated multi-beat — candidate for future ref-07.
Tier README updated to Tier A (full launch reels, 40s+) + Tier B (short-form /
single-mode references, 10-15s). examples/README.md updated with 6-ref listing.
HANDOFF-full-video-refs.md updated with all 6 Verse asset IDs in the recovery
section. HANDOFF-examples-library.md TL;DR mentions batches 19 + 20 = 6 refs.
Gitignore fix: the global compositions/ rule (intended for scratch dirs at the
repo root) was silently swallowing every per-ref compositions/ subdir, including
ref-01, ref-02, ref-03 from batch 19. Added an exception:
!skills/website-to-hyperframes/examples/_full-video-refs/**/compositions/
!skills/website-to-hyperframes/examples/_full-video-refs/**/compositions/**
This restores 32 previously-dropped composition HTMLs from batch 19 + adds the
new ref-05 beats + ref-06's orbit-theater so the refs are actually readable
end-to-end.
Total: 81 single-scene refs (vocabulary) + 6 full-video refs (grammar) across
6 architectures. Source committed: ~2.3MB across 6 refs. MP4s on Verse: ~94MB
(not in repo).
|
||
|
|
6ed4eccefd |
feat(skill): examples library batch 19 — 3 full-video reference projects
Adds a new tier above the 81 single-scene refs: examples/_full-video-refs/. Three real
production launch reels lifted with their source compositions + index.html + storyboards.
Single scenes teach vocabulary (what a beat can be); full-video refs teach grammar (how
4-10 beats assemble into a 40-second video with narration, captions, intro hook, CTA close).
- ref-01 launch-video-2 (41.8s, 4 acts, 940K source):
Stacked-beats architecture with live sub-compositions. Act-1 has the highest-novelty
content in any production project — 4 AI-agent IDE quadrants (Claude Code + Cursor +
Codex + Gemini CLI) with synchronized mouse cursors, click ripples, sent-message bubbles.
Act-2 has MacBook + animated DESIGN.md callouts (already lifted as scene 12-06 but
here you see it as the production original). Act-4 is the canonical aurora end-card.
MP4: https://www.heygenverse.com/s/fb0a115b-81e6-4e3f-acae-6dbe8ef3def7/raw
- ref-02 claude-design-hyperframes-video (43.5s, 10 beats, 316K source):
Pre-rendered-clip-stitching architecture. Each beat rendered standalone to MP4, then
index.html stitches them with <video class="clip"> tags + caption overlays + music +
6 SFX. The compositions/ dir has the richest single comps in any production project:
claude-ui.html (1209 lines — full Claude.ai interface), dashboard.html (1525 — dense
analytical dashboard), grid.html (1621 — 24-cell technique grid). Skipped iteration
dirs (video-7-2/, video-9-2/, etc.) — only canonical root compositions/.
MP4: https://www.heygenverse.com/s/0e1f0a40-351d-4a2d-9b18-139c095a42dd/raw
- ref-03 hermes-hyperframes (41.0s, 20 beats inside one 1367-line composition, 652K,
1080x1080 square format):
Single-composition-with-many-beats architecture — parade.html runs 20 internal beats
over 41s, captions.html is a separate sub-comp overlay. Highest novelty: VHS-noise
boot, shader-render composite (WebGL + GLSL code + render terminal + CRT), Lottie
integration (the library has no Lottie ref otherwise), and 14 keyframe planning
mockups in mockups/ that show the mockup-to-final iteration process. Only ref
demonstrating square aspect-ratio composition.
MP4: https://www.heygenverse.com/s/51dbc7ce-42df-4a94-84ef-a10c302b4a2f/raw
Per-ref README has: project intro + assembled MP4 link + BEAT MAP table (each beat ->
closest single-scene ref + technique notes) + "what this teaches that single scenes
don't" + explicit "assets not bundled" list. Tier README at _full-video-refs/README.md
covers when to study each ref, the 3 architectural patterns side-by-side, and future
candidates (ref-04+ punted).
Audio files / brand-clip MP4s / iteration dirs / VO tooling deliberately NOT bundled.
Each ref is ~300-940K of source files only; total tier = 1.9MB committed. Assembled MP4s
hosted on Verse (43MB total uploaded, not in repo).
Gallery patched with new tier section at top, embedding all 3 MP4s in a 3-column grid
above the Grand Tour reel. examples/README.md adds the tier link + 3 refs to the lookup.
HANDOFF-examples-library.md updated TL;DR to reference batches 18 + 19.
Total: 81 single-scene refs (vocabulary) + 3 full-video refs (grammar) =
the library is now complete for both "what a beat can be" and "how beats assemble."
|
||
|
|
363f017b9c |
docs: HANDOFF for full-video-refs (batch 19 plan) + workflow audit lock-in
Lock-in document covering:
- Current state (81 scenes shipped, workflow audit done in batch 18, 25 commits ahead)
- The 3 full-video reference projects to lift (launch-video-2, claude-design, hermes)
- Per-ref scope: source + rendered MP4 hosted on Verse separately
- Files to copy / files to skip
- BEAT-NOTES template
- Execution sequence + recovery instructions if context resets mid-batch
Locks: workflow audit batch 18 (commit
|
||
|
|
851d62fc84 |
feat(skill): workflow audit batch 18 — invert default visual strategy + collapse DESIGN.md
After 11 eval branches all shipped screenshot-slideshow videos despite the library + 3-mode wiring existing, the audit found four screenshot-pull instructions in steps 0-3 that committed agents to "use captured assets" BEFORE the 3-mode framework had a chance to redirect. The library + 3-mode wiring were bandaid on a workflow that still defaulted to screenshots. Surgical edits — invert the default, fold in keywords that survive in agent context: 1. SKILL.md Step -1: new opening manifesto. "You're not making a video. You're making something that stops scrollers in the first 1.5 seconds and feels alive in every single frame — with motion, depth, momentum, like things exist in a physical world. Think about how to go viral." "Get everything you need yourself. Compose the load-bearing visuals." "Captured assets are accents and decorations, not the beat itself." 2. step-3 line 243: DELETE "Use captured screenshots over CSS recreations." Replace with "Compose the load-bearing visuals yourself. Build the kanban from cards. Draw the logo with SVG paths. Paint the gradient with shader noise. Captured assets decorate composed beats — they don't carry." 3. step-3 Asset Audit: reframe table from "assign assets to beats" to "audit which assets decorate composed beats." Delete "Minimum utilization" bullets that forced asset usage. Add "Composed bar" replacing them: "Every beat's primary visual comes from a composed scene; accents are layered on top to brand-inflect." 4. step-3 beat template: rename ### Assets to ### Composition + Accents. Beat template now structurally requires (a) composed scene cite + mode, (b) customization, and (c) optional accent assets. Most beats have 0-1 accent. 5. step-1-design.md: COLLAPSED from 615 → ~140 lines. 8-section spec → 3 sections (Visual Theme paragraph / Quick Reference / Iteration Guide). The Iteration Guide is the only load-bearing section sub-agents actually consult. Drop: mood-board prose, exhaustive component CSS tables, depth-elevation matrices, "what makes a great DESIGN.md" criteria. 6. step-3 Per-Beat Direction: add "Opener default: fast intro to stop the scrollers" at the top. Even cinematic videos start with a punch inside the first 1.0-1.5 seconds. 7. step-2 Question 3: reframe options around compose-first beats. "Build the kanban from divs in your brand palette, with the captured logo stamped top-left" instead of "the dashboard screenshot would look stunning mapped onto a 3D MacBook." Captured assets appear as accents in the options, not as the primary visual. Net effect: agents now read "stop scrollers / alive every frame / physical world / go viral" as the goal, "compose the load-bearing visual" as the strategy, and "assets decorate, they don't carry" as the rule. The 81-scene library is the proof; the workflow text is now pulling toward it, not against it. |
||
|
|
3b04f00cfc |
feat(skill): examples library batch 17 — 2 more hand-authored scenes (81 scenes)
- 04-18 Settings Panel: Render Preferences modal with 5 interactive controls in sequence — toggle switch (Auto-render off→on with knob slide + blue bg), radio group (Render quality Standard→High), dropdown (Output format cycles MP4·H.264 → MOV·ProRes → WebM·VP9 → MP4·H.265), slider with synced counter (Frame rate 0→60 FPS), 5 color swatches (Accent color blue→amber). Save button pulses + turns green with "✓ Saved" at the end. Reference for product settings/configuration UIs. - 09-06 Donut Chart Reveal: 4-segment SVG donut (Product launch 42% blue, Social ads 28% green, Demo 18% amber, Brand reels 12% pink) drawn sequentially. Each segment fades in via CSS opacity:0 → tl.to(opacity:1) then draws via stroke-dashoffset (fully seekable — no init-state bug). Center percentage counter ticks 0→100%. Legend cards cascade in synced with each segment's draw. Both lint clean, both snapshot-verified (donut after init-state fix), both rendered + uploaded. Grand Tour rebuilt with 81 scenes (9:22) at https://www.heygenverse.com/s/23b285ce-a09a-487a-94d7-53f0c2827f2d/raw. Section 04 jumps 17 → 18, section 09 jumps 5 → 6. Total 79 → 81. |
||
|
|
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. |
||
|
|
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.
|
||
|
|
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. |
||
|
|
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. |
||
|
|
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. |
||
|
|
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.
|
||
|
|
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. |
||
|
|
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). |
||
|
|
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. |
||
|
|
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 |
||
|
|
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. |
||
|
|
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 |
||
|
|
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 |
||
|
|
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. |
||
|
|
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
|
||
|
|
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.
|
||
|
|
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.
|
||
|
|
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. |
||
|
|
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).
|
||
|
|
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.
|
||
|
|
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. |
||
|
|
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.
|
||
|
|
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. |
||
|
|
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. |
||
|
|
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 |
||
|
|
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.
|
||
|
|
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. |
||
|
|
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. |
||
|
|
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. |
||
|
|
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 |
||
|
|
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 |
||
|
|
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 |
||
|
|
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. |
||
|
|
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. |
||
|
|
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 |
||
|
|
07c5679019 | docs: add v4 agent feedback with root cause analysis | ||
|
|
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 |
||
|
|
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 |
||
|
|
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 |
||
|
|
d7d0ee6e6a | docs: update HANDOFF with v3 run results and new P0 findings | ||
|
|
ba9aa4c791 | docs: data-start rule in sub-agent RULES, v3 feedback with arc root cause | ||
|
|
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 |
||
|
|
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 |
||
|
|
ca4c5cc18e | docs: add v3 agent feedback with root cause analysis and cross-iteration comparison |