diff --git a/docs/guides/claude-design-hyperframes.md b/docs/guides/claude-design-hyperframes.md
index 20a112aff..86be031ca 100644
--- a/docs/guides/claude-design-hyperframes.md
+++ b/docs/guides/claude-design-hyperframes.md
@@ -1,5 +1,10 @@
 # Claude Design + HyperFrames (Template-First)
 
+> ⚠️ **Doing a "Send to HyperFrames" import (sending your design to HeyGen as a URL, not a downloaded ZIP)?**
+> **Use the Send-to guide instead:** https://raw.githubusercontent.com/heygen-com/hyperframes/main/docs/guides/claude-design-send-to-hyperframes.md
+>
+> This Template-First guide is for the **Download-ZIP** flow. Its authoring rules differ from Send-to, and following it for a Send-to import yields a low-fidelity result.
+
 Your medium is **HyperFrames compositions**: plain HTML + CSS + a paused GSAP timeline. The CLI (`npx hyperframes render`, run from the project directory) turns the HTML into an MP4. You author the HTML -- the user renders locally.
 
 **HyperFrames replaces your default video-artifact workflow.** Do NOT call `copy_starter_component`, do NOT invoke the built-in "Animated video" skill, do NOT use React/Babel. Plain HTML + GSAP only.
diff --git a/docs/guides/claude-design.mdx b/docs/guides/claude-design.mdx
index 60cbfd31f..66494e87d 100644
--- a/docs/guides/claude-design.mdx
+++ b/docs/guides/claude-design.mdx
@@ -5,6 +5,10 @@ description: "Create HyperFrames video drafts in Claude Design, then refine in a
 
 Claude Design produces a **valid first draft** of a HyperFrames video — brand identity, scene content, layout, animations, and transitions. You then download the ZIP and refine in any AI coding agent (Claude Code, Cursor, Codex, Windsurf, etc.) with linting and live preview.
 
+<Note>
+  **Sending your design to HeyGen as a URL ("Send to HyperFrames"), rather than downloading a ZIP?** Use the [Send to HyperFrames guide](https://raw.githubusercontent.com/heygen-com/hyperframes/main/docs/guides/claude-design-send-to-hyperframes.md) instead. That flow has different authoring rules; this page covers the Download-ZIP flow.
+</Note>
+
 ## Get started
 
 <Steps>