diff --git a/CLAUDE.md b/CLAUDE.md
index 1bfca86..27dc6a3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,5 +1,26 @@
 # MYP Project Development Guidelines
 
+## System Architecture
+- **Frontend**: 
+  - Located in `packages/reservation-platform`
+  - Runs on a Raspberry Pi connected to company network
+  - Has internet access on one interface
+  - Connected via LAN to an offline network
+  - Serves as the user interface
+  - Developed by another apprentice as part of IHK project work
+  
+- **Backend**:
+  - Located in `backend` directory
+  - Flask application running on a separate Raspberry Pi
+  - Connected only to the offline network
+  - Communicates with WiFi smart plugs
+  - Part of my IHK project work for digital networking qualification
+
+- **Printers/Smart Plugs**:
+  - Printers can only be controlled (on/off) via WiFi smart plugs
+  - No other control mechanisms available
+  - Smart plugs and printers are equivalent in the system context
+
 ## Build/Run Commands
 - Backend: `cd backend && source venv/bin/activate && python app.py`
 - Frontend: `cd packages/reservation-platform && pnpm dev`
@@ -22,4 +43,11 @@
   - Organize imports automatically with Biome
   - Use TypeScript types for all code
   - Use React hooks for state management
-  - Naming: camelCase for functions/variables, PascalCase for components
\ No newline at end of file
+  - Naming: camelCase for functions/variables, PascalCase for components
+
+## Work Guidelines
+- All changes must be committed to git
+- Work efficiently and cost-effectively
+- Don't repeatedly try the same solution if it doesn't work
+- Create and check notes when encountering issues
+- Clearly communicate if something is not possible so I can handle it manually
\ No newline at end of file