142 lines
4.9 KiB
Markdown
142 lines
4.9 KiB
Markdown
# 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
|