diff --git a/eslint.config.mjs b/eslint.config.mjs
index 2789644283..2714f66ac3 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -1,9 +1,6 @@
 import stylistic from '@stylistic/eslint-plugin'
 import tseslint from 'typescript-eslint'
 
-/**
- * ESLint flat config. Two layers.
- */
 export default tseslint.config(
   {
     ignores: [
diff --git a/vitest.config.ts b/vitest.config.ts
index b55b6b25d9..b4bfbbbef3 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -2,8 +2,8 @@ import tsconfigPaths from 'vite-tsconfig-paths'
 import { defineConfig } from 'vitest/config'
 
 export default defineConfig({
-  // Vite ≥8 warns that this plugin can be replaced by the native (experimental)
-  // `resolve.tsconfigPaths: true`.
+  // Native path resolution reads each package's nearest tsconfig, but only the root defines
+  // workspace paths. Keep this plugin pinned to the root map.
   plugins: [tsconfigPaths({ projects: ['./tsconfig.json'] })],
   test: {
     include: ['packages/*/*/tests/**/*.spec.ts', 'examples/*/tests/**/*.spec.ts'],