diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index f9d435f2..e0b8441d 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -11,6 +11,17 @@ export default defineConfig({
     lastmodDateOnly: false,
   },
 
+  // Internal planning notes (docs/plan/*) and AI hand-off prompts
+  // aren't user-facing docs and contain raw Rust/pseudocode whose
+  // generics (Option<String>, Vec<SubjectGroup>, …) trip Vue's
+  // template parser ("Element is missing end tag" because <String>,
+  // <SubjectGroup>, etc. look like unclosed HTML tags). Keep them
+  // in-tree for engineering reference but skip them at site-build time.
+  srcExclude: [
+    "plan/**",
+    "**/*.prompt",
+  ],
+
   markdown: {
     image: {
       lazyLoading: true,