Skip to content

Commit 6ee54ef

Browse files
committed
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).
1 parent 6ed4ecc commit 6ee54ef

66 files changed

Lines changed: 18934 additions & 24 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.gitignore‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,13 @@ compositions/
106106
video-6-2-patched/
107107
claude-design-hyperframes-video/
108108

109+
# Exception: the lifted full-video reference projects under
110+
# skills/website-to-hyperframes/examples/_full-video-refs/ need their
111+
# compositions/ subdirs committed so the refs are readable. The global
112+
# compositions/ rule above is for scratch dirs at the repo root.
113+
!skills/website-to-hyperframes/examples/_full-video-refs/**/compositions/
114+
!skills/website-to-hyperframes/examples/_full-video-refs/**/compositions/**
115+
109116
# Review package (rater review copy, not part of repo)
110117
review-package/
111118

‎HANDOFF-examples-library.md‎

Lines changed: 50 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,19 @@
22

33
> **READ THIS BEFORE PICKING UP THE EXAMPLES LIBRARY WORK.** This is the second handoff in the series.
44
> - `HANDOFF.md` covers pipeline-quality v2-v9 work through May 18.
5-
> - **This doc** covers the example library work (May 19, batches 7-17 + 18 workflow audit + 19 full-video refs).
6-
> - `HANDOFF-full-video-refs.md` covers the batch 19 lift plan in detail (Verse asset IDs, source dir layout, recovery instructions).
5+
> - **This doc** covers the example library work (May 19, batches 7-17 + 18 workflow audit + 19-20 full-video refs).
6+
> - `HANDOFF-full-video-refs.md` covers the batch 19 + 20 lift plans in detail (Verse asset IDs, source dir layout, recovery instructions).
77
88
---
99

1010
## TL;DR
1111

12-
**What got built across batches 7-19:**
12+
**What got built across batches 7-20:**
1313

1414
- **81 production-grade example scenes** at `skills/website-to-hyperframes/examples/` (sections 01-13). Standalone-renderable, lint-clean, snapshot-verified, composed 100% from HTML/CSS/SVG/GSAP/Canvas. Grand Tour reel at **9:22**.
1515
- **3-mode skill wiring** active across SKILL.md, step-3-storyboard, step-5-build, beat-builder-guide (batches 7-9).
1616
- **Workflow audit (batch 18, commit `851d62fc`)** — inverted the default visual strategy from "use captured assets" to "compose load-bearing visuals + assets-as-accents." Collapsed `step-1-design.md` from 615 → 157 lines. Added the manifesto in `SKILL.md` Step -1: "stop scrollers / alive every frame / physical world / go viral / get everything yourself."
17-
- **3 full-video references (batch 19)** — `examples/_full-video-refs/` now contains 3 real production launch reels (launch-video-2, claude-design-hyperframes-video, hermes-hyperframes) as a second tier teaching grammar (multi-beat assembly) on top of the 81 single-scene vocabulary.
17+
- **6 full-video references (batches 19 + 20)** — `examples/_full-video-refs/` is a second tier teaching grammar (multi-beat assembly) on top of the 81 single-scene vocabulary. **Tier A** (full 40s+ launch reels): launch-video-2, claude-design-hyperframes-video, hermes-hyperframes, fadeglow-music-video-v4. **Tier B** (10-15s short-form / single-mode refs): inspector-logo-intro, webgl-textures-playground. Together they cover 6 distinct architectural patterns (stacked sub-comps / clip stitching / single-comp-many-beats / single-comp-no-beats / sequential slots / shader-as-the-beat).
1818

1919
**Why:** `HANDOFF.md` Recommendation 1 said skill prose was exhausted as a lever (11 eval branches all produced slideshow videos regardless of prose changes). Recommendation 2 said: **show, don't tell** — build production-grade reference examples agents can use. This library is that.
2020

@@ -28,10 +28,55 @@
2828
- **step-5-build.md**: mode-aware build process; explicit "fresh ≠ paste, recombine ≠ frankenstein".
2929
- **beat-builder-guide.md**: 3-mode table is the FIRST mandatory read; "non-negotiable in every mode: customize."
3030

31-
**Branch:** `feat/pipeline-quality-v2` (continued from prior session). **24 commits** total this session.
31+
**Branch:** `feat/pipeline-quality-v2` (continued from prior session). **28 commits** total this session.
3232

3333
**Library is internally consistent.** Every scene appears in (a) its section README, (b) the master lookup table in `examples/README.md`, (c) the rendered MP4 list, and (d) the Verse asset ID table below. The technique-pick checklist in step-3 has reliable coverage — an agent can find any of the 81 scenes from the lookup table without grepping the directory.
3434

35+
### What batch 20 added (3 more full-video refs — short-form + music-video + shader-as-the-beat)
36+
37+
After batch 19 shipped 3 full-video refs (launch-video-2 / claude-design / hermes), three more production projects were surveyed in `~/Downloads/Archive` and `~/Downloads/Archive 2` and lifted into the `_full-video-refs/` tier. Each fills a distinct architectural pattern that the first 3 didn't cover:
38+
39+
- **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 + cycling values → color picker hover). Source for the cycling-spans pattern that ships in `04-13-design-inspector`. Demonstrates production-density mini-reveal arc that doesn't need HyperShader. Track-index hygiene table (`#halftone-bg` track 0 through `#color-picker` track 8) included in the ref README. Verse: `e0474ffa-9c3b-4f50-b8aa-03c92ba72bf2`.
40+
- **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, not by script airtime. 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 on left + gradient canvas with kinetic text on right" pattern with rainbow gradient sweep fill. Fills the missing music-video mode in the library (everything else was product-marketing-skewed). Verse: `5eee1ed3-3255-473b-a0e0-f488eda984df`.
41+
- **ref-06 webgl-textures-playground** (12.0s, single Three.js + HTML overlay composition). **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 the text glows through the colored shader. Demonstrates the **seekable WebGL pattern** (`gsap.ticker.add()` reading `tl.time()`, NOT `requestAnimationFrame`) at scene scale — without it, the snapshot/render CLI shows a frozen first-frame. Library had shaders as transitions and shaders as layer effects, but nothing for "shader IS the load-bearing visual for the whole beat." This is it. Verse: `094d6602-c8cf-4c08-99a0-80345a60958f`.
42+
43+
**Architectural pattern coverage now at 6 (was 3):**
44+
45+
| # | Pattern | Demonstrated in |
46+
|---|---------|----------------|
47+
| 1 | Stacked live sub-comps (multi-act) | ref-01 launch-video-2 |
48+
| 2 | Pre-rendered clip stitching | ref-02 claude-design |
49+
| 3 | Single composition with many beats | ref-03 hermes |
50+
| 4 | Single composition (no beats) | ref-04 inspector-logo-intro |
51+
| 5 | Sequential sub-comp slots, same track | ref-05 fadeglow music video |
52+
| 6 | Three.js shader + HTML overlay | ref-06 webgl-textures |
53+
| (gap) | HyperShader.init() orchestrated multi-beat | — none yet, ref-07 candidate |
54+
55+
Tier README updated to **Tier A** (full launch reels, 40s+) + **Tier B** (short-form / single-mode references, 10-15s). Disk cost stayed under 2.5MB total across all 6 refs. Gallery patched to show 6 ref cards. `HANDOFF-full-video-refs.md` updated with all 6 Verse asset IDs in the recovery section.
56+
57+
### What batch 19 added (3 full-video refs — launch-video grammar)
58+
59+
The 81 single-scene examples teach **vocabulary** (what an individual beat or technique looks like). They don't teach **grammar** — how 4-10 beats assemble into a 40-second video with HyperShader transitions or clip stitching, narration sync, intro hook, CTA close. Batch 19 lifted 3 real production launch reels into a new `_full-video-refs/` tier:
60+
61+
- **ref-01 launch-video-2** (41.8s, 4 acts as stacked `<div>` slots with live sub-comps). Novelty: Act-1's 4-panel AI-agent IDE quartet (Claude Code + Cursor + Codex + Gemini CLI). Verse: `fb0a115b-81e6-4e3f-acae-6dbe8ef3def7`.
62+
- **ref-02 claude-design-hyperframes-video** (43.5s, 10 pre-rendered MP4 clips stitched + captions + music + 6 SFX). Notable for `claude-ui.html` (1209 lines), `dashboard.html` (1525 lines), `grid.html` (1621 lines) — heavy hand-composed UI per beat. Verse: `0e1f0a40-351d-4a2d-9b18-139c095a42dd`.
63+
- **ref-03 hermes-hyperframes** (41.0s, 1080×1080 square format, single 1367-line `parade.html` w/ 20 internal beats + Lottie captions sub-comp). VHS + CRT + Lottie. Verse: `51dbc7ce-42df-4a94-84ef-a10c302b4a2f`.
64+
65+
Tier README at `examples/_full-video-refs/README.md` lists architectural patterns at a glance + how-to-study per ref + what's deliberately NOT bundled (audio files, brand-clip MP4s, transcript.json — listen/watch on Verse instead). Each ref has its own README with BEAT MAP + closest single-scene refs + asset-deps callout. `HANDOFF-full-video-refs.md` at repo root has the recovery plan (Verse asset IDs, source dir paths, re-render instructions).
66+
67+
### What batch 18 added (workflow audit — invert the default visual strategy)
68+
69+
The 11 prior pipeline-eval branches (HANDOFF.md lines 953-1062) all produced screenshot-slideshow videos despite the library + 3-mode wiring existing. Audited the steps 0-3 of the workflow to find why: the prose committed agents to "pull captured screenshots" before the 3-mode framework could redirect. Surgical edits inverted the default:
70+
71+
- **SKILL.md** Step -1 manifesto added at top: "stop scrollers / alive every frame / physical world / go viral / get everything yourself / composed-primary / assets decorate" — the user's verbatim keywords condensed into a 7-line manifesto that frames the rest of the workflow.
72+
- **step-1-design.md** collapsed from 615 → 157 lines. Kept: Visual Theme (1 paragraph), Quick Reference table, Iteration Guide. Dropped: 8-section structure, 6 worked examples, depth-elevation tables, "what makes a great DESIGN.md" criteria — all were committing agents to over-specify before the storyboard step.
73+
- **step-3-storyboard.md** — line 243 ("Use captured screenshots over CSS recreations") deleted and replaced with "Compose the load-bearing visuals yourself..." Asset Audit reframed to accent-only. Beat template `### Assets` renamed to `### Composition + Accents`. Added "Opener default: fast intro to stop the scrollers."
74+
- **step-2-brief.md** — Question 3 reframed to compose-first options.
75+
76+
The framing the user explicitly corrected: NOT "build everything yourself + don't use assets at all" but rather **composed-primary, assets-as-accents** — load-bearing visuals composed from divs/SVG/CSS/GSAP, assets used as decoration on top. The audit reflects that framing.
77+
78+
Commit: `851d62fc`.
79+
3580
### What batch 17 added (2 more scenes)
3681

3782
- **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 via stroke-dashoffset. Each segment fades in (CSS opacity:0 → opacity:1 via tl.to) then draws via dashoffset (fully seekable). Center percentage counter ticks 0→100% via tl.set(). Legend cards on the right cascade in synced with each segment's draw.

‎HANDOFF-full-video-refs.md‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -270,7 +270,7 @@ This is what a real production HyperFrames video looks like assembled. <duration
270270

271271
---
272272

273-
## Verse asset IDs (UPLOADED ✓)
273+
## Verse asset IDs (UPLOADED ✓ — all 6 refs)
274274

275275
```
276276
ref-01-launch-video-2.mp4: fb0a115b-81e6-4e3f-acae-6dbe8ef3def7
@@ -281,6 +281,15 @@ ref-02-claude-design-hyperframes-video.mp4: 0e1f0a40-351d-4a2d-9b18-139c095a42dd
281281
282282
ref-03-hermes-hyperframes.mp4: 51dbc7ce-42df-4a94-84ef-a10c302b4a2f
283283
https://www.heygenverse.com/s/51dbc7ce-42df-4a94-84ef-a10c302b4a2f/raw (11MB, 41.0s)
284+
285+
ref-04-inspector-logo-intro.mp4: e0474ffa-9c3b-4f50-b8aa-03c92ba72bf2
286+
https://www.heygenverse.com/s/e0474ffa-9c3b-4f50-b8aa-03c92ba72bf2/raw (32MB, 12.77s — locally rendered high-quality)
287+
288+
ref-05-fadeglow-music-video-v4.mp4: 5eee1ed3-3255-473b-a0e0-f488eda984df
289+
https://www.heygenverse.com/s/5eee1ed3-3255-473b-a0e0-f488eda984df/raw (11MB, 41.6s)
290+
291+
ref-06-webgl-textures-playground.mp4: 094d6602-c8cf-4c08-99a0-80345a60958f
292+
https://www.heygenverse.com/s/094d6602-c8cf-4c08-99a0-80345a60958f/raw (7.7MB, 12.0s)
284293
```
285294

286295
## Source dirs lifted (ON DISK ✓)

‎skills/website-to-hyperframes/examples/README.md‎

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -149,15 +149,23 @@ Need a specific technique? Use this table to find the canonical scene.
149149
- [`_shared/shared-styles.css`](_shared/shared-styles.css) — design tokens (color palette, type scale, spacing). Every scene `<link>`s this so the catalog feels cohesive.
150150
- [`_shared/easing-glossary.md`](_shared/easing-glossary.md) — the 7 production easings and when to use each. Single source of truth.
151151

152-
## Full-Video References (new tier)
152+
## Full-Video References (new tier — 6 refs across 6 architectures)
153153

154-
The 81 numbered scenes above teach **vocabulary** — what individual beats can look like. The 3 refs in [`_full-video-refs/`](_full-video-refs/) teach **grammar** — how 4-10 beats assemble into a 40s video with narration, captions, intro hook, CTA close.
154+
The 81 numbered scenes above teach **vocabulary** — what individual beats can look like. The 6 refs in [`_full-video-refs/`](_full-video-refs/) teach **grammar** — how multi-beat videos assemble in 6 different architectural styles.
155155

156-
- [**ref-01 launch-video-2**](_full-video-refs/ref-01-launch-video-2/) (41.8s) — 4 acts, stacked-beats arch, AI-agent IDE quartet. Watch: https://www.heygenverse.com/s/fb0a115b-81e6-4e3f-acae-6dbe8ef3def7/raw
156+
**Tier A — full launch reels (40s+):**
157+
158+
- [**ref-01 launch-video-2**](_full-video-refs/ref-01-launch-video-2/) (41.8s) — 4 acts, stacked sub-comps, AI-agent IDE quartet. Watch: https://www.heygenverse.com/s/fb0a115b-81e6-4e3f-acae-6dbe8ef3def7/raw
157159
- [**ref-02 claude-design-hyperframes-video**](_full-video-refs/ref-02-claude-design-hyperframes-video/) (43.5s) — 10 beats, pre-rendered clip stitching, 1500+ line compositions. Watch: https://www.heygenverse.com/s/0e1f0a40-351d-4a2d-9b18-139c095a42dd/raw
158-
- [**ref-03 hermes-hyperframes**](_full-video-refs/ref-03-hermes-hyperframes/) (41.0s, 1080×1080 square) — 20 beats inside one composition, VHS/CRT aesthetic, Lottie integration. Watch: https://www.heygenverse.com/s/51dbc7ce-42df-4a94-84ef-a10c302b4a2f/raw
160+
- [**ref-03 hermes-hyperframes**](_full-video-refs/ref-03-hermes-hyperframes/) (41.0s, 1080×1080 square) — 20 beats inside one composition, VHS/CRT, Lottie. Watch: https://www.heygenverse.com/s/51dbc7ce-42df-4a94-84ef-a10c302b4a2f/raw
161+
- [**ref-05 fadeglow-music-video-v4**](_full-video-refs/ref-05-fadeglow-music-video-v4/) (41.6s) — **music video grammar** — 8 sequential beats, no narration, music-driven cuts. Watch: https://www.heygenverse.com/s/5eee1ed3-3255-473b-a0e0-f488eda984df/raw
162+
163+
**Tier B — short-form (10-15s):**
164+
165+
- [**ref-04 inspector-logo-intro**](_full-video-refs/ref-04-inspector-logo-intro/) (12.77s) — Figma-style inspector reveal, single 1344-line composition, source for the cycling-spans pattern in scene-13. Watch: https://www.heygenverse.com/s/e0474ffa-9c3b-4f50-b8aa-03c92ba72bf2/raw
166+
- [**ref-06 webgl-textures-playground**](_full-video-refs/ref-06-webgl-textures-playground/) (12.0s) — **shader-as-the-beat** pattern, Three.js fragment shader with HTML overlay via `mix-blend-mode: screen`. Watch: https://www.heygenverse.com/s/094d6602-c8cf-4c08-99a0-80345a60958f/raw
159167

160-
Read the [tier README](_full-video-refs/README.md) for when to study each, the 3 architectural patterns, and what's deliberately not bundled.
168+
Read the [tier README](_full-video-refs/README.md) for when to study each, the 6 architectural patterns side-by-side, and what's deliberately not bundled.
161169

162170
---
163171

0 commit comments

Comments
 (0)