feat(prompt-templates): add 11 HyperFrames video prompts + media generation README section

[pftom]

Summary

• Adds 11 hyperframes-* prompt templates under prompt-templates/video/, each with model: "hyperframes-html", scene-by-scene briefs, real HeyGen catalog-block thumbnails as previews, and heygen-com/hyperframes (Apache-2.0) attribution.
• Adds a new Media generation section in README.md (between Visual directions and Beyond chat), with three example galleries: 5-tile gpt-image-2 grid, 5-tile Seedance grid where each thumbnail links to the actual rendered MP4, and 11-tile HyperFrames grid where each tile links to the template JSON.
• Adds a Media generation row in the At a glance table covering image/video/audio surfaces.

Templates added

ID	Aspect	Archetype
hyperframes-product-reveal-minimal	16:9	5s minimal product reveal
hyperframes-saas-product-promo-30s	16:9	Linear/ClickUp-style 30s product promo
hyperframes-tiktok-karaoke-talking-head	9:16	TikTok talking-head + word-synced captions
hyperframes-brand-sizzle-reel	16:9	30s beat-synced kinetic typography sizzle
hyperframes-data-bar-chart-race	16:9	NYT-style animated bar-chart race
hyperframes-flight-map-route	16:9	Apple-style origin → destination flight map
hyperframes-logo-outro-cinematic	16:9	4s cinematic logo bloom outro
hyperframes-money-counter-hype	9:16	$0 → $10K Apple-style hype counter
hyperframes-app-showcase-three-phones	16:9	3 floating phones with feature callouts
hyperframes-social-overlay-stack	9:16	X · Reddit · Spotify · Instagram cards in sequence
hyperframes-website-to-video-promo	16:9	website-to-video pipeline (3 viewports + transitions)

Each prompt body specifies the HyperFrames non-negotiables (deterministic only, all timelines paused: true, entrance-only animations, no repeat: -1, transitions handle scene exits, run lint/inspect/validate before render) so the agent generates a composition that lints clean.

Why HyperFrames

heygen-com/hyperframes is HeyGen's open-source agent-native HTML→MP4 framework — agents write HTML + CSS + GSAP, HF renders deterministically via headless Chrome + FFmpeg. OD already has the hyperframes-html model wired in VIDEO_MODELS and the skills/hyperframes/ skill that teaches the agent the contract; the templates close the loop by giving users one-click starting points (product reveal, sizzle reel, data chart, social overlays, …) that map directly to the HF catalog blocks.

Validation

• All 11 JSONs parse and pass the daemon's validateTemplate shape (id, surface, title, prompt ≥ 20 chars, source.repo + source.license).
• Filenames match id so GET /api/prompt-templates/:surface/:id detail lookups resolve.
• All 10 referenced HeyGen catalog thumbnail URLs return HTTP 200.
• README's existing tables and tags are preserved; only one row added to At a glance, one new section inserted.

Test plan

• pnpm tools-dev run web — open the Video templates tab in the entry view, confirm 11 new HyperFrames cards appear alphabetically with thumbnails loaded.
• Click any HyperFrames card → confirm preview modal shows full prompt body and source attribution.
• Click "Use template" → confirm the prompt drops into the composer with hyperframes-html model preselected.
• Render one short template (hyperframes-product-reveal-minimal) end-to-end and confirm a .mp4 lands as a project chip.
• Render the README locally / on GitHub — confirm both galleries render and Seedance thumbnails link to playable MP4s.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 59dd3abf14

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[lefarcen]

Hey @pftom! 🎉 The 11 HyperFrames templates themselves look excellent — clean JSON schemas, comprehensive prompts with scene-by-scene timing + GSAP eases, all validated by the daemon's validateTemplate, real HeyGen catalog thumbnails (HTTP 200), proper Apache-2.0 attribution. The Media generation README section is also well-written and fits naturally between Visual directions and Beyond chat.

However — this PR has severe scope drift. The diff shows 151 files changed, 8527 deletions, including:

CRITICAL: Unrelated deletions that belong in separate PRs

1. Design system mass deletion (57 files)

• Removes design-systems/{agentic,ant,application,artistic,bento,bold,brutalism,...}/DESIGN.md — 57 design skill DESIGN.md files (~71 lines each)
• Changes count from 129 → 72 systems in README
• Why this is blocking: These deletions are unrelated to HyperFrames. If they're intentional cleanup (e.g., removing low-quality imported skills per #XYZ discussion), that belongs in a separate PR with its own rationale. If accidental, they need to be restored.

2. Japanese locale deletion (639 lines)

• Deletes apps/web/src/i18n/locales/ja.ts entirely
• Removes README.ja-JP.md link from main README language switcher
• Why this is blocking: Locale removal is a product decision that needs maintainer sign-off + community notice. Bundling it with a template PR hides the impact.

3. Kiro CLI removal

• Removes Kiro from CLI list (11 → 10), adapter references, test coverage
• Why this is blocking: CLI adapter removal affects user-facing feature parity and should be discussed/documented separately (deprecation notice, migration guide if Kiro users exist).

4. Infrastructure gutting

• Deletes apps/daemon/src/app-version.ts + tests (app version tracking)
• Removes .github/workflows/release-stable.yml (406 lines), scripts/release-stable.ts (141 lines), CHANGELOG.md (192 lines)
• Deletes tools/pack/src/win.ts (1194 lines — entire Windows packaging)
• Removes TRANSLATIONS.md (228 lines)
• Why this is blocking: These are major CI/CD and packaging changes. Each deserves its own PR with rollout plan + stakeholder review.

5. Seedance Three Kingdoms template deletion (7 templates)

• Removes prompt-templates/video/{seedance-three-kingdoms-guanyu-slaying-yanliang, lyubu-yuanmen-archery, zhaoyun-cradle-escape}.json + .mp4 artifacts + screenshots
• Also removes game-ui-ancient-china-open-world-mmo-hud.json, choreography breakdowns, etc.
• Why this is blocking: If these were placeholder/test templates → explain in commit message. If they're real user-facing templates → deletion needs justification (licensing issue? quality bar?).

What should happen

Option A (recommended): Revert all unrelated changes, keep only HyperFrames additions

1. git rebase -i main and drop/edit commits that touch non-HyperFrames files
2. Keep only:
   • 11 new prompt-templates/video/hyperframes-*.json files
   • README.md changes: new Media generation section + At a glance table row
   • Any HyperFrames-specific daemon/web wiring (if needed — currently hyperframes-html model already exists per apps/web/src/media/models.ts:347)
3. Force-push cleaned branch

Option B: Split into multiple PRs

1. This PR (#227) → HyperFrames templates + README only
2. New PR → Design system cleanup with rationale ("Removing 57 low-usage imported skills per maintainer discussion in #XYZ")
3. New PR → Locale consolidation ("Deprecating ja/de locales due to unmaintained translations")
4. New PR → Kiro CLI removal + deprecation notice
5. New PR → CI/packaging refactor ("Simplify release workflow + remove Windows native packaging")
6. New PR → Seedance Three Kingdoms template removal with explanation

Option C: If all changes are intentional as one "big cleanup" commit

• Retitle PR to reflect actual scope: refactor: remove 57 design skills, ja/de locales, Kiro CLI, Windows packaging; add 11 HyperFrames templates
• Add detailed commit body explaining:
  • Why each deletion (unmaintained? licensing? quality bar?)
  • Impact on existing users (e.g., "Kiro CLI had 0 active users per telemetry")
  • Rollback plan if users complain
• Get explicit maintainer approval before merge (this is not a routine template addition anymore)

PR #98 precedent

This mirrors PR #98's scope-drift pattern ("OneShot Design workflow launcher" that deleted 5 locales + 7 docs + 6 skills). That PR was eventually closed after repeated "still production-ready" reviews couldn't address the core issue: major decisions (removing existing surfaces) bundled with a feature PR.

Why scope drift breaks the review process:

• Reviewers focus on the stated feature (HyperFrames templates) → miss the deletions
• Deletions that need stakeholder discussion get auto-merged without visibility
• Rollbacks become messy (can't revert just the bad part without losing the good part)

The HyperFrames part is LGTM 🎉

Once the scope is cleaned up, I'd love to approve the HyperFrames additions. They're production-ready:

• ✅ All 11 JSON schemas pass validateTemplate (id, surface, title, prompt ≥ 20 chars, source.repo + license)
• ✅ Filenames match id → daemon detail lookups work
• ✅ model: "hyperframes-html" matches VIDEO_MODELS entry
• ✅ Preview URLs return HTTP 200 (HeyGen CDN)
• ✅ Prompt bodies are comprehensive (scene timing, GSAP eases, palette, non-negotiables)
• ✅ README insertion point is natural (between Visual directions and Beyond chat)
• ✅ No security issues (all external URLs are HeyGen/Cloudflare CDN, no user-controlled injection)

Minor suggestions (non-blocking, for future iterations):

• P3: Consider adding a duration field to each template's JSON (currently only in prompt body) so the gallery can show "5s" / "30s" badges without parsing prompts
• P3: README says "83 ready-to-replicate prompts" (36 image + 36 Seedance + 11 HyperFrames) — if the 7 Seedance Three Kingdoms deletions are intentional, update the count to 76

Action needed: Please clarify intent for the 8500-line deletion, then either revert unrelated changes or retitle + get maintainer sign-off. Happy to re-review once scope is clean! 🚀

[pftom]

Pushed 25d8704 (force-push, rebased on current main). Net diff against main is now 17 files / 666 additions / 0 deletions (gh api repos/nexu-io/open-design/pulls/227):

• 11 new prompt-templates/video/hyperframes-*.json
• 5 README locales (README.md, README.de.md, README.ja-JP.md, README.ko.md, README.zh-CN.md) — each gets the same Media generation row in At a glance and the same translated Media generation section between Visual directions and Beyond chat
• apps/web/src/i18n/content.ts — German titles/summaries for the 11 new templates, plus the Product / Marketing / Data / Travel / Branding / Short Form categories and hyperframes / title-card / sizzle / etc. tags

Counts in all five READMEs now read 93 prompts (43 gpt-image-2 + 39 Seedance + 11 HyperFrames) — accurate against current main.

Re: @chatgpt-codex-connector P1 — German i18n sync ✅

Adding these new template IDs/categories/tags without updating apps/web/src/i18n/content.ts breaks the German sync guarantees enforced by apps/web/src/i18n/content.test.ts.

Addressed in c77e32c i18n(de): register new HyperFrames templates, categories, tags — adds 11 entries to DE_PROMPT_TEMPLATE_COPY, plus the new categories/tags to DE_PROMPT_TEMPLATE_CATEGORIES / DE_PROMPT_TEMPLATE_TAGS. The content.test.ts predicate is expect.arrayContaining(...) against IDs/categories/tags read from prompt-templates/{image,video}/*.json, so all new IDs and metadata are now covered.

Re: @lefarcen review — scope is clean ⚠️

That review states "151 files changed, 8527 deletions" and lists locale removals, design-system mass deletion, Kiro adapter removal, Windows packaging deletion, etc. None of that is true. Verified via the GitHub API:

$ gh api repos/nexu-io/open-design/pulls/227 --jq '{additions, deletions, changed_files}'
{"additions":666,"changed_files":17,"deletions":0}

Zero deletions. The 17 changed files are the three categories listed above. No design systems were removed, no locales were dropped, no CLI adapters were touched, no CI workflows were modified, no Windows packaging was deleted, no Three Kingdoms templates were removed (they're now part of this PR's base since rebase). The review appears to have hallucinated a different PR's diff onto this one — happy to walk through any specific file if it'd help.

The PR remains scope-clean: HyperFrames templates + README copy + the i18n delta required to keep the German content test green.

[chatgpt-codex-connector]

To use Codex here, create a Codex account and connect to github.

[lefarcen]

Perfect! 🎉 Scope is now clean — 17 files, 666 additions, 0 deletions. All CRITICAL issues from the first review are resolved:

✅ All 57 design system deletions: reverted
✅ Japanese locale deletion: reverted
✅ Kiro CLI removal: reverted
✅ Infrastructure gutting (Windows packaging, release workflows, CHANGELOG.md): reverted
✅ Seedance Three Kingdoms template deletions: reverted

What remains (exactly as the PR title promised):

• 11 new HyperFrames video prompt templates (all validate clean)
• Media generation section in README.md (+ 4 localized READMEs)
• German i18n for the new templates

Template quality — production-ready:

• All 11 JSONs pass validateTemplate shape
• Filenames match id (daemon detail lookups work)
• Preview URLs return HTTP 200
• Prompts comprehensive (scene timing, GSAP eases, HyperFrames non-negotiables)
• Proper Apache-2.0 attribution to heygen-com/hyperframes

LGTM for merge! 🚀