Skip to content

fix(cli): tell scaffolded agents to run check and render directly, not via npm run - #7717

Open
sx4im wants to merge 1 commit into
heygen-com:mainfrom
sx4im:fix-7707-agents-template-npm-run-check
Open

sx4im wants to merge 1 commit into
heygen-com:mainfrom
sx4im:fix-7707-agents-template-npm-run-check

Conversation

@sx4im

@sx4im sx4im commented Nov 14, 2026

Copy link
Copy Markdown

The AGENTS.md and CLAUDE.md templates that hyperframes init scaffolds told coding agents to run npm run check and npm run render. The check reference says never to run check through npm run: a tool timeout's SIGTERM ends npm at once, while the command keeps running and saves its report, so the agent never sees the result.

This switches the scaffolded notes to npx hyperframes check and npx hyperframes render, with a one-line note saying why. The package.json scripts stay pinned, and init's printed next steps are unchanged (those are for a human at a terminal).

Verified: oxfmt --check passes on both templates; no test asserts the template text (init.test.ts only checks the printed next steps, which this does not touch).

Fixes #7707

The AGENTS.md/CLAUDE.md templates told coding agents to run
`npm run check` and `npm run render`, but the check reference says
never to run check through `npm run`: a tool timeout's SIGTERM ends
npm at once, while the command keeps running and saves its report.
Switch the scaffolded notes to `npx hyperframes check` /
`npx hyperframes render` and say why, matching the check docs.
`init`'s printed next steps are left alone: those are for a human
at a terminal.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

New-project AGENTS.md tells agents to run npm run check, which the check docs say never to do

1 participant