From 900f2a629752e1227adafdf322945b973e631ea8 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 27 Sep 2026 20:18:49 +0000 Subject: [PATCH 1/2] docs(agents): document Node 24 for cloud agents Co-authored-by: Adam Moussa --- AGENTS.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index cdbf8ef..ef7d0f1 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`. `cdk diff` and `cdk deploy` talk to live AWS accounts and are not part of this environment. From df4188ab83592ee46fb60d7f48c22b55b200e731 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 28 Sep 2026 01:12:53 +0000 Subject: [PATCH 2/2] 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 --- AGENTS.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index ef7d0f1..6af0e4f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -15,7 +15,7 @@ No Jira keys in branch names. ## Pull Requests -**Title:** `type(scope): description (DEV-123)` — every non-exempt PR ends with its Jira key. +**Title:** `type(scope): description (DEV-123)` when a Jira ticket already exists. Minor, docs, hygiene, and dependency changes omit the suffix. Do not create a ticket only to fill a title. **Body sections (in order):** Summary · Validation · Tests · Notes — use "None." when a section is empty. State verifiable facts only. Do not cite the handbook to justify changes. @@ -49,4 +49,4 @@ nvm use 24 export PATH="$(dirname "$(nvm which 24)"):$PATH" ``` -Canonical checks: `npm ci`, `npm run build`, `npx cdk synth`. `cdk diff` and `cdk deploy` talk to live AWS accounts and are not part of this environment. +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, whenever this VM can read those accounts. If credentials cannot reach an account, say that in Validation and leave the diff for a human reviewer. Do not `cdk deploy` from this environment.