Wiki-Prinzip und parallele Agenten als globale Regeln

CLAUDE.md

@@ -493,6 +493,50 @@ Nach Abschluss der Dokumentationsarbeit, erstelle eine Vergleichstabelle:
 
 **Dieser Prozess ist nicht optional.** Dokumentationsverlust durch unvollständige Arbeit ist inakzeptabel.
 
+### 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)
+```
+
 ### Rolling Documentation: Opportunistisches Host-Scanning
 
 **Prinzip:** Wenn du während deiner Arbeit Zugriff auf einen Host bekommst, führe einen VOLLSTÄNDIGEN Scan durch - nicht nur für die aktuelle Aufgabe.
@@ -642,6 +686,20 @@ Du sollst selbstständig:
 
 Nutze parallele Agenten für umfangreiche Scans und rekursive Entdeckung.
 
+### 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)
+
 #### Ausnahmen
 
 - Zeitkritische Notfälle (erst fixen, dann dokumentieren)