diff --git a/AGENTS.md b/AGENTS.md
index 485bb918c..26dbcf52c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -49,7 +49,7 @@ It captures practical rules that prevent avoidable CI and PR churn.
 1. Start from `main`.
 2. Create a branch prefixed with `codex/`.
 3. Implement scoped changes only.
-4. Run required checks: `npm run format`, `npm run lint`, and targeted tests.
+4. Run required checks: `npm run format`, `npm run lint`, `npm run check-compiles` when touching `packages/testcontainers` APIs consumed by modules, and targeted tests.
 5. Verify git diff only contains intended files.
 6. Never commit, push, or post on GitHub (issues, PRs, or comments) without first sharing the proposed diff/message and getting explicit user approval.
 7. Commit with focused message(s), using `git commit --no-verify`.
diff --git a/package.json b/package.json
index 5a7bd4175..aba208448 100644
--- a/package.json
+++ b/package.json
@@ -15,7 +15,7 @@
     "lint": "eslint --fix package.json \"packages/**/*.ts\"",
     "lint:ci": "eslint package.json \"${WORKSPACE_PATH}/**/*.ts\" --max-warnings=0",
     "update-deps": "npm-check-updates --workspaces --root -u",
-    "check-compiles": "npm run build --ignore-scripts --ws -- --project tsconfig.json --noEmit"
+    "check-compiles": "tsc -b packages/testcontainers packages/modules/*"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",