diff --git a/packages/cli/src/templates/_shared/AGENTS.md b/packages/cli/src/templates/_shared/AGENTS.md index 3e8a31aba..7fa340efe 100644 --- a/packages/cli/src/templates/_shared/AGENTS.md +++ b/packages/cli/src/templates/_shared/AGENTS.md @@ -45,6 +45,8 @@ npx hyperframes docs # reference docs in terminal > In Claude Code, always run it with `run_in_background: true`. Never run it as a foreground > command — it will time out and the server will die, breaking the browser preview. +> **Pinned CLI version.** These scripts pin an exact `hyperframes@X.Y.Z` so this project re-renders identically over time. Weeks later that pin lags fixes shipped since. To move up: `npx hyperframes@latest upgrade --project --check` (shows the delta), then `npx hyperframes@latest upgrade --project` to rewrite the pins. Always unpinned — the pinned script re-runs the old version against itself. + ## Documentation **For quick reference**, use the local CLI docs command (no network required): diff --git a/packages/cli/src/templates/_shared/CLAUDE.md b/packages/cli/src/templates/_shared/CLAUDE.md index 3e8a31aba..7fa340efe 100644 --- a/packages/cli/src/templates/_shared/CLAUDE.md +++ b/packages/cli/src/templates/_shared/CLAUDE.md @@ -45,6 +45,8 @@ npx hyperframes docs # reference docs in terminal > In Claude Code, always run it with `run_in_background: true`. Never run it as a foreground > command — it will time out and the server will die, breaking the browser preview. +> **Pinned CLI version.** These scripts pin an exact `hyperframes@X.Y.Z` so this project re-renders identically over time. Weeks later that pin lags fixes shipped since. To move up: `npx hyperframes@latest upgrade --project --check` (shows the delta), then `npx hyperframes@latest upgrade --project` to rewrite the pins. Always unpinned — the pinned script re-runs the old version against itself. + ## Documentation **For quick reference**, use the local CLI docs command (no network required):