Claude Code prüft Dokumentation einer 80-Komponenten React-Bibliothek: Echte Fehler gefunden, neuer Fehler eingeführt

Ein Entwickler, der eine große React-Komponentenbibliothek betreut, nutzte Claude Code, um die Dokumentation von 80 Komponenten in einer einzigen Sitzung zu prüfen. Die KI fand echte Fehler – veraltete Props, fehlende Randfälle und falsche Nutzungsbeispiele – führte aber auch neue Fehler ein, die eine manuelle Überprüfung erforderten.

Was funktioniert hat

• Identifizierte Props, die dokumentiert, aber im Quellcode nicht mehr vorhanden waren
• Erkannte fehlende Dokumentation für neue Props aus aktuellen Commits
• Fand inkonsistente Typdefinitionen zwischen JSDoc und tatsächlichen TypeScript-Typen

Was schiefgelaufen ist

• Claude erfand Props, die es nie gab (Halluzinationen)
• Aktualisierte Standardwerte für einige Props fälschlicherweise
• Entfernte gültige Dokumentationsabschnitte, die es als redundant erachtete
• Generierte Beispielcode, der nicht kompilierte

Der vollständige Bericht enthält die genauen verwendeten Prompts, die Sitzungsstruktur und eine Aufschlüsselung jedes falschen Positivs und jeder Halluzination. Der Autor empfiehlt, vor dem Übernehmen von KI-generierten Dokumentationsänderungen immer eine Diff-Überprüfung durchzuführen.