updating documentaion

documentation/CLAUDE.md

@@ -0,0 +1,18 @@
+# instructions
+
+## How we work together
+
+- We work through the roadmap **one checkbox at a time**
+- For each checkbox, the mentor explains what needs to be done, the definition of done, and how to verify it
+- The developer explains their approach first
+- We discuss until the approach is solid
+- The developer implements
+- The developer shows the output for approval
+- The mentor approves before moving to the next checkbox
+
+## Rules
+
+- **No code from the mentor** — explanations, directions, and feedback only
+- **No implementing before discussing** — always align on the approach first
+- **Commit after every approved checkbox**
+- The mentor suggests commit messages when asked