agentsope/SkillAlchemy / skills/agentsope-ai-video-director
agentsope-ai-video-director
UnverifiedDirect and implement programmatic videos from a natural-language sentence: brief, shots, style, timeline, assets, engine-specific coding prompts, draft, review and repair. Use when asked to make a video, product launch, explainer, Reel/Short, kinetic typography or docs-to-video with HyperFrames, Remotion or Motion Canvas, or to improve an existing code-video project. 一句话视频制作与导演工作流。
references/sop_models.md
View on GitHub# Admitted operation cards
Read the When-to-use and Boundary fields before applying a card. General is reusable only inside sigma; Scoped is a source-local note, never a new-film prescription. P02/P05/P06/P09 are optional author guidance, 待验证. Empty recovery/verification components remain unsupported. The input/output envelope below is package organization under C03, not a filled empirical component. Exact component evidence/bindings and aliases remain in [provenance.json](provenance.json).
C01–C09 are separate authored workflow, schema, routing, evaluation and distribution constraints. They carry no empirical evidence IDs. The seven-stage entry point implements them; they do not upgrade candidate confidence.
## P01 — Normalize a short topic before drafting sourced content
- **When-to-use:** A topic-only request is being developed through this creator workflow.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Normalize topic, slug, title and duration; obtain source-grounded research before writing factual script content.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R01-F003 → [R01-S006](https://github.com/coleam00/hyperframes-ai-video-generation/blob/098505b5d6b14dfcf87a5a7a50241fd9a119eb6e/.archon/workflows/create-classic-short.yaml), [R01-S007](https://github.com/coleam00/hyperframes-ai-video-generation/blob/098505b5d6b14dfcf87a5a7a50241fd9a119eb6e/.archon/commands/create-classic-short.md), [R01-S008](https://github.com/coleam00/hyperframes-ai-video-generation/blob/098505b5d6b14dfcf87a5a7a50241fd9a119eb6e/.claude/skills/diy-yt-creator/new-classic-short.md). Classification: **Scoped**; claim origins: author_stated.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Coleam classic-short topic-only factual-script workflow at 098505b5d6b14dfcf87a5a7a50241fd9a119eb6e; author-described workflow only. No matched facts-present/facts-absent production pair. This is an author-stated workflow, not evidence that defaults improve every product video.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R01-F003: low matched-pair support; observation: Read source text/code; no controlled production experiment.
## P02 — Choose how much aesthetic control to put into the coding-agent brief
- **When-to-use:** The brief either delegates aesthetic choices or requires a specific visual result.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Optional source-authored guidance (empirical effectiveness not verified): When delegating taste, state mood/style and allow choices. When exact control matters, state each relevant element’s shape, color, position and timing instead of leaving those choices implicit.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R01-F005 → [R01-S003](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/prompting/specification-dial.mdx). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Optional HyperFrames specification-dial prompt-control guidance at 2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2; delegating aesthetics versus specifying a particular appearance. No claim of validated visual effectiveness. No same-task empirical comparison; no universal palette, gradient ban, typography size, camera motion or one-style rule.
- **Confidence:** {"admission_basis": "optional_author_guidance", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R01-F005: low matched-pair support; observation: Read source text/code; no controlled production experiment.
Conditional cases (exact recorded branches):
- If Aesthetic delegation is intended: Mood-level brief leaves colors and staging to the agent.
- If A specific visual result is required: Supply explicit element/layout/timing values.
## P03 — Keep a required payoff cue from disappearing during implementation
- **When-to-use:** This countup needs the banknote payoff that an earlier author-described attempt omitted.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Name the banknote burst explicitly at the metric landing, state its settling window and retain the specified deterministic seed.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Check the requested payoff in the output; the researched revised sample contains banknotes, while precise motion and the earlier output remain unobserved.
- **Evidence:** R01-F004 → [R01-S001](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/prompting/examples.mdx), [R01-S020](https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-stat-countup.mp4). Classification: **Scoped**; claim origins: author_stated.
- **Failure Mode:** Admitted recovery: For this omitted-cue symptom, revise the brief to include the named payoff instead of relying on broad style language.
- **Boundary:** **Exact sigma:** HyperFrames stat-countup gallery R01-C001 revised banknote-payoff case; author-reported omission/rewrite and sampled revised frames only. Single author revision, earlier prompt/video absent. A spectacle is not required for other films.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R01-F004: medium; observation: Revised output sampled; pre-revision prompt/video absent.
## P04 — Express a required nonoverlap boundary
- **When-to-use:** An outgoing counter must be gone before the next title appears.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** State the outgoing fade completion before the incoming reveal begins; avoid assigning both events the same ambiguous instant when overlap is prohibited.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R01-F007 → [R01-S001](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/prompting/examples.mdx), [R01-S002](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/prompting/anatomy.mdx), [R01-S021](https://static.heygen.ai/hyperframes-oss/docs/images/prompting/example-loader-ready.mp4). Classification: **Scoped**; claim origins: author_stated.
- **Failure Mode:** Admitted recovery: Rewrite the completion/start relationship after the documented counter/reveal collision.
- **Boundary:** **Exact sigma:** Recorded HyperFrames counter-to-READY rewrite and loader wording at 2dd708e0; required nonoverlap in those examples only; original failed artifact unavailable. Author-reported rewrite; old artifact absent and current one-second samples cannot prove the exact boundary. Intentional overlap remains allowed.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R01-F007: medium; observation: Loader samples inspected, insufficient temporal resolution to confirm absence of all overlap.
## P05 — Keep a word-led technical explanation coherent when details exceed its budget
- **When-to-use:** A word-led technical explainer has a long research document or more mechanism detail than its duration supports.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Optional source-authored guidance (empirical effectiveness not verified): Choose one explanatory question or journey. Establish why the idea matters before its mechanism, and retain a concrete example for abstract information.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R02-F003 → [R02-S002](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/examples/rag/README.md), [R02-S008](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/reference/narration-guidance.md). Classification: **General**; claim origins: author_stated.
- **Failure Mode:** Admitted recovery: Cut mechanism detail before motivation; remove numbers that cannot be made concrete within this script.
- **Boundary:** **Exact sigma:** Optional Anything2Explainer author guidance at 735c79c8724e897e8971cd59dde7e5aa11e4d6ce for 2–10-minute narrated motion explainers whose pictures follow words. Wider applicability is source-asserted; effectiveness remains unverified. Broad author guidance in this stated narrated-explainer scope; no load-only outcome test or universal retention claim. Research summary only; do not bundle PolyForm source implementation or full prompts.
- **Confidence:** {"admission_basis": "optional_author_guidance", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R02-F003: medium; observation: Normative author guidance plus one film; no load-only outcome comparison. Preserve as hypothesis..
## P06 — Budget a structured single-idea explainer before coding
- **When-to-use:** The brief calls for the structured explainer covered by the source contract.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Optional source-authored guidance (empirical effectiveness not verified): Draft the on-screen shot script, then organize Hook → Problem → Solution → Proof/Demo → CTA and make a scene table whose frame budget sums to the target. Source claims from the brief and keep one CTA action.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R02-F001 → [R02-S016](https://github.com/lemomo-ai/lemo-opuscar/blob/4d7014aa7ba7d22c00513052dd996a4f200d5102/styles/dark-keynote/DEMO.md), [R02-S027](https://github.com/tradewithmeai/project-bright/blob/41b3a17c1e49663e86810c3e3eada7cba2316c2d/apps/claude-remotion/.claude/skills/explainer-arc/SKILL.md). Classification: **General**; claim origins: researcher_inferred.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Optional Project Bright explainer-arc guidance at 41b3a17c1e49663e86810c3e3eada7cba2316c2d: 90–180-second structured pieces teaching/selling one idea; excludes social clips, trailers, loops and isolated hero scenes. Author-claimed effectiveness unverified. This source explicitly excludes social clips, trailers, loops and isolated hero scenes. House beat durations/easing/hold values are not global defaults; no matched purpose-only creative result was acquired.
- **Confidence:** {"admission_basis": "optional_author_guidance", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R02-F001: high_for_unresolved; observation: Distinct story choices documented, but no controlled purpose-only contrast. No causal claim that type alone selects a pattern..
## P07 — Embodiment of one product action in a launch film
- **When-to-use:** This fictional sorting-app film is built around one product verb and one acted cursor.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** In this case, make the absence of sorting visible as accumulating UI; let the cursor perform one press that orders it, then reveal the product and one emphasized number. Sound and visual events read a shared note timeline.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R02-F004 → [R02-S016](https://github.com/lemomo-ai/lemo-opuscar/blob/4d7014aa7ba7d22c00513052dd996a4f200d5102/styles/dark-keynote/DEMO.md), [R02-S017](https://github.com/lemomo-ai/lemo-opuscar/blob/4d7014aa7ba7d22c00513052dd996a4f200d5102/styles/dark-keynote/demo/film.js). Classification: **Scoped**; claim origins: researcher_inferred.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Room to Think / fictional Tidy 42-second dark-keynote demo at Lemo 4d7014aa7ba7d22c00513052dd996a4f200d5102 only; code/doc design, no independent playback. One route selected for one demo, explicitly not the style’s default arc. Tidy and its statistics are fictional. No causal product-vs-data contrast or independently watched film.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R02-F004: high_for_observed_source_designs; observation: Code/doc narrative treatments differ, but purpose-only treatment effect cannot be isolated..
## P08 — Let a data story’s marks and reveal follow its dataset
- **When-to-use:** The admitted example is the temperature time-series film with progressively accumulated marks.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** In this case, derive marks and scaling from the dataset, build from individual observations to the full-series reveal, and keep the unknown future cell visibly unknown.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R02-F004 → [R02-S018](https://github.com/lemomo-ai/lemo-opuscar/blob/4d7014aa7ba7d22c00513052dd996a4f200d5102/styles/dataviz/DEMO.md), [R02-S020](https://github.com/lemomo-ai/lemo-opuscar/blob/4d7014aa7ba7d22c00513052dd996a4f200d5102/styles/dataviz/demo/film.js). Classification: **Scoped**; claim origins: researcher_inferred.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** A Hundred Summers temperature-data demonstration at Lemo 4d7014aa7ba7d22c00513052dd996a4f200d5102 only; selected dataset/mark/reveal design, no independent playback. One author-selected data narrative, not a prescribed arc for every chart or genre. Actual playback, audio and data measurements were not performed by research.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R02-F004: high_for_observed_source_designs; observation: Code/doc narrative treatments differ, but purpose-only treatment effect cannot be isolated..
## P09 — Handle dense sonification and pen occlusion within the dataviz style
- **When-to-use:** Within this style, note gaps become dense or the drawing pen body covers fresh marks.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Optional source-authored guidance (empirical effectiveness not verified): Make dense-passage notes quieter, keep their decay no longer than 1.5 times the note gap, and steepen the pen angle when its body obscures newly drawn marks.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R02-F002 → [R02-S018](https://github.com/lemomo-ai/lemo-opuscar/blob/4d7014aa7ba7d22c00513052dd996a4f200d5102/styles/dataviz/DEMO.md), [R02-S019](https://github.com/lemomo-ai/lemo-opuscar/blob/4d7014aa7ba7d22c00513052dd996a4f200d5102/styles/dataviz/STYLE.md). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Admitted recovery: Use the source’s density-dependent audio and pen treatment for that obstruction symptom.
- **Boundary:** **Exact sigma:** Optional Lemo Data Storytelling style contract at 4d7014aa7ba7d22c00513052dd996a4f200d5102, specifically dense note passages or pen-body occlusion. The 1.5 ratio is style-local and empirically unverified. Explicit source applicability boundary; no local audio/render measurement. The 1.5 ratio is confined to this style and is not a universal mix rule.
- **Confidence:** {"admission_basis": "optional_author_guidance", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R02-F002: medium; observation: Changed relation relies on explicit dense-passage boundary, not a controlled rendered A/B. Actual early/late demo phases also change values and narrative position; that observational comparison is confounded. No audio level or rendering measurement..
## P10 — Recover when one drawing performer misses spoken deadlines
- **When-to-use:** Overlapping drawing work in the one-pen scheduler accumulates delay; satellites were author-reported twelve seconds late.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Give drawing jobs explicit completion windows and allocate another pen to overlapping jobs while retaining the word-timing anchors.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R02-F006 → [R02-S021](https://github.com/lemomo-ai/lemo-opuscar/blob/4d7014aa7ba7d22c00513052dd996a4f200d5102/styles/whiteboard/DEMO.md), [R02-S022](https://github.com/lemomo-ai/lemo-opuscar/blob/4d7014aa7ba7d22c00513052dd996a4f200d5102/styles/whiteboard/demo/film.js). Classification: **Scoped**; claim origins: author_stated.
- **Failure Mode:** Admitted recovery: Replace the overloaded single queue with bounded windows and additional drawing capacity for this film.
- **Boundary:** **Exact sigma:** Einstein in Your Pocket whiteboard production case at Lemo 4d7014aa: source-reported overloaded one-pen scheduler, explicit completion windows and extra pen capacity only. Real source-described recovery, no old/new render or measured benchmark. Workload and treatment changed together; no load-only causal claim.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R02-F006: medium; observation: Specific failure/recovery described; no inspected old render or benchmark..
## P11 — Choose transitions from outgoing visual focus in the kinetic-reel demo
- **When-to-use:** This demo changes between title, metric and state-machine chapters using its shared cue file.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Use the outgoing focal geometry to select the demo’s zoom, iris or wipe, and align scene/music hits through the shared cue file.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R03-F007 → [R03-S005](https://github.com/VisualxIntelligence/motion-tools-and-skills/blob/18c8426fe97c1353dc62afd584f7ac8e39ad64bd/skills/kinetic-reel/template/reel/reel.js), [R03-S025](https://github.com/VisualxIntelligence/motion-tools-and-skills/blob/18c8426fe97c1353dc62afd584f7ac8e39ad64bd/skills/kinetic-reel/template/reel/cues.js). Classification: **Scoped**; claim origins: researcher_inferred.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Visualx kinetic-reel 17-second OPEN/TITLE/STAT/FLOW/QUOTE/END code demo at 18c8426fe97c1353dc62afd584f7ac8e39ad64bd only. Code inspection only; no rendered audit or universal transition/easing prescription.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R03-F007: medium; observation: Specific code read; neither demo rendered in this audit.
## P12 — Preserve an acted payoff through camera and transition choices
- **When-to-use:** The character returns the star to the sky in this two-shot night narrative.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** In this case, preserve the night palette across the brush wipe, target the character with the iris, open the camera during the star’s flight, and show its arrival before the reaction.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R03-F007 → [R03-S006](https://github.com/VisualxIntelligence/motion-tools-and-skills/blob/18c8426fe97c1353dc62afd584f7ac8e39ad64bd/skills/painted-animation/template/src/scenes/demo.js), [R03-S007](https://github.com/VisualxIntelligence/motion-tools-and-skills/blob/18c8426fe97c1353dc62afd584f7ac8e39ad64bd/skills/painted-animation/template/ANIMATION_GUIDE.md). Classification: **Scoped**; claim origins: researcher_inferred.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Visualx painted-animation eleven-second fallen-star, two-shot night narrative code demo at 18c8426f only. Source-local code decisions, different engine/story/style from kinetic-reel. Neither demo was rendered in this audit.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R03-F007: medium; observation: Specific code read; neither demo rendered in this audit.
## P13 — Adapt the recorded embedded-caption layout to aspect ratio
- **When-to-use:** This specific caption module’s layout is being applied in landscape or portrait.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Preserve the recorded conditional layouts: landscape uses a clean side caption plane and conditional crown; portrait replaces the side plane with a full-width top band and optional crown below.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R03-F001 → [R03-S017](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/embedded-captions/references/layout-heuristics.md), [R03-S019](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/embedded-captions/references/example-renders/champion.html). Classification: **Scoped**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Recorded legacy/Cinematic subject-aware embedded-captions layout profile at HyperFrames 2dd708e0, English interview/caption context with no platform UI. Side-plane/top-band heuristics do not cover Standard mode, every caption mode or every HyperFrames film. Approximate 20% band and 4% broadcast margin are module heuristics. Current Standard/Cinematic modes differ; this legacy reference conditional is not asserted for every current caption mode or platform. No rendered aspect A/B.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R03-F001: high; observation: Read source aspect conditional; no re-rendered16:9/9:16 controlled pair; condition/action boundary documented only.
Conditional cases (exact recorded branches):
- If 16:9 recorded module profile: Side caption plane; crown only where applicable.
- If 9:16 recorded module profile: Full-width top band; optional crown below.
## P14 — Place or demote the crown in the documented interview layout
- **When-to-use:** The Jobs subject is right-biased and the short centered crown is largely swallowed, unlike the centered Champion layout.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** For the documented Jobs geometry, move the crown into the larger clean left zone or demote it to emphasis rather than retain the centered title.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R03-F005 → [R03-S017](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/embedded-captions/references/layout-heuristics.md), [R03-S018](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/embedded-captions/references/failure-modes.md), [R03-S019](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/embedded-captions/references/example-renders/champion.html). Classification: **Scoped**; claim origins: author_stated.
- **Failure Mode:** Admitted recovery: Apply the documented relocation/demotion to this occlusion symptom.
- **Boundary:** **Exact sigma:** Source-reported Jobs/Champion landscape interview crown-placement dilemma at HyperFrames 2dd708e0, with the recorded subject bias and phrase-length conditions only. Subject position and phrase length both changed; source-local repair, not an atomic aspect/language rule. No interview render was viewed.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R03-F005: medium; observation: Read author documented failure/repair, current champion absolute-stacked code; no source interview render viewed.
## P15 — Apply the placement-specific overlay contract for TikTok auction ads
- **When-to-use:** The video is delivered as the documented TikTok auction in-feed placement with its caption/anchor configuration.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Obtain and use the safe-zone template matching that placement and anchor/overlay configuration.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Review the platform preview while retaining the source’s device-preview limitations.
- **Evidence:** R03-F003 → [R03-S022](https://ads.tiktok.com/resources/help/article/tiktok-auction-in-feed-ads?lang=en-GB). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** TikTok auction in-feed advertising placement and its caption/anchor overlay configuration, official page updated June 2026 and retrieved 2026-10-09. No organic TikTok/Reels/Shorts/Douyin or universal pixel-safe-area rule. Pixel template was not acquired in research. No safe-zone percentages inferred for organic TikTok, Reels, Shorts or Douyin; language is held fixed.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R03-F003: high; observation: Official June2026 page read; no actual asset/platform preview compared.
## P16 — Compile HyperFrames timing and completed timeline registration
- **When-to-use:** An HTML HyperFrames composition needs a requested finite duration and a seekable animation timeline.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Use seconds for data-start/data-duration. Author finite root data-duration when exact runtime is required. Build one completed paused timeline and register it under the matching composition ID; if build waits on fonts or other async setup, register at the end of that callback.
HyperFrames profile: root HTML uses data-composition-id, data-width, data-height and finite data-duration where requested. Timed clips use data-start/data-duration in seconds. For the GSAP profile, build gsap.timeline({paused:true}) completely, then assign window.__timelines[compositionId] = timeline. Root duration is read before script execution. Node >=22 and local FFmpeg/browser dependencies must be available for the documented CLI route.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R04-F001, R04-F002, R04-F003 → [R04-S001](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/packages/cli/package.json), [R04-S002](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/packages/core/package.json), [R04-S003](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/SKILL.md), [R04-S004](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/references/determinism-rules.md), [R04-S005](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/references/minimal-composition.md), [R04-S006](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-cli/SKILL.md), [R04-S012](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/concepts/compositions.mdx), [R04-S016](https://github.com/heygen-com/hyperframes/blob/0b21016905f208f8bc9fb37f7b65737f75fe0d2f/skills/hyperframes-core/references/determinism-rules.md), [R04-S017](https://github.com/heygen-com/hyperframes/blob/0b21016905f208f8bc9fb37f7b65737f75fe0d2f/skills/hyperframes-core/SKILL.md), [R04-S018](https://github.com/heygen-com/hyperframes/blob/0b21016905f208f8bc9fb37f7b65737f75fe0d2f/packages/cli/src/commands/render/plan.ts), [R04-S019](https://github.com/heygen-com/hyperframes/blob/0b21016905f208f8bc9fb37f7b65737f75fe0d2f/packages/core/src/runtime/init.ts). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** HyperFrames GSAP composition profile 0.8.142, research core docs at 2dd708e0 and byte-identical core/determinism docs at npm gitHead 0b210169; seconds, static finite root duration and completed paused registration. No all-files/source-build equivalence or matched-engine effectiveness. Root duration is read at compilation before scripts; later rewrites do not change it. Excess animation is cut, shorter timeline holds. Omitted duration invokes inference. Async setup is supported. No matched 15-second engine comparison.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R04-F001: medium; observation: Pinned code/documentation read; source production output not executed; R04-F002: high; observation: Pinned code/documentation read; source production output not executed; R04-F003: high; observation: Pinned code/documentation read; source production output not executed.
Conditional cases (exact recorded branches):
- If Synchronous build: Register the fully built paused timeline once.
- If Async build: Register after build completes, never an early empty timeline.
- If Exact output duration: Use finite authored root duration.
- If Duration intentionally inferred: Use the documented timeline/media/adapter inference.
Admitted engine profile bindings (do not mix adapters):
- HyperFrames profile: root HTML uses data-composition-id, data-width, data-height and finite data-duration where requested. Timed clips use data-start/data-duration in seconds. For the GSAP profile, build gsap.timeline({paused:true}) completely, then assign window.__timelines[compositionId] = timeline. Root duration is read before script execution. Node >=22 and local FFmpeg/browser dependencies must be available for the documented CLI route.
Scope: hyperframes@0.8.142; research docs 2dd708e0 versus registry gitHead 0b210169; critical core docs byte-identical, not all-files/source-build equivalence. Sources: R04-S001, R04-S002, R04-S003, R04-S004, R04-S005, R04-S016, R04-S017, R04-S018, R04-S019.
Actual observation: Two-second synthetic paused-timeline geometry render and repeated seek ran; async, fonts, media and audio did not..
## P17 — Choose HyperFrames standalone versus nested composition structure
- **When-to-use:** The same content is used as a top-level root or mounted sub-composition.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Use a direct body composition for a standalone root. For the recommended nested form, keep internal style/script within the template and match host, root and timeline IDs rather than depending on fallback.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R04-F006 → [R04-S003](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/SKILL.md), [R04-S005](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/references/minimal-composition.md), [R04-S012](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/concepts/compositions.mdx). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** HyperFrames 0.8.142 core/assembler documentation at 2dd708e0: direct standalone root versus recommended template sub-composition form; documented plain-document/mismatched-ID fallbacks remain possible. Plain-document and single mismatched-ID fallback exists. Do not turn an older creator’s strict-ID repair into a false claim that no fallback exists.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R04-F006: high; observation: Pinned code/documentation read; source production output not executed.
Conditional cases (exact recorded branches):
- If Standalone root: Direct body composition.
- If Nested composition: Recommended template form with matching host/root/timeline IDs.
## P18 — Wait for declared HyperFrames resources instead of using duration as readiness
- **When-to-use:** Assets or composition build are pending even though duration is already known.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Use the engine’s declared readiness for fonts, images, media and computation; a known duration alone does not establish completed build/assets.
HyperFrames readiness profile: keep framework-owned window.__timelines, __hf, __hyperframes, __player and readiness flags intact. Declare application computation through __hf.buildReady with unique promise keys; use application-specific namespaces and element IDs.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Inspect resource warnings and rendered completeness; media errors can settle promises and best-effort output can still omit assets.
- **Evidence:** R04-F004 → [R04-S003](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/SKILL.md), [R04-S004](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/references/determinism-rules.md), [R04-S009](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/packages/core/src/compositionReadiness.ts), [R04-S010](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/packages/core/src/runtime/window.d.ts). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** HyperFrames recorded 0.8.142 core/readiness contract at 2dd708e0: declared fonts/images/media/computation and framework namespace ownership. Resource-error settling and best-effort behavior are contract boundaries, not tested asset completeness. The research smoke used no fonts/media/audio or async setup; successful process status is not visual completeness.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R04-F004: high; observation: Pinned code/documentation read; source production output not executed.
Admitted engine profile bindings (do not mix adapters):
- HyperFrames readiness profile: keep framework-owned window.__timelines, __hf, __hyperframes, __player and readiness flags intact. Declare application computation through __hf.buildReady with unique promise keys; use application-specific namespaces and element IDs.
Scope: HyperFrames recorded core/readiness contract at 2dd708e0, version 0.8.142. Sources: R04-S003, R04-S004, R04-S009, R04-S010.
Actual observation: Documentation and types read; no injected async/media loading test..
## P19 — Keep HyperFrames animation inside its ownership boundary
- **When-to-use:** A seekable composition animates timed visual/media elements.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Derive animation state from seek time and animate inner visual elements; let the framework control timed clip visibility and video/audio clock. Avoid writing visibility/autoAlpha on timed clips or manually playing/seeking their media.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R04-F007 → [R04-S003](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/SKILL.md), [R04-S004](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-core/references/determinism-rules.md), [R04-S012](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/concepts/compositions.mdx). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** HyperFrames 0.8.142 timed-clip/media ownership and seek-state contract at 2dd708e0. Approved non-GSAP adapters remain possible; no imported Remotion/Motion Canvas timing. GSAP is the primary profile, with approved non-GSAP seekable adapters possible; not a claim that GSAP is the only runtime.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R04-F007: high; observation: Pinned code/documentation read; source production output not executed.
## P20 — Inspect visible HyperFrames loading separately from static lint
- **When-to-use:** Lint is clean or preview appears blank, and the composition must be visibly mounted.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Run browser check and snapshots at relevant times to inspect actual mounting/layout; retain reported sample counts because lint errors can prevent browser layout/contrast sampling.
Pinned local CLI templates (angle-bracket values are caller parameters): ./node_modules/.bin/hyperframes --version; ./node_modules/.bin/hyperframes check <project-dir> --at <seconds-list> --json; ./node_modules/.bin/hyperframes snapshot <project-dir> --at <seconds-list> --no-end --describe false. Preview contract: ./node_modules/.bin/hyperframes preview <project-dir> --background. These are separate invocations, not shell chains.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Confirm visible snapshots and expected duration separately from lint status; check does not guarantee full motion or audio correctness.
Pinned strict smoke/export template: ./node_modules/.bin/hyperframes render <project-dir> --output <output.mp4> --fps <fps> --workers 1 --no-best-effort --frames-cache-dir off. Then inspect the actual file with ffprobe -v error -show_format -show_streams -of json <output.mp4>. The one-worker/disabled-cache/strict settings are a reproduced validation profile, not a claim of fastest or universally required settings.
- **Evidence:** R01-F006, R04-F005 → [R01-S009](https://github.com/coleam00/hyperframes-ai-video-generation/blob/098505b5d6b14dfcf87a5a7a50241fd9a119eb6e/.claude/rules/sub-composition-wiring.md), [R04-S006](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/skills/hyperframes-cli/SKILL.md), [R04-S008](https://github.com/heygen-com/hyperframes/blob/2dd708e0a214fa4b8bffadc6a13c7ff55ef954a2/docs/guides/rendering.mdx), [R04-S015](https://registry.npmjs.org/hyperframes/-/hyperframes-0.8.142.tgz). Classification: **Scoped**; claim origins: author_stated, documented_contract.
- **Failure Mode:** Admitted recovery: For the older Coleam empty-preview incident, inspect cross-file composition IDs, clip timing/class/metadata and displayed browser duration; treat it as version-specific diagnosis.
- **Boundary:** **Exact sigma:** Two separate recorded cases: installed HyperFrames 0.8.142 local check/snapshot/strict-export validation profile; and Coleam 098505b5 empty-preview mounting diagnosis with unspecified older engine version. The older diagnosis is not a universal current fallback rule. Do not import the older strict-match claim into the current assembler’s fallback semantics. The smoke is a two-second silent geometry fixture, not an async/media quality validation.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R01-F006: medium; observation: Read source text/code; no controlled production experiment; R04-F005: high; observation: Pinned code/documentation read; source production output not executed.
Admitted engine profile bindings (do not mix adapters):
- Pinned local CLI templates (angle-bracket values are caller parameters): ./node_modules/.bin/hyperframes --version; ./node_modules/.bin/hyperframes check <project-dir> --at <seconds-list> --json; ./node_modules/.bin/hyperframes snapshot <project-dir> --at <seconds-list> --no-end --describe false. Preview contract: ./node_modules/.bin/hyperframes preview <project-dir> --background. These are separate invocations, not shell chains.
Scope: Installed hyperframes@0.8.142 CLI; choose meaningful scene/mount/boundary sample times rather than copying the smoke times. Sources: R04-S006, R04-S008, R04-S015.
Actual observation: Version/check/snapshot ran on silent two-second smoke; preview route is documented, not visually reviewed in R04..
- Pinned strict smoke/export template: ./node_modules/.bin/hyperframes render <project-dir> --output <output.mp4> --fps <fps> --workers 1 --no-best-effort --frames-cache-dir off. Then inspect the actual file with ffprobe -v error -show_format -show_streams -of json <output.mp4>. The one-worker/disabled-cache/strict settings are a reproduced validation profile, not a claim of fastest or universally required settings.
Scope: Installed hyperframes@0.8.142 local CLI profile, exact help/commands retained in research_R04.engine_contract and validation_results. Sources: R04-S006, R04-S008, R04-S015.
Actual observation: Actual silent geometry MP4: 640×360, 30fps, 60 frames, two seconds; sampled-frame/repeated-seek review only..
## P21 — Compile Remotion’s frame-derived timing deterministically
- **When-to-use:** A Remotion composition and its child intervals must render under out-of-order or parallel capture.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Derive visible motion from the requested zero-indexed frame. Set durationInFrames from fps and target seconds, with last frame duration−1. Treat Sequence visibility as [from, from+duration), retain local child clocks, pass fps to spring and make interpolation clamps explicit.
Remotion registration profile: registerRoot(Root); Root contains Composition with id, component, fps, width, height and durationInFrames. useCurrentFrame() is zero-indexed and local inside a Sequence; supply an absolute-frame prop only when that design needs it. spring({frame,fps,...}) uses composition fps; interpolate(frame,inputRange,outputRange,{extrapolateLeft:"clamp",extrapolateRight:"clamp"}) explicitly bounds values when clamping is intended.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Compare the same requested frame under reordered/repeated capture; bound the conclusion to tested frames/environment.
- **Evidence:** R05-F001, R05-F004, R08-F007 → [R05-S004](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/flickering.mdx), [R05-S005](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/use-current-frame.mdx), [R05-S006](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/composition.mdx), [R05-S007](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/sequence.mdx), [R05-S008](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/interpolate.mdx), [R05-S009](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/spring.mdx). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Admitted recovery: Replace timer or mutable tab-state motion with requested-frame state; concurrency 1 does not reliably synchronize wall-clock animation.
- **Boundary:** **Exact sigma:** Remotion 4.0.534 / 4d9ff70e1f489cd671045d8a2e944e4b8853c63d frame-function, Sequence, spring, interpolation and flickering contracts. Reordered/repeated-frame verification establishes only tested frames/environment. 15 seconds × 30fps gives 450 frames 0…449 as arithmetic. The actual smoke was 60 frames/2 seconds and one repeated still; no matched-engine performance or full determinism certification.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R05-F001: high_for_documented_contract; limited_runtime_validation; observation: Exact tag docs read; synthetic fixture not matched15s comparison; R05-F004: high_for_documented_contract; limited_runtime_validation; observation: ffprobe60frames/30fps/2s; sampled29/30/59 verify boundary/local reset in smoke only; R08-F007: high documented boundary; medium author-reported outcomes; observation: First-party text/source read; no controlled production trial.
Admitted engine profile bindings (do not mix adapters):
- Remotion registration profile: registerRoot(Root); Root contains Composition with id, component, fps, width, height and durationInFrames. useCurrentFrame() is zero-indexed and local inside a Sequence; supply an absolute-frame prop only when that design needs it. spring({frame,fps,...}) uses composition fps; interpolate(frame,inputRange,outputRange,{extrapolateLeft:"clamp",extrapolateRight:"clamp"}) explicitly bounds values when clamping is intended.
Scope: Remotion 4.0.534 / 4d9ff70e; package versions match; direct Sequence legal while docs advise timing props. Sources: R05-S005, R05-S006, R05-S007, R05-S008, R05-S009.
Actual observation: Two-second frame/Sequence/spring smoke rendered; 29/30/59 samples and one repeated still inspected..
## P22 — Select Remotion’s Node server export path when that environment is available
- **When-to-use:** Node and the required browser/encoding environment are available for server rendering.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Use a bundled or served composition URL, selectComposition and renderMedia, or the version-matched render/still CLI path; server capture screenshots browser frames and encodes with FFmpeg.
Version-matched local CLI templates: ./node_modules/.bin/remotion versions; ./node_modules/.bin/remotion studio <entry.tsx> --port=<port>; ./node_modules/.bin/remotion still <entry.tsx> <composition-id> <output.png> --frame=<frame> --image-format=png --browser-executable=<chrome-path>; ./node_modules/.bin/remotion render <entry.tsx> <composition-id> <output.mp4> --codec=h264 --concurrency=2 --browser-executable=<chrome-path>. API route: bundle/serve URL → selectComposition → renderMedia. Concurrency 2 is the executed smoke configuration, not a universal performance optimum.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Server profile output probe: ffprobe -v error -show_format -show_streams -of json <output.mp4>; compare actual dimensions/fps/duration/frame coverage to Composition. Do not treat the intentionally empty initial local spring frame in the smoke as an unintended black-frame failure.
- **Evidence:** R05-F002, R05-F004, R06-F003 → [R05-S006](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/composition.mdx), [R05-S014](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/client-side-rendering/index.mdx), [R05-S015](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/client-side-rendering/limitations.mdx), [R05-S018](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/cli/render.mdx), [R05-S019](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/cli/still.mdx), [R05-S020](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/cli/studio.mdx), [R05-S021](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/renderer/render-media.mdx), [R05-S022](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/renderer/select-composition.mdx), [R05-S023](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/bundle.mdx), [R05-S024](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/ssr.mdx). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Remotion 4.0.534 / 4d9ff70e server/Node screenshot and encoding route with exact version-matched packages and selected browser. CLI concurrency 2 and silent geometry probe are reproduced profiles, not performance optima. Version-matched CLI/API paths only; server two-second geometry smoke ran, font/audio/media fault injection and full-motion review did not.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R05-F002: high_for_documented_contract; limited_runtime_validation; observation: Same release documentation and package checked; server smoke executed; browser render unexecuted; R05-F004: high_for_documented_contract; limited_runtime_validation; observation: ffprobe60frames/30fps/2s; sampled29/30/59 verify boundary/local reset in smoke only; R06-F003: high; observation: R05 shared immutable v4.0.534 docs read; current official docs verified stable>=4.0.491.
Admitted engine profile bindings (do not mix adapters):
- Version-matched local CLI templates: ./node_modules/.bin/remotion versions; ./node_modules/.bin/remotion studio <entry.tsx> --port=<port>; ./node_modules/.bin/remotion still <entry.tsx> <composition-id> <output.png> --frame=<frame> --image-format=png --browser-executable=<chrome-path>; ./node_modules/.bin/remotion render <entry.tsx> <composition-id> <output.mp4> --codec=h264 --concurrency=2 --browser-executable=<chrome-path>. API route: bundle/serve URL → selectComposition → renderMedia. Concurrency 2 is the executed smoke configuration, not a universal performance optimum.
Scope: Remotion 4.0.534 at 4d9ff70e; all installed Remotion packages exact 4.0.534. Sources: R05-S018, R05-S019, R05-S020, R05-S021, R05-S022, R05-S023, R05-S024.
Actual observation: CLI help/versions, still and server render executed; Studio HTTP 200 observed, visual Studio review absent..
- Server profile output probe: ffprobe -v error -show_format -show_streams -of json <output.mp4>; compare actual dimensions/fps/duration/frame coverage to Composition. Do not treat the intentionally empty initial local spring frame in the smoke as an unintended black-frame failure.
Scope: Remotion 4.0.534 server smoke/output validation; caller Composition determines acceptance. Sources: R05-S006, R05-S018, R05-S021.
Actual observation: Actual 320×180 H264, 30fps, 60-frame/two-second file; sample frame 30 is intentionally initial/empty; no audio track..
## P23 — Select the isolated Remotion browser compositor only within its supported subset
- **When-to-use:** Only a browser is available and its WebCodecs/codec and supported composition subset can be established.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Use renderMediaOnWeb with component/config/inputProps rather than server bundling. Adapt media and DOM/CSS to the browser compositor’s supported subset; OffthreadVideo, Html5Video and Html5Audio are not supported by this path.
Browser profile uses @remotion/web-renderer renderMediaOnWeb/renderStillOnWeb with composition config and inputProps. Pinned baseline support: Chrome 94+, Firefox 130+, Safari 26+, plus supported codec/WebCodecs. web-renderer requires React >=18. Optional nested HTML-in-canvas capture requires Chrome 157.0.8080.0+; the fallback built-in DOM compositor has its own supported subset.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Verify the actual browser, WebCodecs and target codec/component support; optional HTML-in-canvas has its own browser requirement and cannot be assumed in the tested Chrome 154.
- **Evidence:** R05-F002, R06-F003 → [R05-S014](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/client-side-rendering/index.mdx), [R05-S015](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/client-side-rendering/limitations.mdx), [R05-S016](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/web-renderer/package.json). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Remotion 4.0.534 @remotion/web-renderer browser compositor, WebCodecs/codec and documented DOM/CSS/media subset; React >=18. HTML-in-canvas Chrome 157.0.8080.0+ condition is separate from baseline browsers. Browser export remains unexecuted. Browser export unexecuted. Server rendering and client compositing are different routes; the installed Chrome server smoke does not validate browser export.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R05-F002: high_for_documented_contract; limited_runtime_validation; observation: Same release documentation and package checked; server smoke executed; browser render unexecuted; R06-F003: high; observation: R05 shared immutable v4.0.534 docs read; current official docs verified stable>=4.0.491.
Admitted engine profile bindings (do not mix adapters):
- Browser profile uses @remotion/web-renderer renderMediaOnWeb/renderStillOnWeb with composition config and inputProps. Pinned baseline support: Chrome 94+, Firefox 130+, Safari 26+, plus supported codec/WebCodecs. web-renderer requires React >=18. Optional nested HTML-in-canvas capture requires Chrome 157.0.8080.0+; the fallback built-in DOM compositor has its own supported subset.
Scope: Remotion 4.0.534 browser path; separate compositor/codec checks still required. Sources: R05-S014, R05-S015, R05-S016.
Actual observation: Official contract/packages read; browser render was not executed..
## P24 — Keep Remotion resource-wait handles stable and clear them
- **When-to-use:** A render depends on asynchronous data, images or fonts.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Use a stable lazily initialized wait handle on the documented server path, and useDelayRender’s context-bound hook on the browser compositor. Continue every completed handle, or cancel on failure, instead of allocating handles on every rerender.
Remotion readiness profile: allocate server delayRender handles through stable lazy useState initialization; use continueRender(handle) or cancelRender(error). On the browser compositor use the context-bound useDelayRender hook. Load fonts before measuring text. The default readiness timeout is 30 seconds at this pin.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R05-F003 → [R05-S004](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/flickering.mdx), [R05-S010](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/delay-render.mdx), [R05-S011](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/fonts.mdx). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Admitted recovery: Resolve leaked/pending handles or cancel the failing render; do not disguise the timeout as completed resource loading.
- **Boundary:** **Exact sigma:** Remotion 4.0.534 server delayRender/resource/font handling and browser context-bound useDelayRender contract; stable handles, clear/cancel semantics and default readiness timeout only. Default 30-second timeout is the versioned engine contract, not a creative timing default. Data state is allowed; motion must remain frame-derived. No resource fault injection executed.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R05-F003: high_for_documented_contract; limited_runtime_validation; observation: Official bug/fix code read; no remote-resource fault injection.
Conditional cases (exact recorded branches):
- If Server screenshot/render readiness: Stable wait handle; clear or cancel all handles.
- If Browser compositor readiness: Use context-bound useDelayRender hook; clear or cancel all handles.
Admitted engine profile bindings (do not mix adapters):
- Remotion readiness profile: allocate server delayRender handles through stable lazy useState initialization; use continueRender(handle) or cancelRender(error). On the browser compositor use the context-bound useDelayRender hook. Load fonts before measuring text. The default readiness timeout is 30 seconds at this pin.
Scope: Remotion 4.0.534 resource/font-readiness contract; frame motion remains deterministic. Sources: R05-S004, R05-S010, R05-S011.
Actual observation: Bug/fix/docs read; remote-resource and font fault injection not executed..
## P25 — Require an explicit Motion Canvas video exporter for encoded delivery
- **When-to-use:** The scene must deliver encoded video instead of the default image sequence.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Install/register the version-matched @motion-canvas/ffmpeg plugin beside motionCanvas(), select Video (FFmpeg) in editor Video Settings, then use local editor RENDER and inspect output/<project-name>.mp4.
Motion Canvas 3.17.2 profile: makeScene2D(function* (view)); createRef/createSignal/waitFor/all from @motion-canvas/core; yield* delegates waits/tweens and durations are seconds. Import scenes with ?scene into makeProject({scenes}). In vite.config.ts, import ffmpeg and register ffmpeg() after motionCanvas(). Start the authored local Vite project with its npm run start script; select Video (FFmpeg) in Video Settings and click RENDER. The expected default video location is output/<project-name>.mp4; no headless CLI render command is asserted.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Check that the video exporter is actually selected and an encoded file exists.
- **Evidence:** R06-F001 → [R06-S001](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/rendering/index.mdx), [R06-S002](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/rendering/video.mdx), [R06-S004](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/flow.mdx), [R06-S006](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/ffmpeg/client/FFmpegExporterClient.ts), [R06-S007](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/ffmpeg/server/FFmpegExporterServer.ts), [R06-S024](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/signals.mdx). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Admitted recovery: When the video exporter is absent, install/register/select it before claiming video export; default image export and editor preview remain distinct states.
- **Boundary:** **Exact sigma:** Motion Canvas released 3.17.2 / e735a995aa738ca682feb4204a39ee7db7b5d279 generator/project/Vite-editor FFmpeg exporter contract. Local HMR/server bridge required; default image-sequence export and static build remain different routes; no official headless CLI assumed. Local install/build passed, UI render did not execute. Released exporter needs local Vite/HMR/server bridge; static production bundle is not this path. No verified official headless render CLI.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R06-F001: high; observation: Docs and installed3.17.2 client read; local install/build pass; UI export not executed.
Admitted engine profile bindings (do not mix adapters):
- Motion Canvas 3.17.2 profile: makeScene2D(function* (view)); createRef/createSignal/waitFor/all from @motion-canvas/core; yield* delegates waits/tweens and durations are seconds. Import scenes with ?scene into makeProject({scenes}). In vite.config.ts, import ffmpeg and register ffmpeg() after motionCanvas(). Start the authored local Vite project with its npm run start script; select Video (FFmpeg) in Video Settings and click RENDER. The expected default video location is output/<project-name>.mp4; no headless CLI render command is asserted.
Scope: Motion Canvas all packages exact 3.17.2 / released e735a995; generator replay is not an arbitrary pure renderAt(t) API. Sources: R06-S001, R06-S002, R06-S004, R06-S006, R06-S007, R06-S024.
Actual observation: npm install and tsc/Vite build passed; preview server started, native/browser UI unavailable; no encoded render..
## P26 — Configure Motion Canvas project audio separately from video export
- **When-to-use:** The selected video exporter must include an authorized local audio track, or the project intentionally has no audio.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Import the local track and pass it to makeProject({scenes, audio}); configure its offset and enable Include audio. With no project audio, Include audio is disabled and the video can be silent.
Released Motion Canvas audio profile: import authorized local audio and supply makeProject({scenes,audio}); store audio offset in shared project metadata and select Include audio when available. One project track is supported here. Do not import newer main sound() APIs; the positive-offset FIXME prevents assuming tested offset behavior.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Check configured project audio and Include audio independently from exporter presence.
- **Evidence:** R06-F002 → [R06-S002](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/rendering/video.mdx), [R06-S003](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/media.mdx), [R06-S006](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/ffmpeg/client/FFmpegExporterClient.ts), [R06-S007](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/ffmpeg/server/FFmpegExporterServer.ts). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Motion Canvas released 3.17.2 one-track project audio and FFmpeg exporter settings at e735a995, with Include audio conditional on project.audio. Positive-offset FIXME and untested sync/listening remain explicit. No export/listening performed. Positive offset implementation contains a FIXME; do not promise tested sync. Current main sound() APIs are not 3.17.2 evidence.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R06-F002: high; observation: Installed client disable(!project.audio) and server input conditional inspected; no audio export/listening.
Admitted engine profile bindings (do not mix adapters):
- Released Motion Canvas audio profile: import authorized local audio and supply makeProject({scenes,audio}); store audio offset in shared project metadata and select Include audio when available. One project track is supported here. Do not import newer main sound() APIs; the positive-offset FIXME prevents assuming tested offset behavior.
Scope: Motion Canvas released 3.17.2 one-track project-audio implementation. Sources: R06-S002, R06-S003, R06-S006, R06-S007.
Actual observation: Installed disable(!project.audio)/server audio input code inspected; audio export and listening unexecuted..
## P27 — Route the specific Canvas/WebGL reel through its actual encoder
- **When-to-use:** This reel’s documented Node/Chrome/FFmpeg stack is available; browser preview alone has no demonstrated encoded-export API.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Wait for window.ready/fonts, call renderAt(i/fps), and capture frames through the documented Puppeteer pipeline before FFmpeg encoding; audio is an explicit input.
The selected kinetic-reel backend is Canvas 2D → Three 0.160.0 → WebGL post → output canvas. Its Node renderer waits window.ready, invokes window.renderAt(t) at t=i/fps, and captures through Puppeteer/Chrome to JPEG sequence or pipe. External FFmpeg uses libx264/yuv420p/+faststart; audio is explicitly provided and encoded to AAC. The recorded script exposes --clip/--range and --frames then --encode; no browser-only encoding route is shown.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Treat browser-only execution as preview-only for this repository; do not claim a WebCodecs fallback that this source does not implement.
- **Evidence:** R06-F004 → [R03-S005](https://github.com/VisualxIntelligence/motion-tools-and-skills/blob/18c8426fe97c1353dc62afd584f7ac8e39ad64bd/skills/kinetic-reel/template/reel/reel.js), [R06-S013](https://github.com/VisualxIntelligence/motion-tools-and-skills/blob/18c8426fe97c1353dc62afd584f7ac8e39ad64bd/skills/kinetic-reel/template/render.mjs), [R06-S014](https://github.com/VisualxIntelligence/motion-tools-and-skills/blob/18c8426fe97c1353dc62afd584f7ac8e39ad64bd/skills/kinetic-reel/template/package.json). Classification: **Scoped**; claim origins: researcher_inferred.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Visualx kinetic-reel at 18c8426f Node/Chrome/external-FFmpeg source renderer only; browser-only source route is preview. No renderer execution or general Canvas/WebGL encoding fallback demonstrated. Canvas/WebGL names alone do not identify an encoder. Source-local route, no video generated and no general renderer certification. Same code case as R03, not an additional case.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R06-F004: medium; observation: Read renderAt/frame functions, readiness/font gate, ffmpeg args; no video generated in R06.
Admitted engine profile bindings (do not mix adapters):
- The selected kinetic-reel backend is Canvas 2D → Three 0.160.0 → WebGL post → output canvas. Its Node renderer waits window.ready, invokes window.renderAt(t) at t=i/fps, and captures through Puppeteer/Chrome to JPEG sequence or pipe. External FFmpeg uses libx264/yuv420p/+faststart; audio is explicitly provided and encoded to AAC. The recorded script exposes --clip/--range and --frames then --encode; no browser-only encoding route is shown.
Scope: Visualx kinetic-reel 18c8426f source contract only; resolve actual Puppeteer/Chrome/FFmpeg versions and rights before use. Sources: R03-S005, R06-S013, R06-S014.
Actual observation: Source renderer and dependency manifest inspected; no generated video and no CLI command beyond source-documented flags assumed..
## P28 — Resolve voice-led timing from ready audio instead of template placeholders
- **When-to-use:** The voiced brief has measured authorized narration, or narration/audio supply is still pending.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** With ready audio, read actual waveform/per-line timing and derive scene/subtitle tables from that clock. With pending audio, obtain authorized synthesis/supply first and mark storyboard duration/alignment provisional; empty subtitles and placeholder 300-frame tables are not completed narration.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Distinguish measured ready timing tables from empty templates; a supplied finished audio track can use the same downstream alignment tables.
- **Evidence:** R07-F001, R07-F002 → [R02-S001](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/README.md), [R02-S009](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/reference/narration-storyboard.md), [R02-S010](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/template/scripts/tts_build.py), [R07-S004](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/examples/rag/交付说明.md), [R07-S008](https://github.com/nateherkai/hyperframes-student-kit/blob/0d30152a82b9ceb93cfdd9bdbf46f0d5ab3cde86/video-projects/aisoc-lesson-5-1/STORYBOARD.md), [R07-S009](https://github.com/nateherkai/hyperframes-student-kit/blob/0d30152a82b9ceb93cfdd9bdbf46f0d5ab3cde86/video-projects/aisoc-lesson-5-1/index.html), [R07-S010](https://github.com/nateherkai/hyperframes-student-kit/blob/0d30152a82b9ceb93cfdd9bdbf46f0d5ab3cde86/video-projects/aisoc-lesson-5-1/assets/transcript.json), [R07-S017](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/template/src/common/Subtitle.tsx), [R07-S018](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/template/src/common/timeline.ts), [R07-S019](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/template/src/common/subs.ts). Classification: **General**; claim origins: author_stated + missing matched evidence, documented_workflow_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Anything2Explainer documented voiced production/supplied-audio pipeline at 735c79c8, with real waveform/per-line tables versus its explicitly empty templates. RAG/lecture observations do not establish silent-versus-voiced creative invariance or perceptual sync. No TTS invoked or audio listened. No held-fixed silent variant was acquired, so this does not infer a general silent-vs-voiced creative treatment.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R07-F001: high for documented contract; medium for author historical accounts; perception unverified; observation: Read code/timing; no audio listened or silent comprehension measured; R07-F002: high for documented contract; medium for author historical accounts; perception unverified; observation: Read empty template and synthesis code; no TTS/provider invoked; RAG historical output author-stated.
Conditional cases (exact recorded branches):
- If Authorized audio and measured timing ready: Build actual per-line/scene/subtitle timing.
- If Voiced intent but audio pending: Obtain audio first; retain provisional timing and incomplete narration state.
## P29 — Preserve the boundary type and fallback quality in the recorded TTS alignment pipeline
- **When-to-use:** Word-level block timing is required by this pipeline, but default sentence metadata or unmatched chunks may be present.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Request WordBoundary explicitly, map token/character cursors to block starts and subtract trimmed lead silence. Retain the source’s character-length interpolation only as a fallback for unmatched chunks.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: The recorded implementation uses word-boundary block starts where matched and interpolation otherwise; the author-reported possible half-second displacement is not a local measurement, and produced WAV data does not establish exact sync.
- **Evidence:** R07-F003 → [R02-S010](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/template/scripts/tts_build.py), [R07-S015](https://github.com/rany2/edge-tts/blob/7.2.0/src/edge_tts/communicate.py), [R07-S016](https://github.com/rany2/edge-tts/blob/7.2.0/LICENSE). Classification: **Scoped**; claim origins: dependency_code + author_documented_contract.
- **Failure Mode:** Admitted recovery: Flag fallback alignment as approximate instead of treating produced WAV data alone as exact sync.
- **Boundary:** **Exact sigma:** Anything2Explainer block-start algorithm at 735c79c8 paired with edge-tts 7.2.0 WordBoundary/SentenceBoundary constructor semantics. Interpolation and half-second displacement remain source-reported approximate fallback, not locally measured alignment. No transcription/forced alignment executed. Service/speaker/media permissions remain separate.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R07-F003: high for documented contract; medium for author historical accounts; perception unverified; observation: No transcription/forced alignment executed.
## P30 — Retiming a changed voice in the hard-coded RAG storyboard
- **When-to-use:** Spoken words, voice, rate or pause duration changes after the RAG storyboard’s frame numbers are fixed.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Regenerate timing and retime every affected hard-coded shot and caption cue against the changed voice.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R07-F004 → [R02-S009](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/reference/narration-storyboard.md), [R06-S005](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/time-events.mdx), [R07-S004](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/examples/rag/交付说明.md). Classification: **Scoped**; claim origins: source_stated_boundary.
- **Failure Mode:** Admitted recovery: Rebuild the fixed-frame storyboard timing after a voice change instead of retaining the old frame constants.
- **Boundary:** **Exact sigma:** Anything2Explainer RAG storyboard with hard-coded shot frames at 735c79c8; changed spoken words/voice/rate/pauses require the source-described retiming. No changed-voice output pair observed. Source-stated dependency, no revised-voice audio pair acquired. Not evidence that every engine uses hard-coded shot frames.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R07-F004: high for documented contract; medium for author historical accounts; perception unverified; observation: Read pinned docs; no revised voice recording or re-render.
## P31 — Use Motion Canvas’s own persisted event cues for spoken timing
- **When-to-use:** A Motion Canvas scene’s cues need adjustment to match ready or revised voiceover timing.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Use named waitUntil events and useDuration where appropriate, adjust their time in the editor and preserve the resulting scene metadata so downstream event shifts follow the engine’s contract.
Motion Canvas event profile: waitUntil(name) names an editor event; useDuration(name) reads its duration. Editor adjustments persist in scene metadata and can shift downstream events. Preserve metadata with the project.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R07-F004 → [R02-S009](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/reference/narration-storyboard.md), [R06-S005](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/docs/docs/getting-started/time-events.mdx), [R07-S004](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/examples/rag/交付说明.md). Classification: **General**; claim origins: source_stated_boundary.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Motion Canvas released 3.17.2 / e735a995 named editor events waitUntil/useDuration and persisted scene metadata contract, including downstream shifts. No automatic transcription/alignment or Remotion event API. Separate engine contract from RAG/Remotion frame constants. No automatic transcription/alignment is implied and no revised voice recording was tested.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R07-F004: high for documented contract; medium for author historical accounts; perception unverified; observation: Read pinned docs; no revised voice recording or re-render.
Admitted engine profile bindings (do not mix adapters):
- Motion Canvas event profile: waitUntil(name) names an editor event; useDuration(name) reads its duration. Editor adjustments persist in scene metadata and can shift downstream events. Preserve metadata with the project.
Scope: Motion Canvas 3.17.2 / e735a995 event APIs, never Remotion APIs. Sources: R06-S005.
Actual observation: Pinned event docs read; no automatic alignment or retimed voice render performed..
## P32 — Repair animated geometry crossing the actual caption band
- **When-to-use:** SC18 plane contour motion crosses the active narration caption region at the recorded frames.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** For this shot, reduce the plane travel from 300 to 80 pixels so the visible path stays above the caption band; the documented neighboring SC16 card repair uses horizontal entry and corrected first-frame timing.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Recheck the source-recorded transition/caption regions through consecutive cue-boundary frames; final v3 QC reports residual repairs and two low issues.
- **Evidence:** R07-F006, R08-F005 → [R02-S005](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/examples/rag/qc/qc_v1_C2.md), [R02-S006](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/examples/rag/qc/qc_v3_final.md), [R07-S006](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/examples/rag/shots_src/G4/BUILD_NOTES.md). Classification: **Scoped**; claim origins: author_stated, author_stated_historical_qc_and_fix.
- **Failure Mode:** Admitted recovery: Change the offending path and entry timing using the actual local caption region rather than a generic canvas margin.
- **Boundary:** **Exact sigma:** RAG SC18/SC16 1280×720@30fps local caption-path/entry repairs and v1/v3 author QC at 735c79c8; literal 300→80px and frame/pixel conditions remain film-local. Source-author QC/fix reports, repaired video not independently inspected. No universal y637–690, 80px path or frame tolerance.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R07-F006: high for documented contract; medium for author historical accounts; perception unverified; observation: Pinned QC and fix records read; this agent did not inspect repaired video; R08-F005: high documented boundary; medium author-reported outcomes; observation: Read actual v1/v3QC source; source-reported differences, no media playback.
## P33 — Give the eCPM source note its documented visibility window
- **When-to-use:** The 40–70 character source note arrives in the final caption block with only 0.97–1.7 seconds at half opacity.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** For this film, move the source/explanatory note to the first or second caption block to permit at least 2.5 seconds at at least 50% opacity.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Evaluate the note’s actual visible timing in this local treatment; the stated eight revisions and thresholds are author reports.
- **Evidence:** R07-F005 → [R02-S007](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/reference/lessons.md). Classification: **Scoped**; claim origins: author_stated_historical_revision.
- **Failure Mode:** Admitted recovery: Move the late note earlier in the same shot rather than leave the factual correction too late to read.
- **Boundary:** **Exact sigma:** Author historical 2026-09-07 eCPM film note-visibility revision: 40–70 characters, earlier block, >=2.5s at >=50% opacity. No universal reading floor or acquired output/comprehension evidence. No source/output chain or comprehension study acquired. Do not reuse 2.5 seconds or 50% as a global reading floor.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R07-F005: high for documented contract; medium for author historical accounts; perception unverified; observation: Historical account read; no recreated or observed frames.
## P34 — Prevent factual eCPM animation from displaying unsourced intermediate numerals
- **When-to-use:** A factual counter visibly passes through unsourced years, durations or monetary values before its verified endpoint.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** For this film, make intermediate values unreadable or remove the counter; the reported YearRoll treatment keeps blur at least 9px until landing and then removes it. Check formula/example label consistency.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Include a literal-value scan and frame inspection: this author reports a counter escaping four pixel-QC reviewers.
- **Evidence:** R07-F007 → [R02-S007](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/reference/lessons.md). Classification: **Scoped**; claim origins: author_stated_historical_revision.
- **Failure Mode:** Admitted recovery: Remove or obscure the unsupported factual intermediates while retaining the verified landing value.
- **Boundary:** **Exact sigma:** Author historical eCPM factual-year/duration/money-counter repair: unsourced readable intermediates versus blurred/removed counter. 9px is film-local; labeled illustrative values are separate conditions. Historical account only, no frames acquired. 9px is local; clearly labeled illustrative examples are a different condition, and this is not a ban on all numerical interpolation.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R07-F007: high for documented contract; medium for author historical accounts; perception unverified; observation: No source exact artifact or frames acquired.
## P35 — Separate static, sampled-frame and continuous-motion quality evidence
- **When-to-use:** The cut passes static checks or still-image review but pacing, motion and dynamic caption behavior must be assessed.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Use static checks for their declared coverage, then inspect consecutive transition/caption frames and reserve continuous pacing/countdown/drama judgments for actual viewing.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Report static/still results separately from actual full-motion review; a dynamic-caption detector can miss content, and stills cannot establish continuous beat pacing.
- **Evidence:** R08-F003, R08-F005 → [R02-S005](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/examples/rag/qc/qc_v1_C2.md), [R02-S006](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/examples/rag/qc/qc_v3_final.md), [R02-S025](https://github.com/tradewithmeai/project-bright/blob/41b3a17c1e49663e86810c3e3eada7cba2316c2d/apps/claude-remotion/.claude/skills/judge-video/LOOP_LOG.md), [R02-S026](https://github.com/tradewithmeai/project-bright/blob/41b3a17c1e49663e86810c3e3eada7cba2316c2d/apps/claude-remotion/remotion_lab/experiments/ai_top5_001/VERDICT.md). Classification: **Scoped**; claim origins: author_stated.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Project Bright static/still versus human-motion verdict and RAG author consecutive-transition/caption QC only. Neither cut was independently watched/listened; no universal score/quality pass threshold. Research read source reports and did not watch the Bright/RAG cuts or listen. Source-reported human verdict is not an independent observed success.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R08-F003: high documented boundary; medium author-reported outcomes; observation: First-party text/source read; no controlled production trial; R08-F005: high documented boundary; medium author-reported outcomes; observation: Read actual v1/v3QC source; source-reported differences, no media playback.
## P36 — Verify the encoded artifact independently of preview or build
- **When-to-use:** Delivery requires an encoded file, while only editor preview or successful build may currently exist.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** For these reported Motion Canvas export incidents, inspect the encoded file for reported missing frames and selected-range duration/end/seek behavior independently of the editor preview.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Retain preview/build evidence as separate from measured exported properties. The historical selected-range and missing-frame incidents are version-specific examples of what preview cannot prove.
- **Evidence:** R08-F004 → [R06-S009](https://github.com/motion-canvas/motion-canvas/issues/1204), [R06-S011](https://github.com/motion-canvas/motion-canvas/issues/1052). Classification: **Scoped**; claim origins: author_stated.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Historical Motion Canvas export reports #1052 (3.10-era selected-range duration/seek) and #1204 (3.18 alpha missing frames) only. Export-specific reported failures do not establish current stable defects or every programmatic-video probe procedure. Issues #1052 at 3.10-era and #1204 at 3.18 alpha are not assertions of current stable defects; no own matched preview/export reproduction.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R08-F004: high documented boundary; medium author-reported outcomes; observation: First-party text/source read; no controlled production trial.
## P37 — Determine Remotion production eligibility under its pinned license
- **When-to-use:** The intended production use is evaluated under pinned v4 eligibility; individual/nonprofit/for-profit with at most three employees/noncommercial-evaluation conditions differ from other for-profit uses.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Establish the intended subject/use and applicable v4 license before production. Source-defined eligible uses can use the free tier; a for-profit outside that group requires the Company License. Do not infer production eligibility from a noncommercial smoke test.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Record the exact package license and subject/use basis; retain server/client telemetry differences separately and treat announced v5 requirements as upcoming, not v4 terms.
Remotion 4.0.534 telemetry profile: server telemetry is tied to licenseKey and successful renders; browser sends completed/failed render telemetry regardless of key, excluding aborted renders. v5 mandatory Automators key/telemetry is announced upcoming and is not substituted for the pinned v4 software terms. Hosted-service, Mediabunny/encoder MPL-2.0 and media permissions remain separate scopes.
- **Evidence:** R05-F005, R08-F001 → [R05-S001](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/LICENSE.md), [R05-S017](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/telemetry.mdx), [R05-S025](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/license/faq.mdx), [R05-S039](https://registry.npmjs.org/mediabunny/1.56.1), [R05-S040](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/terms.mdx), [R05-S041](https://www.remotion.pro/terms-4-0), [R08-S002](https://www.remotion.pro/terms-4-0). Classification: **General**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Remotion 4.0.534 software LICENSE at 4d9ff70e, current v4 terms, exact subject/use eligibility and v4 server/browser telemetry. Upcoming v5, hosted services, codecs and media permissions remain separate; no user eligibility/purchase inferred. User company/production eligibility unknown and no purchase authorized. No legal clearance, paid service or media/font/music rights follow from evaluation permission.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R05-F005: high_for_documented_contract; limited_runtime_validation; observation: Pinned LICENSE,FAQ,telemetry read; synthetic evaluation only; R08-F001: high documented boundary; medium author-reported outcomes; observation: First-party text/source read; no controlled production trial.
Admitted engine profile bindings (do not mix adapters):
- Remotion 4.0.534 telemetry profile: server telemetry is tied to licenseKey and successful renders; browser sends completed/failed render telemetry regardless of key, excluding aborted renders. v5 mandatory Automators key/telemetry is announced upcoming and is not substituted for the pinned v4 software terms. Hosted-service, Mediabunny/encoder MPL-2.0 and media permissions remain separate scopes.
Scope: Exact Remotion 4.0.534/license/current v4 terms; no user production eligibility or service purchase inferred. Sources: R05-S001, R05-S017, R05-S025, R05-S039, R05-S040, R05-S041, R08-S002.
Actual observation: License/FAQ/telemetry/package text read; noncommercial synthetic evaluation only..
## P38 — Keep asset permissions separate from repository and engine permissions
- **When-to-use:** Music, fonts or other assets are present in a public code project or proposed for an advertisement.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Retain each asset’s own permission and intended-use scope; repository/public inclusion does not transfer third-party rights. Record unknown music rights as unresolved rather than cleared.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R08-F002 → [R03-S021](https://github.com/nateherkai/hyperframes-student-kit/blob/0d30152a82b9ceb93cfdd9bdbf46f0d5ab3cde86/THIRD_PARTY_NOTICES.md), [R03-S027](https://github.com/nateherkai/hyperframes-student-kit/blob/0d30152a82b9ceb93cfdd9bdbf46f0d5ab3cde86/video-projects/aisoc-app-release/STORYBOARD.md), [R08-S017](https://github.com/lemomo-ai/lemo-opuscar/blob/4d7014aa7ba7d22c00513052dd996a4f200d5102/LICENSE). Classification: **General**; claim origins: author_stated.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Lemo and Student Kit explicit independent asset-rights declarations at recorded revisions, for third-party assets in those source-derived workflows/intended uses. Public availability/repository license is not the individual asset grant; unresolved AIS music remains unresolved. No matched authorized/unknown replacement experiment or validated substitution was acquired. Applicable user constraint C independently prohibits distributing unlicensed assets.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R08-F002: high documented boundary; medium author-reported outcomes; observation: First-party text/source read; no controlled production trial.
## P39 — Freeze revision identity and binary rights instead of relying on a version label
- **When-to-use:** A manifest version is the same while source revision, exporter dependencies or license path differ.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Record release commit/gitHead, installed lock/tree and actual license paths. Keep released MIT wrapper and main GPLv3 exporter metadata separate, and inspect the actual FFmpeg binary’s terms/build rather than inherit the wrapper license.
- **Output:** The action result only within this card’s scope; no successful video is implied. Admitted verification: Compare the installed release and selected source revision; the locally inspected bundled FFmpeg reports nonfree parts and no redistribution permission, so it remains outside distribution.
Exact binary observation: installed Motion Canvas @ffmpeg-installer/darwin-arm64@4.1.5 contains FFmpeg 4.4 with --enable-gpl --enable-libx264 --enable-version3 --enable-nonfree. Its -L reports nonfree parts and says the binary is not legally redistributable. Keep this cached binary and installed dependency tree excluded from runtime distribution; a wrapper MIT notice does not grant binary rights.
- **Evidence:** R08-F006 → [R06-S018](https://ffmpeg.org/legal.html), [R06-S019](https://github.com/motion-canvas/motion-canvas/blob/7b91435c301d530351dcf5ebb91dd139c002e405/packages/ffmpeg/package.json), [R08-S006](https://github.com/motion-canvas/motion-canvas/blob/e735a995aa738ca682feb4204a39ee7db7b5d279/packages/ffmpeg/package.json). Classification: **Scoped**; claim origins: documented_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Motion Canvas npm 3.17.2 release e735a995 versus main 7b91435c exporter/license metadata, plus exact locally inspected @ffmpeg-installer/darwin-arm64@4.1.5 FFmpeg 4.4 binary. The nonredistributable observation applies to this build only. Version/license provenance contract, no broad relicense conclusion. The cached binary’s observation is exact-build-specific; no dependencies/binaries are bundled into runtime.
- **Confidence:** {"admission_basis": "source_local_case_or_profile", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R08-F006: high documented boundary; medium author-reported outcomes; observation: First-party text/source read; no controlled production trial.
Admitted engine profile bindings (do not mix adapters):
- Exact binary observation: installed Motion Canvas @ffmpeg-installer/darwin-arm64@4.1.5 contains FFmpeg 4.4 with --enable-gpl --enable-libx264 --enable-version3 --enable-nonfree. Its -L reports nonfree parts and says the binary is not legally redistributable. Keep this cached binary and installed dependency tree excluded from runtime distribution; a wrapper MIT notice does not grant binary rights.
Scope: Exact locally probed installer/binary build only, separate from current main exporter and system FFmpeg. Sources: R06-S018, R08-S006, R06-S019.
Actual observation: Actual binary version/license probes executed and retained under engine-validation/motion-canvas; no media encoding ran..
## P40 — Translate audio and caption timing through the selected engine’s declared units
- **When-to-use:** Measured voiced tables are being consumed by the chosen Remotion implementation rather than their source workflow.
- **Inputs:** The recorded context and declared engine/profile, when present; use C03 director-plan fields as an authored envelope. No separate empirical input schema was admitted.
- **Action:** Retain each timing field’s unit and index/range convention when translating the voiced plan. Remotion composition/audio timing uses frames while Caption timing uses milliseconds; RAG generated tables use their own inclusive one-based frame convention and cannot be passed directly as zero-based Remotion intervals.
Remotion 4.0.534 media profile: import {Audio} from "@remotion/media" and use staticFile for local authorized assets. Audio from, trimBefore and durationInFrames are frame counts; durationInFrames selects source frames and occupies durationInFrames/playbackRate parent frames. Caption from @remotion/captions has text, startMs/endMs, timestampMs:number|null and confidence:number|null; preserve whitespace in text. Caption data is plain data, not automatic transcription. The RAG workflow’s one-based inclusive generated frames are an upstream convention to translate, not Remotion API indices.
- **Output:** The action result only within this card’s scope; no successful video is implied. Verification component is unsupported/empty; keep any package C06 check separately attributed.
- **Evidence:** R05-F004, R07-F002 → [R02-S001](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/README.md), [R02-S009](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/reference/narration-storyboard.md), [R02-S010](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/template/scripts/tts_build.py), [R05-S005](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/use-current-frame.mdx), [R05-S006](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/composition.mdx), [R05-S007](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/sequence.mdx), [R05-S008](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/interpolate.mdx), [R05-S009](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/spring.mdx), [R05-S012](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/media/audio.mdx), [R05-S013](https://github.com/remotion-dev/remotion/blob/4d9ff70e1f489cd671045d8a2e944e4b8853c63d/packages/docs/docs/captions/caption.mdx), [R07-S017](https://github.com/Vincentwei1021/anything2explainer/blob/735c79c8724e897e8971cd59dde7e5aa11e4d6ce/template/src/common/Subtitle.tsx). Classification: **General**; claim origins: documented_contract, documented_workflow_contract.
- **Failure Mode:** Recovery component is unsupported/empty. Do not invent a source-derived fix; C06 acceptance repair is a separate authored action.
- **Boundary:** **Exact sigma:** Typed translation between Remotion 4.0.534 Audio/Caption/frame contracts at 4d9ff70e and Anything2Explainer 735c79c8 generated one-based inclusive frame tables. Does not establish actual audio alignment or audiovisual quality. This is a typed technical-contract translation, not evidence of speech alignment, language performance or a watched audiovisual result. Official Remotion audio/Caption details are explicit supplemental source bindings below.
- **Confidence:** {"admission_basis": "documented_technical_or_rights_contract", "empirical_quality": "待验证 / not_verified", "finding_confidence_preserved_in_evidence": true}. Findings: R05-F004: high_for_documented_contract; limited_runtime_validation; observation: ffprobe60frames/30fps/2s; sampled29/30/59 verify boundary/local reset in smoke only; R07-F002: high for documented contract; medium for author historical accounts; perception unverified; observation: Read empty template and synthesis code; no TTS/provider invoked; RAG historical output author-stated.
Admitted engine profile bindings (do not mix adapters):
- Remotion 4.0.534 media profile: import {Audio} from "@remotion/media" and use staticFile for local authorized assets. Audio from, trimBefore and durationInFrames are frame counts; durationInFrames selects source frames and occupies durationInFrames/playbackRate parent frames. Caption from @remotion/captions has text, startMs/endMs, timestampMs:number|null and confidence:number|null; preserve whitespace in text. Caption data is plain data, not automatic transcription. The RAG workflow’s one-based inclusive generated frames are an upstream convention to translate, not Remotion API indices.
Scope: Remotion 4.0.534 / 4d9ff70e audio and Caption contracts; RAG source 735c79c8 generated-data convention. Sources: R05-S012, R05-S013, R02-S001, R02-S010, R02-S009.
Actual observation: Official API docs, generated template and synthesis code read. No actual audio/caption render, transcription or listening executed..
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |