Article
Programmierer dokumentieren für Claude, aber nicht füreinander
Mark Dominus macht eine interessante Beobachtung: Entwickler, die für KI-Assistenten wie Claude detaillierte Projektübersichten schreiben, speichern diese oft nicht im Repository. Dabei könnten diese Dokumente zukünftigen Entwicklern wertvolle Einblicke geben.
Ein besseres System
Statt Laufzettel am Ende jedes Projekts wegzuwerfen, schlägt Dominus vor, Claude eine strukturierte Übersicht aus erster Hand erstellen zu lassen. Diese wird sorgfältig geprüft und ins Repository committet. Claudes Erklärungen entsprechen in etwa der Qualität, die er selbst hätte schreiben können - benötigen aber nur zehn Sekunden statt einer Stunde.
Der Review-Prozess
Wichtig: Nichts kommt ins Repository ohne sorgfältige Prüfung. Ein häufiger Fehler war, dass Claude früher erstellte Berichte als Vorlage verwendete und dabei versehentlich Passagen aus völlig anderen Projekten übernahm. Das wurde mit einem Hinweis in CLAUDE.md korrigiert.
Fazit
Wenn Sie Claude Notizen schreiben lassen, commitieren Sie sie. Ein Projekt-Summary am Ende kann zukünftigen Entwicklern Stunden ersparen - und niemand muss Stunde investieren, um es zu schreiben.