From fff87300f1313ada64d6b4b00f0ae0a943da42da Mon Sep 17 00:00:00 2001 From: James Date: Fri, 27 Mar 2026 22:22:47 +0000 Subject: [PATCH] fix(cli): point agents to docs CLI and llms.txt instead of guessing URLs The shared CLAUDE.md in scaffolded projects mentioned hyperframes.heygen.com alongside doc topic names, causing AI agents to guess incorrect URLs like /compositions instead of using the local `hyperframes docs` CLI command or the correct /concepts/compositions path. Now explicitly directs agents to use the CLI for quick reference and llms.txt for full doc URL discovery. --- packages/cli/src/templates/_shared/CLAUDE.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/packages/cli/src/templates/_shared/CLAUDE.md b/packages/cli/src/templates/_shared/CLAUDE.md index bffa11556..55bd046e0 100644 --- a/packages/cli/src/templates/_shared/CLAUDE.md +++ b/packages/cli/src/templates/_shared/CLAUDE.md @@ -25,9 +25,21 @@ npx hyperframes lint # validate compositions npx hyperframes docs # reference docs in terminal ``` -Available doc topics: `data-attributes`, `gsap`, `compositions`, `rendering`, `templates`, `troubleshooting` +## Documentation -Full docs: [hyperframes.heygen.com](https://hyperframes.heygen.com) +**For quick reference**, use the local CLI docs command (no network required): + +```bash +npx hyperframes docs +``` + +Topics: `data-attributes`, `gsap`, `compositions`, `rendering`, `templates`, `troubleshooting` + +**For full documentation**, discover pages via the machine-readable index — do NOT guess URLs: + +``` +https://hyperframes.heygen.com/llms.txt +``` ## Project Structure