promptgarten 🌱
🌍 EN
Guide●○○4 Min · +20 XP

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

VERWANDTE THEMEN

CLAUDE.md / AGENTS.md: Gedächtnis & Regeln für deinen Agenten ●●○Pattern: Kontext füttern statt vage fragen ●○○Claude Code: Der CLI-Agent von Anthropic ●●○