# homelab-brain

Externes Gedächtnis für das Orbitalo Homelab.  
Optimiert für KI-Assistenten — minimaler Kontext beim Start, Details nur bei Bedarf.

## Für KI-Assistenten

**Immer zuerst `.cursorrules` lesen** — dann nur den einen relevanten `STATE.md` Doc.  
Nie mehr als 1-2 Dateien gleichzeitig laden.

## Struktur

```
.cursorrules              ← Router (20 Zeilen) — immer zuerst lesen
MASTER_INDEX.md           ← Übersicht wenn Projekt unklar

infrastructure/STATE.md   ← Server, Container, alle IPs
arakava-news/STATE.md     ← WordPress + RSS Manager
edelmetall/STATE.md       ← Gold/Silber Dashboard
smart-home/STATE.md       ← ioBroker, Grafana, Backup
esp32/PLAN.md             ← Hardware-Projekte (statisch)

scripts/sync-state.sh     ← Auto-Sync (läuft täglich 03:00)
scripts/setup.sh          ← Einmalig einrichten
```

## Auto-Sync einrichten

```bash
ssh root@100.88.230.59
bash <(curl -s https://raw.githubusercontent.com/Orbitalo/homelab-brain/main/scripts/setup.sh)
```

Die `STATE.md` Dateien werden danach täglich automatisch aktualisiert.