motion-graphics: point the Builder at hyperframes-creative's motion-principles.md
メンテナーはふだん 1 日以内に返信
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 88/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
調査の方向性
skills/motion-graphics/agents/builder.md と skills/motion-graphics/SKILL.md から始めて Builder の dispatch コンテキストをたどり、その後 categories/charts/module.md と categories/stat/module.md を調べます。motion-principles.md と data-in-motion.md への参照が指定された箇所に追加されていること、またすべてのリンクが既存の hyperframes-creative ファイルを解決することを確認します。
索引モデルが issue の本文から書いたものです。
説明
Problem
skills/motion-graphics never references skills/hyperframes-creative (no mention in any file on main). As a result, hyperframes-creative/references/motion-principles.md is not on the motion-graphics read path, even though motion-graphics is the most motion-first workflow in the repo.
I checked whether its guardrails are covered elsewhere on that path (SKILL.md, agents/director.md, agents/builder.md, references/builder-contract.md, references/motion-vocabulary.md, plus the SKILL.md of hyperframes, hyperframes-core and hyperframes-animation). They mostly are not:
| motion-principles.md guardrail | Covered on the motion-graphics path? |
|---|---|
| Vary eases (≤2 tweens per scene with the same ease) | No |
.out for entrances, .in for exits, .inOut for moves |
No (only per-primitive examples in motion-vocabulary.md) |
| Vary duration (slowest scene ~3× the fastest) | No |
Vary entrance direction (not always y:30, opacity:0) |
No |
| Build / breathe / resolve scene structure | Partly (categories/kinetic-type only: Hook → Build → Punch → Resolve) |
| Stagger by importance, total stagger < 500ms | No |
| Exits faster than entrances | No |
| Offset the first tween 0.1–0.3s | No |
The only route to the file today is indirect (hyperframes-animation/adapters/animate-text.md, or the capability table in hyperframes/SKILL.md), so whether the Builder reads it depends on the agent's own initiative.
hyperframes-creative/references/data-in-motion.md has the same gap for the charts and stat categories.
Proposed solution
A small docs-only change:
skills/motion-graphics/agents/builder.md— add a line under "Critical correctness" (or a new "Motion quality" heading): read../hyperframes-creative/references/motion-principles.mdbefore writing the timeline.skills/motion-graphics/SKILL.mdStep 4 — add that file to the Builder's dispatch context list.skills/motion-graphics/categories/charts/module.mdandcategories/stat/module.md— reference../hyperframes-creative/references/data-in-motion.md.
Alternatives considered
Inlining a condensed version into references/motion-vocabulary.md. This avoids a cross-skill read but duplicates content that would drift from the original, so a link seems better.
Alternatives considered
Inlining a condensed version into references/motion-vocabulary.md. This avoids a cross-skill read but duplicates content that would drift from the original, so a link seems better.
Additional context
While building short HTML motion pieces with an AI coding assistant (outside HyperFrames), I hit exactly the failure modes this file warns about: uniform easing, missing exits, flat timing. That is what led me to compare the motion-graphics read path against motion-principles.md. I have not measured the effect inside the motion-graphics workflow itself.
- 主要言語
- TypeScript
- スター
- 54.1k
- フォーク
- 4.9k
- 平均マージ
- 7時間 26分
- マージ済み PR（30日）
- 724
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
heygen-com/hyperframes のほかの issue
-
embedded-captions: occlusion gate records PASS when check-occlusion times out before its verdict対応中かも @xiajiahang が 1 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
heygen-com/hyperframes#5485 ·
メンテナーはふだん 1 日以内に返信
-
`hyperframes docs examples` lists templates that don't exist対応中かも @Muhtasim-Munif-Fahim が 2 日前に担当しました。 オープンbug difficulty/easy help wanted triage/ready
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
heygen-com/hyperframes#5393 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
lint: add tests for three caption rules that have none対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープンdifficulty/easy enhancement help wanted triage/ready
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
heygen-com/hyperframes#5388 ·
メンテナーはふだん 1 日以内に返信
-
Move the keyframe property defaults table into @hyperframes/core対応中かも @meghna810 が 2 日前に担当しました。 オープンdifficulty/easy enhancement help wanted triage/ready
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
heygen-com/hyperframes#5387 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
docs: add open, catch-up, timeline and history to the CLI reference対応中かも @meghna810 が 2 日前に担当しました。 オープンdifficulty/easy documentation help wanted triage/ready
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
heygen-com/hyperframes#5386 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
heygen-com/hyperframes の issue をすべて見る
似ている issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
-
area:cowork area:desktop documentation enhancement platform:macos
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
anthropics/claude-code#101720 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 77/100
apache/rocketmq-dashboard#6610 ·
メンテナーはふだん 3 日以内に返信
-
Add: MS NOWオープンcheck:passed streams:add
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
メンテナーはふだん 1 日以内に返信
-
Global update drops overrideAccess, so Local API updateGlobal fails filterOptions validation (3.90 regression)対応中かも @PINYOPATTANAWASANPORN が今日担当しました。 オープンarea: core Bug
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
payloadcms/payload#18674 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信