mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-03 04:38:33 +00:00
WaterrrForever
17b852784b
* feat(skills): add brief contract — interaction modes + shared intake fields across workflows New hyperframes-core/references/brief-contract.md, the shared intake contract every creation workflow now runs its brief against: - §1 interaction mode: collaborative (default) vs autonomous, ongoing vs one-time signals, mode set once and carried forward, and a gate taxonomy (preference / checkpoint / quality / routing) — autonomous skips waiting, never verification - §2 field registry: destination→aspect derivation (feed → 1:1, Shorts/TikTok → 9:16, else 16:9), message, angle, length, audience, language, narration — each workflow binds fields as ask or state - §3 question rules: one round with one question per asked field (native question UI mandatory when available, recommended option first with a receipt), never drop a question as inferable, and a mode legend advertised in the intro text instead of asked Wired into the surfaces: - hyperframes router: detect mode at entry, derive aspect from destination instead of stating 16:9 - product-launch-video / pr-to-video / faceless-explainer: ask/state binding tables at Step 0; Step 3/6 checkpoint-gate branches (autonomous posts a heads-up with a preview hint before render) - website-to-video: local mode definition now defers to the contract - music-to-video, general-video, embedded-captions, talking-head-recut, slideshow, motion-graphics: mode semantics wired per gate type - storyboard-format: new optional 'mode' frontmatter key - pr-to-video: length tier is a ceiling, not a floor — a one-headline PR recommends inside the 30–90s sweet spot regardless of diff size * feat(skills): story spine + mode-first brief across creation workflows Story — the reverse-iceberg feedback: - New hyperframes-creative/references/story-spine.md, three rules for the narrated workflows: the hook speaks the viewer's outcome language, the value claim lands by beat 2 (implementation is the footnote of the story, not the spine), and the storyboard is presented as a proposal — 'This video tells [audience] that [message]' plus a per-frame why: drawn from narrativeRole - pr-to-video: feature-reveal reordered promise-first (impact leads, diff/mechanism follow as evidence); hooks ban file/function names; fix-explainer, refactor-walkthrough, changelog unchanged - product-launch-video / faceless-explainer hook rules aligned to the spine; website-to-video's beat summary gains the echo line + why:; general-video points at the spine from its plan step Brief — hardened after live-test drift: - Mode is now the first question (Collaborative recommended vs Autonomous), its own round, skipped when the request carries a signal; autonomous asks nothing further until one final preview-or-render question before render - Step 0 rewritten as a literal two-round question script in each shot-sequence workflow (website-to-video's editorial register, channel-agnostic); brief-contract.md §3 reduced to invariants so the procedure lives in exactly one place * feat(skills): split type minimums by viewing context typography.md: full-screen viewing keeps body 20px / headline 60px; in-feed destinations (X / LinkedIn / Instagram — brief-contract's destination field) scale to body >=32px, headline >=90px, data labels >=24px. First-pass values, to be calibrated against real renders. * feat(skills): storyboard proposal as a table + credits close by default - story-spine § 3: the proposal presents frames as a markdown table (frame · beat · on screen · why) instead of dense paragraphs; the three shot-sequence workflows and website-to-video's beat summary reference the same shape - pr-to-video: the credits close is now the default ending — every PR video ends on a contributors frame (committers by commit count, 1-6 avatars), with no taste judgment; the only skip is when no avatar was fetched, and the user can cut the frame in the proposal * fix(skills): address review nits on the brief/story contracts - embedded-captions: the identity procedure now states both sides of the preference gate inline (user picks; autonomous picks with a stated why) - website-to-video step-2-brief: note that its mode section is the workflow's application of brief-contract.md, not a second definition - brief-contract: resuming a project reads mode from STORYBOARD.md frontmatter — a recorded mode counts as set, closing the write-only gap * docs(skills): add a non-code receipts example to the brief contract Review nit (jrusso1020, #2058): the receipts example in § 3 was PR-video-shaped only. A destination-shaped example joins it so the rule reads as workflow-neutral.
86 lines
1.7 KiB
JSON
86 lines
1.7 KiB
JSON
{
|
|
"source": "heygen-com/hyperframes",
|
|
"skills": {
|
|
"embedded-captions": {
|
|
"hash": "fe837c08dd47b077",
|
|
"files": 144
|
|
},
|
|
"faceless-explainer": {
|
|
"hash": "7f8f31695723756b",
|
|
"files": 18
|
|
},
|
|
"figma": {
|
|
"hash": "ee1408c58b76db8e",
|
|
"files": 1
|
|
},
|
|
"general-video": {
|
|
"hash": "e26710c3537b3a07",
|
|
"files": 1
|
|
},
|
|
"hyperframes": {
|
|
"hash": "24ec436b52957fcc",
|
|
"files": 1
|
|
},
|
|
"hyperframes-animation": {
|
|
"hash": "373da1c37ee2bd36",
|
|
"files": 116
|
|
},
|
|
"hyperframes-cli": {
|
|
"hash": "493e59cafaab3d10",
|
|
"files": 7
|
|
},
|
|
"hyperframes-core": {
|
|
"hash": "2b1fb57fc6964e76",
|
|
"files": 14
|
|
},
|
|
"hyperframes-creative": {
|
|
"hash": "a5bccc25d291899d",
|
|
"files": 69
|
|
},
|
|
"hyperframes-keyframes": {
|
|
"hash": "555c0cd491c40cea",
|
|
"files": 3
|
|
},
|
|
"hyperframes-registry": {
|
|
"hash": "e3b389526834109d",
|
|
"files": 10
|
|
},
|
|
"media-use": {
|
|
"hash": "22d8da57c4af6ddd",
|
|
"files": 103
|
|
},
|
|
"motion-graphics": {
|
|
"hash": "96ed2f7d8051b009",
|
|
"files": 23
|
|
},
|
|
"music-to-video": {
|
|
"hash": "901a19d0680f8c1b",
|
|
"files": 132
|
|
},
|
|
"pr-to-video": {
|
|
"hash": "800b4c11cda4658b",
|
|
"files": 22
|
|
},
|
|
"product-launch-video": {
|
|
"hash": "4f858cc4d59324da",
|
|
"files": 20
|
|
},
|
|
"remotion-to-hyperframes": {
|
|
"hash": "aa599f027db4b994",
|
|
"files": 70
|
|
},
|
|
"slideshow": {
|
|
"hash": "19a0332616bc397b",
|
|
"files": 2
|
|
},
|
|
"talking-head-recut": {
|
|
"hash": "d5c51342625c9952",
|
|
"files": 27
|
|
},
|
|
"website-to-video": {
|
|
"hash": "32bdb559f4d18f99",
|
|
"files": 32
|
|
}
|
|
}
|
|
}
|