diff --git a/docs/fix-scope-parent-cycle.md b/archived/fix-scope-parent-cycle.md
similarity index 100%
rename from docs/fix-scope-parent-cycle.md
rename to archived/fix-scope-parent-cycle.md
diff --git a/docs/migrate_time_to_2_2.md b/archived/migrate_time_to_2_2.md
similarity index 100%
rename from docs/migrate_time_to_2_2.md
rename to archived/migrate_time_to_2_2.md
diff --git a/docs/wasm_generation_bug.md b/archived/wasm_generation_bug.md
similarity index 100%
rename from docs/wasm_generation_bug.md
rename to archived/wasm_generation_bug.md
diff --git a/docs/ai_language_reference.md b/docs/ai_language_reference.md
index 79c77ed..d4c8e6f 100644
--- a/docs/ai_language_reference.md
+++ b/docs/ai_language_reference.md
@@ -1,5 +1,7 @@
 # Lyng Language Reference for AI Agents (Current Compiler State)
 
+[//]: # (excludeFromIndex)
+
 Purpose: dense, implementation-first reference for generating valid Lyng code.
 
 Primary sources used: `lynglib/src/commonMain/kotlin/net/sergeych/lyng/{Parser,Token,Compiler,Script,TypeDecl}.kt`, `lynglib/stdlib/lyng/root.lyng`, tests in `lynglib/src/commonTest` and `lynglib/src/jvmTest`.
diff --git a/docs/ai_notes_wasm_generation_bug.md b/docs/ai_notes_wasm_generation_bug.md
index 7919636..a7f35b9 100644
--- a/docs/ai_notes_wasm_generation_bug.md
+++ b/docs/ai_notes_wasm_generation_bug.md
@@ -1,5 +1,7 @@
 # AI notes: avoid Kotlin/Wasm invalid IR with suspend lambdas
 
+[//]: # (excludeFromIndex)
+
 ## Do
 - Prefer explicit `object : Statement()` with `override suspend fun execute(...)` when building compiler statements.
 - Keep `Statement` objects non-lambda, especially in compiler hot paths like parsing/var declarations.
diff --git a/docs/ai_stdlib_reference.md b/docs/ai_stdlib_reference.md
index d699fa3..8f450fd 100644
--- a/docs/ai_stdlib_reference.md
+++ b/docs/ai_stdlib_reference.md
@@ -1,5 +1,7 @@
 # Lyng Stdlib Reference for AI Agents (Compact)
 
+[//]: # (excludeFromIndex)
+
 Purpose: fast overview of what is available by default and what must be imported.
 
 Sources: `lynglib/src/commonMain/kotlin/net/sergeych/lyng/Script.kt`, `lynglib/stdlib/lyng/root.lyng`, `lynglib/src/commonMain/kotlin/net/sergeych/lyng/stdlib_included/observable_lyng.kt`.
diff --git a/docs/embedding.md b/docs/embedding.md
index 9d3c6fb..e14a926 100644
--- a/docs/embedding.md
+++ b/docs/embedding.md
@@ -1,5 +1,7 @@
 # Embedding Lyng in your Kotlin project
 
+[//]: # (topMenu)
+
 Lyng is a tiny, embeddable, Kotlin‑first scripting language. This page shows, step by step, how to:
 
 - add Lyng to your build