KI-lesbare Spezifikationen erhöhen die Dokumentationsschuld und den Pflegeaufwand

Ein Praxisbericht warnt davor, dass die Erstellung von „KI-lesbaren“ Dokumentationen mit strukturierten MkDocs, semantischen Überschriften und Querverweisen die langfristige Wartungslast signifikant erhöht. Ohne strikte Verantwortlichkeiten und Aktualisierungsprozesse entstehen veraltete, irreführende Dokumente. In einem Experiment erforderte strukturierte MkDocs-Dokumentation etwa dreimal so viel Zeit pro Änderung wie einfache Markdown-Dateien. Ein dreiwöchiges Kundenprojekt zur Erstellung eines KI-optimierten Dokumentationssystems führte nach nur sechs Monaten zu veralteter Architektur und defekten Links. Das Kernproblem ist demnach die Anhäufung von Dokumentationsschulden sowie „Skelett-Implementierungen“ – gut strukturierte Artefakte ohne aktuelle Begründungen –, nicht aber das Parsen durch KI an sich. Als Gegenmaßnahme wird eine „Anti-Atrophie-Checkliste“ vorgeschlagen: explizite Dokumenten-Eigentümer, verpflichtende Updates im selben Pull Request, CI-Prüfungen auf Veraltung sowie regelmäßige Reviews. Langfristig wird eine stärkere Automatisierung der Dokumentengenerierung direkt aus dem Code gefordert, um einen drohenden Backlash zu verhindern.