diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f06334c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# rnes
+
+dime a dosen NES emulator, pretty much just me learining some Rust and testing some Agent/LLM workflows, if you want to add something it do so :3.
+
+> Branch rules here mirror other repos on this server so you would have to branch or fork to make an MR or PR 
+
+STATE.md is a file for the agent to keep track of itself, but also doubles as a technical overview of the whole project
\ No newline at end of file