# 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:
```bash
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":

```markdown
### 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](srvdocker02.md) benötigt [srvdc01](srvdc01.md) für DNS.
PBS auf Hetzner Storage Box (1TB) - siehe [srvhost04 Storage](srvhost04.md#hardware--storage)
```
```

### 2b: Parallele Agenten (neue Sektion)

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

```markdown
### 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

```bash
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

```bash
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