From f7487ee2401371ca28487143ffcc4d46c0b87031 Mon Sep 17 00:00:00 2001
From: BreakPilot Dev <dev@breakpilot.app>
Date: Mon, 9 Feb 2026 00:22:38 -0800
Subject: [PATCH] docs(claude): Add two-machine setup documentation

- Clarify MacBook (client) vs Mac Mini (server) roles
- Add examples for correct SSH command execution
- Document browser testing workflow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .claude/CLAUDE.md | 43 ++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 38 insertions(+), 5 deletions(-)

diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index c9872bd..d8fe58d 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -1,24 +1,57 @@
 # BreakPilot PWA - Projekt-Kontext für Claude
 
-## SSH-Verbindung (WICHTIG - IMMER ZUERST LESEN)
+## Entwicklungsumgebung (WICHTIG - IMMER ZUERST LESEN)
+
+### Zwei-Rechner-Setup
+
+| Gerät | Rolle | Aufgaben |
+|-------|-------|----------|
+| **MacBook** | Client | Claude Terminal, Browser (Frontend-Tests) |
+| **Mac Mini** | Server | Docker, alle Services, Code-Ausführung, Tests, Git |
+
+**WICHTIG:** Die Entwicklung findet vollständig auf dem **Mac Mini** statt!
+- Alle Befehle (docker, git, tests, builds) per SSH auf dem Mac Mini ausführen
+- Das MacBook dient nur als Terminal und Browser für Frontend-Tests
+- Dateien werden auf dem Mac Mini bearbeitet, nicht lokal auf dem MacBook
+
+### SSH-Verbindung
 
 ```bash
 # Verbindung zum Mac Mini im lokalen Netzwerk
 ssh macmini
 
-# Projektverzeichnis
+# Projektverzeichnis auf Mac Mini
 cd /Users/benjaminadmin/Projekte/breakpilot-pwa
 
-# Oder direkt:
-ssh macmini "cd /Users/benjaminadmin/Projekte/breakpilot-pwa && <befehl>"
+# Oder direkt (BEVORZUGT für einzelne Befehle):
+ssh macmini "<befehl>"
 ```
 
 **Hostname:** `macmini` (im lokalen Netzwerk via Bonjour)
 **User:** `benjaminadmin`
 **Projekt:** `/Users/benjaminadmin/Projekte/breakpilot-pwa`
 
----
+### Beispiele für korrekte Befehlsausführung
 
+```bash
+# ✅ RICHTIG: Befehle auf Mac Mini ausführen
+ssh macmini "docker compose ps"
+ssh macmini "cd /Users/benjaminadmin/Projekte/breakpilot-pwa && git status"
+ssh macmini "cd /Users/benjaminadmin/Projekte/breakpilot-pwa/backend && source venv/bin/activate && pytest -v"
+
+# ❌ FALSCH: Lokale Befehle auf MacBook (Docker/Services laufen dort nicht!)
+docker compose ps
+pytest -v
+```
+
+### Browser-Tests (auf MacBook)
+
+Frontend im Browser testen via:
+- https://macmini/ (Studio)
+- https://macmini:3002/ (Admin)
+- https://macmini:3000/ (Website)
+
+---
 ## Kernprinzipien (IMMER BEACHTEN)
 
 ### 1. Open Source Policy