Dokumentation mit KI pflegen
KI kann READMEs und Kommentare erzeugen – und Dateien wie CLAUDE.md, AGENTS.md und llms.txt machen deine Doku für Agenten lesbar.
Doku schreiben lassen – und prüfen
KI ist gut darin, Dokumentation zu erzeugen: README-Abschnitte, Funktions-Kommentare, API-Beschreibungen. Die Claude-Code-Doku beschreibt dafür einen einfachen Ablauf: undokumentierte Stellen finden lassen, Doku generieren lassen, dann prüfen und nachschärfen. Der letzte Schritt ist Pflicht: Generierte Doku klingt immer überzeugend – auch wenn sie falsch ist. Lies sie, bevor du sie eincheckst.
Doku für Agenten: CLAUDE.md und AGENTS.md
Doku hat heute zwei Zielgruppen: Menschen und Agenten. CLAUDE.md ist eine Datei, die Claude Code zu Beginn jeder Session liest – mit Build-Kommandos, Stilregeln und Projekt-Eigenheiten. AGENTS.md ist ein offenes, tool-übergreifendes Format mit derselben Idee: eine „README für Agenten", die von über 20 Coding-Tools gelesen wird (Stand: Juli 2026).
Doku-Drift vermeiden
Doku veraltet, wenn der Code sich ändert und niemand die Doku anfasst. Falsche Doku ist schlimmer als keine – besonders für Agenten, die ihr vertrauen. Praktische Regel: Doku im selben Änderungspaket aktualisieren wie den Code, und die KI regelmäßig fragen: „Stimmt das README noch zum aktuellen Stand?"
llms.txt für KI-Leser
Wenn deine Doku eine Website ist, hilft eine /llms.txt-Datei: eine Markdown-Übersicht mit Links, damit KI-Systeme die Inhalte finden, ohne HTML mit Navigation und Werbung durchkämpfen zu müssen.
BEISPIEL
Prompt: „Finde alle Funktionen ohne JSDoc-Kommentar in src/auth/, generiere Kommentare im Stil der bestehenden, und markiere jede Stelle, bei der du dir über das Verhalten unsicher bist."
KURZ-QUIZ
Wofür ist eine llms.txt-Datei gedacht?
QUELLEN
- Claude Code Doku: Common Workflows (Handle documentation) ↗ code.claude.com
- Claude Code Doku: Best Practices (CLAUDE.md) ↗ code.claude.com
- AGENTS.md: Offizielle Seite ↗ agents.md
- llms.txt: Offizielle Spezifikation ↗ llmstxt.org