diff --git a/firmware/README.txt b/firmware/README.txt
new file mode 100644
index 0000000..88183d1
--- /dev/null
+++ b/firmware/README.txt
@@ -0,0 +1,14 @@
+Protospace lockout firmware
+===========================
+
+
+Code Structure
+==============
+
+- Declarations
+- State definitions
+- Initializations
+- State machines
+  - States
+    - State actions
+    - Conditions that change the state