diff --git a/libs/permissions/permissionLogic/src/lib/referenceTests/readme.md b/libs/permissions/permissionLogic/src/lib/referenceTests/readme.md
new file mode 100644
index 0000000..3e951c8
--- /dev/null
+++ b/libs/permissions/permissionLogic/src/lib/referenceTests/readme.md
@@ -0,0 +1,2 @@
+These are mostly tests I've pulled from xstate's repo to show locally the functionality and expectations we have of the library, and how we're using it. 
+Tests are the best way to understand the functionality of any system as they relate the language of the specification with the behavior in the most immediately observable way.