From 284a8f1a675237df72e9f967b1d39e3a37e1b870 Mon Sep 17 00:00:00 2001 From: root Date: Tue, 27 Jan 2026 13:46:29 +0100 Subject: [PATCH] CLAUDE.md: Dokumentations-Verifikation als Pflicht-Workflow MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Neuer Abschnitt "Dokumentations-Verifikation (PFLICHT)": - Erstvergleich mit Tabelle (Original vs. Neu) - Fehlende Inhalte ergänzen - Erneute Verifikation mit Zeilennummern - Finale Bestätigung erforderlich Verhindert Dokumentationsverlust bei Migrationen. Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 207b463..f6d6dc0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -327,6 +327,50 @@ cd [repo-name] # git push -u origin main ``` +### Dokumentations-Verifikation (PFLICHT) + +**Bei jeder Dokumentations-Migration oder -Erstellung MUSS eine zweistufige Verifikation durchgeführt werden:** + +#### Schritt 1: Erstvergleich + +Nach Erstellung/Migration der Dokumentation, erstelle eine Vergleichstabelle: + +```markdown +| Abschnitt (Original) | Neue Datei | Status | +|---------------------|------------|--------| +| [Abschnitt 1] | [datei.md:zeilen] | ✅/❌ | +| [Abschnitt 2] | [datei.md:zeilen] | ✅/❌ | +... +``` + +- Liste JEDEN Abschnitt der Quelldokumentation auf +- Prüfe ob er in der neuen Struktur vorhanden ist +- Markiere fehlende Abschnitte mit ❌ + +#### Schritt 2: Fehlende Inhalte ergänzen + +- Ergänze alle mit ❌ markierten Abschnitte +- Committe die Änderungen + +#### Schritt 3: Erneute Verifikation (PFLICHT) + +**Nach dem Ergänzen MUSS eine erneute, vollständige Prüfung erfolgen:** + +1. Lies alle neuen Dateien nochmals +2. Erstelle eine finale Checkliste mit Zeilennummern: + +```markdown +| # | Abschnitt | Datei:Zeilen | Status | +|---|-----------|--------------|--------| +| 1 | [Name] | README.md:15-18 | ✅ | +| 2 | [Name] | hosts.md:5-8 | ✅ | +... +``` + +3. Bestätige: **"X/X Abschnitte erfolgreich migriert. Keine Dokumentation wurde vergessen."** + +**Dieser Prozess ist nicht optional.** Dokumentationsverlust durch unvollständige Migration ist inakzeptabel. + ### Skills-Referenz | Skill | Zweck |