* feat(hyperframes-creative): add frame-preset library Add a library of ready-made visual frame presets (claude, biennale-yellow, blockframe, blue-professional, bold-poster, broadside, capsule, cartesian, cobalt-grid, coral, creative-mode, daisy-days, editorial-forest, …), each with a FRAME.md spec, a frame-showcase.html, and a per-preset caption-skin.html. Registered in the creative design-spec so workflows can remix a preset onto brand tokens. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(hyperframes-media): shared TTS/BGM/SFX audio engine Add a shared audio engine under hyperframes-media (scripts/audio.mjs + lib/ tts.mjs, bgm.mjs, sfx.mjs, heygen.mjs) plus a bundled SFX pack and manifest. Workflows resolve this engine by path (../../hyperframes-media/scripts/ audio.mjs) for text-to-speech, background music, and sound effects, so audio is authored once and reused across skills instead of duplicated per workflow. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(skills): gate render on user review; refresh router, core, general-video - hyperframes-cli: render is now user-gated — preview opens Studio (the timeline editor where the user can hand-edit anything, not just watch); never auto-render once checks pass, pause at preview and render only after approval. - hyperframes (router): tighten the entry SKILL.md description + routing. - hyperframes-core: rewrite SKILL.md and add script-format.md + storyboard-format.md references for the script-driven authoring architecture. - general-video: tidy the fallback-workflow description and routing table. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * style(hyperframes-creative): reformat frame-preset showcase HTML Run the HTML formatter over the frame-showcase.html files (indentation, self-closing void tags, one CSS declaration per line). Formatting only — no content or markup changes. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(hyperframes-media): correct wait-bgm field mapping and guard credential parse Two correctness fixes from review (#1632): - wait-bgm.mjs read audioMeta.bgm_path / audioMeta.bgm_enabled, but audio.mjs writes the path nested as bgm.path and the flag as bgm_pending. The detached generate path (Lyria/MusicGen) therefore always saw an empty path and exited status: disabled, silently dropping the music track even while generation was running. Read audioMeta.bgm?.path and gate on bgm_pending. - heygenCredential() had an unguarded JSON.parse despite documenting that it never throws — a malformed ~/.heygen credentials file crashed the engine at startup instead of degrading to no-credential. Wrap the parse and return null. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * chore(hyperframes): add router tag to entry skill metadata Fold the router metadata tag into the foundation rewrite of the entry SKILL.md. This file is owned by this PR (the full router rewrite); keeping the tag tweak here — instead of a separate edit on the pre-rewrite version in another PR — avoids a guaranteed merge conflict between the two. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
17 KiB
version: alpha name: Cartesian — Frame (video / frame layer) description: > Video-first companion to Cartesian's design.md. The unit is the frame (1920×1080). Atoms are identical and sacred — the five-tone warm-stone palette, Playfair Display 400 + Inter, the universal 1px taupe hairline as the only structural device, compass-drafted geometric rings, and zero shadow / zero fill. Composition, frame scale, and aspect-ratio behavior are rewritten for the frame. Restraint is the rule; motion is out of scope. unit: the frame — 1920×1080 primary; 9:16 and 1:1 documented principle: atoms are sacred · composition is free · numbers come from the script
colors: bg-primary: "#EDE8E0" bg-secondary: "#E2DBD1" text-primary: "#1A1A1A" text-secondary: "#5A5A5A" accent: "#8A8178" line: "#B8B0A4" white-overlay: "rgba(255,255,255,0.3)"
typography:
— reading ramp (Inter) —
body: { fontFamily: "Inter", cqw: 1.0, weight: 400, lineHeight: 1.6, color: "text-secondary" } body-sm: { fontFamily: "Inter", cqw: 0.85, weight: 400, lineHeight: 1.6 } subtitle: { fontFamily: "Inter", cqw: 1.3, weight: 400, lineHeight: 1.5 } label: { fontFamily: "Inter", px: 14, weight: 500, tracking: "3px", upper: true, color: "accent" } attribution: { fontFamily: "Inter", px: 15, weight: 400, tracking: "2px", upper: true, color: "accent" } micro: { fontFamily: "Inter", px: 12, weight: 400, tracking: "2px", upper: true, color: "accent" }
— display / hero ramp (Playfair Display 400, sentence case) —
h3: { fontFamily: "Playfair Display", cqw: 1.8, weight: 400, lineHeight: 1.1 } timeline-headline:{ fontFamily: "Playfair Display", cqw: 1.9, weight: 400, lineHeight: 1.1 } card-headline:{ fontFamily: "Playfair Display", cqw: 2.0, weight: 400, lineHeight: 1.15 } stat-figure: { fontFamily: "Playfair Display", cqw: 3.0, weight: 400, lineHeight: 1.0 } quote-mark: { fontFamily: "Playfair Display", cqw: 9.0, weight: 400, lineHeight: 0.5, color: "line" } h2: { fontFamily: "Playfair Display", cqw: 4.0, weight: 400, lineHeight: 1.1 } h1: { fontFamily: "Playfair Display", cqw: 6.2, weight: 400, lineHeight: 1.06 } display: { fontFamily: "Playfair Display", cqw: 8.0, weight: 400, lineHeight: 1.04 }
spacing: pad-x: "7cqw" pad-y: "5cqw" gap-xl: "6cqw" gap-lg: "5cqw"
components: hairline: rule: "0.07cqw solid {colors.line}" description: "The universal structural device — every separator (agenda rule, timeline connector, card border, stats top) is this 1px taupe line. No thick borders exist." card: backgroundColor: "{colors.white-overlay}" border: "0.07cqw solid {colors.line}" rounded: "0" shadow: "none" description: "Faint white-overlay fill (canvas bleeds through) is what makes a card distinct from a bare region." card-icon: border: "0.07cqw solid {colors.line}" rounded: "50%" size: "40px circle" textColor: "{colors.accent}" typography: "Playfair numeral/letter" description: "Ringed circle mark." agenda-row: borderBottom: "0.07cqw solid {colors.line}" typography: "{typography.h3} (numeral {colors.accent}, label {colors.text-primary})" description: "Numeral left, label right over a taupe rule." timeline: borderTop: "0.07cqw solid {colors.line}" typography: "{typography.timeline-headline} + {typography.body-sm}" description: "A single taupe top rule across items — no nodes, no dots." stats-cluster: borderTop: "0.07cqw solid {colors.line}" typography: "{typography.stat-figure} + uppercase {colors.accent} labels" description: "Inline modest stat figures (no hero numeral)." geo-ring: border: "1px solid {colors.line} (inner dashed ::before ~70–80%)" rounded: "50%" size: "10–50cqw" opacity: "0.2–0.5" description: "Compass-construction rings behind content. 1–2 per frame, never more." horizontal-accent: backgroundColor: "{colors.text-primary}" size: "~18cqw × 1px" description: "The system's only INK-BLACK rule — a strong terminal accent on cover/closing, sparingly." vertical-line: backgroundColor: "{colors.line}" size: "1px × full height, ~5cqw from edge" opacity: "0.3–0.4" description: "Drafting-paper alignment guide. Optional." image-placeholder: backgroundColor: "{colors.bg-secondary}" mark: "crossed +30°/−30° 1px taupe diagonals (an X)" typography: "small uppercase {typography.micro}" description: "The signature image-not-wired mark." team-photo: backgroundColor: "{colors.bg-secondary}" border: "0.07cqw solid {colors.line}" rounded: "50%" typography: "Playfair initial in {colors.accent}" description: "Circular portrait frame."
Cartesian — Frame (video / frame layer)
Overview
Cartesian at frame scale is a quiet museum-catalog editorial system — restraint through 1px lines. Every structural separator is a single 1px taupe hairline; there are no thick borders, no fills (save the faint white-overlay card), no shadows, no rounded rectangles. Hierarchy comes from type contrast and negative space, and atmosphere from compass-drafted geometric rings drifting behind content.
The voice is a literary pairing: Playfair Display at weight 400 (the thin-stroke didone, never bold, always sentence case) carries every headline, numeral, and quote mark in ink; Inter carries body in warm gray and labels in uppercase taupe with 2–3px tracking. The palette is five warm stones plus ink — no populist accent color exists. The correct density is sparse and breathing: one clear idea, well-framed, on stone paper.
Key characteristics at frame scale:
- 1px taupe hairline as the universal structural device — every separator is this one line.
- Playfair Display 400 (ink, sentence case) for display; Inter body (gray) + labels (taupe, tracked).
- Five warm stones + ink — no red/blue/green; the only "color" is type contrast.
- Compass-drafted geometric rings (solid + dashed, 20–50% opacity) behind content for mood.
- Flat — zero shadow, zero rounded rectangle (circles only); the lone ink line is the
horizontal-accent. - Sparse and breathing — generous negative space; crowding reads as broken.
The Frame
Frame Craft Bar
Three eyeball tests gate every frame before any structural check:
-
Squint — one Playfair element dominates at 3–6× its nearest neighbor; the serif/sans + size contrast carries hierarchy, not weight.
-
Silence — declarative frames read 55–60% empty; Cartesian has no dense frame — even the agenda/index breathes (the system breaks when crowded).
-
Restraint — at most two geo rings per frame; the single INK-BLACK
horizontal-accentrule used sparingly; no populist accent color ever. -
Reference — aim at a Vignelli editorial / Cooper Hewitt catalogue / pencil-and-tracing-paper plan; failure looks like a shadowed, rounded-card SaaS deck.
-
Primary: 1920×1080 (16:9). Display authored in
cqw(px ÷ 1920 × 100 = cqw). -
Vertical: 1080×1920 (9:16). Square: 1080×1080 (1:1).
-
Safe area:
pad-x(7cqw) generous gutters; geometry may bleed off an edge.
The container law (load-bearing). Every frame ground sets container-type: size; ALL
frame-relative units are cqw/cqh against it — never vw. The 1px hairlines and geo rings hold
their proportion against the frame at any render size.
Colors
Tokens identical to the source. {colors.bg-primary} is the ground; {colors.text-primary} ink is
headlines and the one black accent rule; {colors.text-secondary} gray is body; {colors.accent}
taupe is labels, numerals, small text; {colors.line} taupe is every 1px structural border.
{colors.bg-secondary} is the only secondary fill (placeholders, photo frames). No populist
accent — when emphasis is needed, grow the type, switch sans→serif, or add a single
horizontal-accent ink line. Headlines are never taupe; small text is never ink.
Typography
Two ramps. The reading ramp (Inter body 1.0cqw gray, labels in px taupe) carries copy + chrome;
the display ramp (Playfair h3 1.8cqw → display 8.0cqw, all weight 400) carries every headline.
- Legibility floor: any load-bearing line ≥ 1.4cqw; px labels are chrome only.
- Fit-to-measure: size the headline to its length. Cap the block at ≤ 78cqw; ≤3 words →
display/h1; 4–6 →h2; 7+ →h3. Cartesian has no hero-stat numeral — stats stay modest (stat-figure3cqw). - Playfair at 400, ink, sentence case — never bold, never uppercase, never taupe. Inter labels uppercase, 2–3px tracked, taupe. Italic via Playfair italic for emphasis only.
Depth & Surface
The flat plane is the only technique. Hierarchy from:
- Type contrast — Playfair serif vs Inter sans; the 8cqw→0.7cqw scale.
- 1px taupe hairlines — every divider, card outline, timeline rule, photo ring.
- Tone — ink vs gray vs taupe.
- Negative space — generous padding.
- Geometric atmosphere — compass rings that suggest depth without creating it.
Ceiling: no box-shadow, no elevated card, no gradient, no rounded rectangle. The single ink line
(horizontal-accent) is the only non-taupe rule.
Shapes
- 50% (circle) — card-icon, team-photo, nav-dot, every geo ring.
- 0 — everything else; soft-rounded corners do not exist.
Components
- hairline — the universal 1px taupe separator (the identity).
- card (1px taupe + white-overlay) / card-icon (ringed circle) / agenda-row / timeline (line, no nodes) / stats-cluster — all built on the hairline.
- geo-ring — compass decoration (solid + dashed), 1–2 per frame. horizontal-accent — the one ink line, sparingly. vertical-line — drafting guide.
- image-placeholder (crossed-X) / team-photo (ringed initial) — the stone-fill placeholders.
Frame Treatments
Recipe: ground · container · composes · focal · chrome · accent · silence · Fixed/Free · density. Every frame is sparse and breathing; 1–2 geo decorations max.
1 · Cover (identity · move: serif + compass ring · left)
Ground {colors.bg-primary}, pad-x. Composes geo-ring (right, ~34cqw, solid+dashed), vertical-line (left), label, display/h1. Focal a 2–3 line Playfair display/h1 headline in ink (italic on the key word), left-anchored, with a taupe label above and an Inter subtitle below. Chrome optional bottom meta row (Playfair value + taupe label). Accent the geo ring; optionally one horizontal-accent ink line (if it clears the meta). Silence ~55% empty. Fixed Playfair 400 ink sentence-case, ≤2 geo elements, 1px lines. Free title, ring placement, meta. Density sparse.
2 · Agenda / Index (index · move: hairline list · left)
Ground {colors.bg-primary}, pad-x. Composes label, h2, agenda-rows. Focal a Playfair h2 over 4–6 agenda rows (Playfair numeral in taupe + Playfair label in ink), each on a 1px taupe rule. Chrome taupe label eyebrow. Accent none — taupe numerals carry it. Silence moderate; rows generously spaced. Fixed 1px taupe rules, Playfair 400. Free items, count. Density standard (sparse rows).
3 · Pull Quote (quote · move: centered statement · compass ring)
Ground {colors.bg-primary}, centered. Composes geo-ring (centered dashed, ~26cqw), quote-mark, h2/display-quote, attribution. Focal a 2-line Playfair quote in ink, centered, under a 50%-taupe Playfair quote-mark; a taupe uppercase attribution beneath. Accent the faint centered ring. Silence ~60% — deliberately open. Fixed Playfair 400, one ring, centered. Free quote, attribution. Density sparse.
4 · Closing Plate (closer · move: centered ring · centered)
Ground {colors.bg-primary}, centered. Composes geo-ring (centered, ~40cqw, solid+dashed), label, h1/display, horizontal-accent. Focal a 1–2 line Playfair sign-off in ink (italic key word), centered inside the largest compass ring; a short ink horizontal-accent beneath. Accent the ring + the one ink line. Silence ~60%. Fixed Playfair 400, centered, ≤2 geo. Free sign-off, ring scale. Density sparse.
5 · Two-Column Editorial (content · move: asymmetric split · left)
Ground {colors.bg-primary}, pad-x, two columns with gap-xl. Composes label, h2, body, image-placeholder (crossed-X) or card. Focal a Playfair h2 + Inter body in the text column; an image-placeholder or card in the other. Accent none. Silence generous gutter. Fixed 1px taupe card/placeholder borders, white-overlay fill. Free which side is text, body copy. Density standard.
6 · Stats / Timeline (data · move: hairline rail · left)
Ground {colors.bg-primary}, pad-x. Composes label, h3, stats-cluster or timeline. Focal a modest Playfair stat row (or a 1px-rule timeline with year + headline + body, no nodes), framed by a 1px taupe top rule. Accent none. Silence moderate. Fixed modest stat scale, hairline rule, no nodes. Free figures, phases. Density standard.
Composition Rules
Do
- Use a single 1px taupe line for every separator — the hairline is the identity.
- Set every Playfair headline at 400, ink, sentence case; render labels taupe, uppercase, 2–3px tracked.
- Layer one or two compass rings (solid + dashed, 20–50% opacity) behind content for atmosphere.
- Let frames breathe — sparse, generous negative space; 55–60% empty on declarative frames.
- Lean centered on quote/closer; asymmetric/left on cover/agenda/editorial. Use
bg-secondaryfor placeholder fills.
Don't
- Don't introduce a populist accent color — stone and ink only.
- Don't bold Playfair, render headlines in taupe, or use thick (2px+) borders.
- Don't add shadows, elevated cards, or rounded rectangles (circles only).
- Don't crowd the frame — packed layouts read as broken.
- Never more than two geo decorations per frame; don't blow a headline edge-to-edge.
Aspect-Ratio Behavior
| Treatment | 16:9 | 9:16 | 1:1 |
|---|---|---|---|
| Cover | headline left, ring right | headline top, ring below | headline upper, ring behind |
| Agenda / Index | h2 + rows | h2 + rows (tighter) | h2 + rows |
| Pull Quote | centered, ring behind | centered, taller | centered |
| Closing Plate | centered in ring | centered, ring scaled | centered |
| Two-Column Editorial | text + visual side-by-side | stacked (collapse) | stacked |
| Stats / Timeline | horizontal rail | vertical stack (drop timeline rule) | compact |
Generous pad-x holds on the short edge; re-step display per ratio above the 1.4cqw floor. On
9:16, the timeline rule loses meaning when stacked — switch to a vertical list (per source).
Approved Entities
No real customers, logos, or vendors are defined in the source — render any such mark as a placeholder (the crossed-X image-placeholder, or a ringed initial for portraits).
Numerals & Claims (hard rule)
Never invent figures, dates, or counts at frame scale. Render slots as — figure —, {metric}.
Stats and timeline years carry placeholders until the script supplies them. Agenda ordinals
(01, 02…) are decorative and may be sequential.
Pre-Render Self-Audit
- Squint — one Playfair element dominates; the serif/sans contrast carries hierarchy.
- Silence — declarative frames 55–60% empty; nothing is crowded.
- Palette — five stones + ink only; no populist accent; headlines ink, labels taupe.
- Lines — every separator is a 1px taupe hairline; the only ink line is
horizontal-accent. - Type — Playfair 400 sentence-case, fit-to-measure; labels uppercase 2–3px; ≥1.4cqw floor.
- Depth — 0 shadow, 0 rounded rectangle; ≤2 geo rings per frame.
- Anchor — centered on quote/closer, left/asymmetric on cover/agenda/editorial; no 3 in a row alike.
- Fabrication — every numeral traces to the script, else placeholder.
Known Gaps
- Motion intentionally out of scope. frame.md specifies composition only; the 0.6s fade in the source is a deck mechanic.
- Playfair Display + Inter via Google Fonts. CJK pairing (Noto Serif SC 700/400) carries over; Playfair has no Hanzi italic — substitute weight/taupe for emphasis.
- 9:16 / 1:1 are guidance; verify the legibility floor and that the timeline collapses to a vertical list.
- Geo rings, the crossed-X placeholder, and the dashed inner ring are CSS-only; no external imagery is required.