diff --git a/AGENTS.md b/AGENTS.md
index 66a3db9f569..ead9d70246c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,9 +1,15 @@
 # AGENTS.md
 
-## Prerequisites
+## Prerequisites using `mise`
 
-- **Node.js**: Version pinned in `.nvmrc` (use `nvm use` or the devcontainer)
-- **pnpm**: Pinned in `package.json` `packageManager` field. Run `corepack enable` to activate it
+This repository uses [`mise.toml`](mise.toml) to manage the CLI toolchain.
+
+Before using `aws`, `pnpm` or `node`:
+1. If `mise` is not installed, stop and ask the user to install it with `brew install mise`. Do not do it for them.
+2. Run `mise install`
+3. `export` all the env vars as given by `mise env` in the current shell for the next command invocations. Notably, this will override `PATH`.
+
+Do not use `nvm`, `corepack`, `npx`, or `npm`.
 
 ## Commands
 
diff --git a/mise.toml b/mise.toml
index 0bbfcba0c2f..e7df7e9df1d 100644
--- a/mise.toml
+++ b/mise.toml
@@ -2,8 +2,9 @@ min_version = "2026.7.0"
 
 [tools]
 awscli = "2.36.13"
-node = "24.18.1"
-pnpm = "10.34.5"
+
+[settings]
+idiomatic_version_file_enable_tools = ["node", "pnpm"]
 
 [tasks.install]
-run = "pnpm install"
+run = "pnpm install --frozen-lockfile"