diff --git a/tsconfig.json b/tsconfig.json
index 73f508f..8d26095 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -5,6 +5,8 @@
     "types": [
       "astro/client"
     ],
+    // baseUrl is intentionally omitted: under `moduleResolution: "bundler"` (set by
+    // astro/tsconfigs/strict), `paths` entries resolve relative to this tsconfig.json.
     "paths": {
       "@*": [
         "./src/*"