From ac65a23d9f283af91dc9316300c9fb057bf151d2 Mon Sep 17 00:00:00 2001 From: Adam Moussa <166072409+amoussa1229@users.noreply.github.com> Date: Mon, 28 Sep 2026 18:12:07 +0000 Subject: [PATCH] docs(agents): document Node 24 for cloud agents (#157) * docs(agents): document Node 24 for cloud agents Co-authored-by: Adam Moussa * docs(agents): keep cdk diff required and exempt docs titles Cloud agents still review cdk diff when the VM can read the accounts. Docs, hygiene, and dependency pull requests omit a Jira suffix instead of opening a ticket only to fill the title. Co-authored-by: Adam Moussa * fix: address review comments --------- Co-authored-by: Cursor Agent Co-authored-by: Adam Moussa --- AGENTS.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index cdbf8ef..d819a7c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -37,3 +37,16 @@ explicit approval). Linting stays in CI; do not gate on it locally. **High-blast AWS org/IAM substrate.** This repo synthesises and diffs the organisation-level CDK stack. Always run `cdk synth` and review `cdk diff` output before raising a PR. + +## Cursor Cloud specific instructions + +CI pins Node 24. On this VM, `node` on `PATH` can resolve to an older binary under `/exec-daemon` ahead of nvm. Select Node 24 in the same shell before `npm` or `cdk`: + +```bash +export NVM_DIR="$HOME/.nvm" +. "$NVM_DIR/nvm.sh" +nvm use 24 +export PATH="$(dirname "$(nvm which 24)"):$PATH" +``` + +Canonical checks: `npm ci`, `npm run build`, `npx cdk synth`. Also run `cdk diff` for every stack this change touches and review the output before opening the PR. Do not `cdk deploy` from this environment.