From 9a7a6cd85a648011cb0a48447d76a67d4732e769 Mon Sep 17 00:00:00 2001 From: root Date: Thu, 29 Jan 2026 10:15:47 +0100 Subject: [PATCH] Wiki-Prinzip und parallele Agenten als globale Regeln --- CLAUDE.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 7f8fdaf..7b36dc6 100644 --- a/CLAUDE.md +++ b/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)