diff --git a/tests/README.md b/tests/README.md
new file mode 100644
index 0000000..84d2555
--- /dev/null
+++ b/tests/README.md
@@ -0,0 +1,12 @@
+This folder contains a minimal C++ test harness for starworld.
+
+Build target: stardust-tests
+
+What it checks:
+- Protocol signature stability: compares NLPacket::computeProtocolVersionSignature() against the expected value for the vendored Overte commit.
+- Domain discovery parsing: validates that JSON containing Vircadia- or Overte-style fields is parsed into host/port pairs correctly.
+
+Run:
+  ./build/stardust-tests
+
+Exit code 0 indicates PASS.