diff --git a/doc/api/test.md b/doc/api/test.md
index e02eba7f182bf7..3d3872b5f4e663 100644
--- a/doc/api/test.md
+++ b/doc/api/test.md
@@ -1368,6 +1368,11 @@ machines or processes, ideal for large-scale executions across varied
 environments. It's incompatible with `watch` mode, tailored for rapid
 code iteration by automatically rerunning tests on file changes.
 
+**Note:** A number of Node's CLI flags will not function properly when used
+with `execArgv`, and users should avoid using it unless they have a deep
+understanding of its implications. In general, bug reports regarding this
+behavior will not be investigated.
+
 ```mjs
 import { tap } from 'node:test/reporters';
 import { run } from 'node:test';