diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000000000000000000000000000000000000..28f27031c3d69fe257c0161eefa4178090b61393
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,12 @@
+# Assembly - MSP430 Number Guessing Counter
+
+
+## Description
+Treats the MSP430 as a "number guesser" by counting up or down, towards the number.
+
+On button press, the MSP430 will either:
+* Flash lights for hitting the button on the number.
+* Continue counting in the same direction.
+* Reverse directions, if it has already passed the number.
+
+Blinking green light represents counting up, red for counting down.