diff --git a/.windsurf/workflows/repos.txt b/.windsurf/workflows/repos.txt
index 509a94de..97aaa5ff 100644
--- a/.windsurf/workflows/repos.txt
+++ b/.windsurf/workflows/repos.txt
@@ -29,7 +29,12 @@ learning_ai_auth_app
 learning_ai_productivity_web
 
 # --- OSS (subdirectory repos under oss/) ---
-oss/learning_ai_claw-code-oss
+# NOTE: oss/learning_ai_claw-code-oss is intentionally OMITTED. It is an
+# upstream Anthropic Claude Code OSS clone with its own CLAUDE.md convention
+# (auto-generated by Claude Code's bootstrap, not the deprecated ByteLyst
+# per-product CLAUDE.md pattern). We do not manage its agent docs; deleting
+# CLAUDE.md or forcing the ByteLyst canonical pointer block would diverge
+# from upstream alignment for no benefit.
 oss/learning_ai_claw-cowork
 
 # -- tooling --