diff --git a/roadmap.md b/roadmap.md
index 7fa46bfe..d47aa53a 100644
--- a/roadmap.md
+++ b/roadmap.md
@@ -1,5 +1,12 @@
 # roadmap.md
 
+Use this as a direction/scope doc, not as proof that every earlier slice is still unimplemented.
+
+Do not read this file end-to-end by default.
+Read only the relevant milestone/slice headings after checking the current code.
+
+Completed or partially completed historical slices may still be documented here for context.
+
 ## Overview
 
 This roadmap is organized as vertical slices.
diff --git a/testing.md b/testing.md
index 94a9d2f1..22bd4658 100644
--- a/testing.md
+++ b/testing.md
@@ -1,5 +1,10 @@
 # testing.md
 
+Use this as a selective testing-policy reference.
+
+Do not read this file end-to-end by default.
+Read only the sections relevant to the slice you are changing after inspecting the code paths involved.
+
 ## Philosophy
 
 This project is a tool and a runtime.