claude_settings/plans/refactored-sparking-glacier.md

Plan: Cleanup + Wiki-Prinzip + Parallele Agenten

Aufgabe 1: Backup-Verzeichnisse auf srvdocker02 bereinigen

SSH: ssh root@10.0.0.48

Folgende Verzeichnisse/Dateien löschen:

rm -rf /home/icke/unifi_backup/
rm -rf /home/icke/unifi_data/data/db_backup_v8024/
rm -rf /home/icke/unifi_old_20260129/
rm -rf /home/icke/unifi_pre_restore_backup_20260129_075336/
rm -f /home/icke/compose_files/unifi.yml.migrated_to_unifi_dir

Vorher du -sh zur Bestätigung, nachher df -h zur Verifikation.

---

Aufgabe 2: Globale Regeln in CLAUDE.md ergänzen

Datei: ~/dotfiles/claude_settings/CLAUDE.md

2a: Wiki-Prinzip (neue Sektion)

Einfügen nach dem Abschnitt "Dokumentations-Verifikation (PFLICHT)", vor "Rolling Documentation":

### Wiki-Prinzip: Verlinkte Dokumentation (PFLICHT)

**JEDE Erwähnung eines Hosts, Dienstes oder Systems in der Dokumentation MUSS als Markdown-Link auf dessen Dokumentation verweisen.**

Dies gilt für ALLE Dokumentation - nicht nur Netzwerk, sondern auch Host-Dateien, Dependencies, Hardware, README, etc.

#### Regeln

1. **Host-Referenzen** → Link auf `hosts/[hostname].md`
   - Aus `hosts/`-Dateien: relativer Pfad `[srvdocker02](srvdocker02.md)`
   - Aus Root-Dateien: `[srvdocker02](hosts/srvdocker02.md)`
   - Aus Unterverzeichnissen: `[srvdocker02](../hosts/srvdocker02.md)`

2. **Hardware-Referenzen** → Link auf `hardware/[gerät].md`
   - `[HPE Switch](hardware/hpe-switch.md)` oder relativ `[HPE Switch](../hardware/hpe-switch.md)`

3. **Dienst-/System-Referenzen** → Link auf zugehörige Doku
   - Externe Repos: `[Zabbix](https://gitea.egonetix.de/Egonetix/zabbix)`
   - Interne Doku: `[Keycloak SSO](keycloak-sso.md)`

4. **Mermaid-Diagramme:** Hier sind keine Markdown-Links möglich. Stattdessen MUSS nach jedem Diagramm eine Referenz-Tabelle stehen mit Links zu den referenzierten Hosts/Diensten.

5. **Tabellen:** Host-/Dienstnamen in Tabellenzellen als Link formatieren.

#### Ausnahmen

- Derselbe Host innerhalb seiner eigenen Dokumentation (kein Self-Link)
- Hosts in der "Entdeckte aber nicht gescannte Hosts"-Liste (keine Doku vorhanden)
- Inline-Code-Blöcke (Befehle, Konfigurationen)

#### Beispiel

**Falsch:**

srvdocker02 benötigt srvdc01 für DNS. PBS auf Hetzner Storage Box (1TB)

**Richtig:**

srvdocker02 benötigt srvdc01 für DNS. PBS auf Hetzner Storage Box (1TB) - siehe srvhost04 Storage

2b: Parallele Agenten (neue Sektion)

Einfügen im Bereich "Effizienz" oder als eigene Sektion nach "Rolling Documentation":

### Parallele Agenten-Nutzung (PFLICHT)

**Claude MUSS eigenständig entscheiden, wie viele Agenten parallel gestartet werden, um Aufgaben schneller zu erledigen.**

- Bis zu 10 oder mehr parallele Agenten sind erlaubt
- Claude entscheidet selbst, wie viele Agenten sinnvoll sind
- Unabhängige Teilaufgaben MÜSSEN parallel bearbeitet werden
- Dies gilt für: Host-Scans, Dokumentations-Updates, Verifikation, Recherche

**Beispiele:**
- 10 Host-Dateien aktualisieren → 10 Agenten parallel
- 5 unabhängige Recherche-Aufgaben → 5 Agenten parallel
- Scan + Dokumentation + Commit → sequentiell (abhängig)

2c: Commit & Push

cd ~/dotfiles/claude_settings
git add CLAUDE.md
git commit -m "Wiki-Prinzip und parallele Agenten als globale Regeln"
git push origin main

---

Aufgabe 3: Wiki-Prinzip retroaktiv auf bestehende Doku anwenden

Alle Markdown-Dateien im Infrastructure-Repo durchgehen und fehlende Links ergänzen. Parallele Agenten für unabhängige Dateien nutzen.

Bekannte Lücken (aus Exploration):

Datei	Fehlende Links
hosts/srvhost04.md	Abhängigkeiten-Sektion: gw-nue01, GW-NU-WAN01 nicht verlinkt; Impact-Tabelle: alle 8 Hosts nicht verlinkt
hosts/srvdocker02.md	Keine Links zu anderen Hosts/Diensten
dependencies.md	Nach Mermaid-Diagrammen fehlen Referenz-Tabellen; Text-Referenzen ohne Links
Alle hosts/*.md	Abhängigkeiten-Sektionen prüfen auf fehlende Links
hardware/*.md	Referenzen auf Hosts prüfen
README.md	Externe/VPN-Gegenstellen: gw-nu-wan01 schon verlinkt; Hardware-Tabelle prüfen

Vorgehen:

1. Alle 13 Host-Dateien + 4 Hardware-Dateien + dependencies.md + README.md + keycloak-sso.md + netzwerk/*.md parallel lesen
2. Fehlende Links identifizieren und ergänzen
3. Commit pro logischer Gruppe

Commit & Push

cd ~/Nextcloud/egonetix/infrastructure
git add -A
git commit -m "Wiki-Prinzip: Querverweise in gesamter Doku verlinkt"
git push origin main

---

Verifikation

1. Cleanup: df -h auf srvdocker02 zeigt freien Speicher
2. CLAUDE.md: Wiki-Prinzip und Parallele-Agenten Sektionen vorhanden, Settings-Repo gepusht
3. Wiki-Prinzip: Stichprobenartig 3-4 Dateien prüfen ob alle Host-/Dienst-Referenzen verlinkt sind
4. Pflicht-Checkliste: Dokumentations-Verifikation durchführen