diff --git a/harnesses/contexts/best-practices/v1/CLAUDE.md b/harnesses/contexts/best-practices/v1/CLAUDE.md
new file mode 100644
index 0000000..b9d8ef1
--- /dev/null
+++ b/harnesses/contexts/best-practices/v1/CLAUDE.md
@@ -0,0 +1,7 @@
+# Best Practices Library
+
+A library of cross-project best-practices docs is mounted at `/workspace/best-practices/`.
+
+- Start with `/workspace/best-practices/INDEX.md` — one line per topic saying when to read it.
+- Read ONLY the topic file(s) relevant to your current task (e.g. `test-driven-development.md` for coding against tests, `api-design.md` for HTTP API work, `scripting.md` for shell scripts).
+- Do not read the whole library; each file is 10-60KB. Pick from the index.
diff --git a/harnesses/contexts/best-practices/v1/harness.yaml b/harnesses/contexts/best-practices/v1/harness.yaml
index 3bcde96..c7f467c 100644
--- a/harnesses/contexts/best-practices/v1/harness.yaml
+++ b/harnesses/contexts/best-practices/v1/harness.yaml
@@ -6,5 +6,10 @@ requires: []
 provides: [best-practices]
 
 context_files:
+  # CLAUDE.md is a file target -> enters the context manifest (system prompt),
+  # pointing the agent at the mounted library below (directory targets are
+  # mount-only and never enter the prompt).
+  - source: ./CLAUDE.md
+    target: /opt/harness/context/best-practices/CLAUDE.md
   - source: ./best-practices/
     target: /workspace/best-practices/