Ich hatte das Problem, dass Analyse- und Berichtsdokumente von KI-Agenten zu ausschweifend und voller Fachjargon waren, sodass das Team sie nicht las („AI verbosity/slop“). Offenbar war das nicht nur mein Problem.
Ich hatte das Problem, dass Analyse- und Berichtsdokumente von KI-Agenten zu ausschweifend und voller Fachjargon waren, sodass das Team sie nicht las („AI verbosity/slop“). Offenbar war das nicht nur mein Problem.
Nicht die inhaltliche Tiefe war der Flaschenhals, sondern die Lesbarkeit. Deshalb habe ich die 10 Regeln, die ich immer wieder angewendet habe, als Agent-Skill zusammengefasst:
- Fazit (Kernaussage) in den ersten Satz
- Zentrale Konzepte mit einer Analogie einführen
- Fachbegriffe erklären oder weglassen, Formeln in Worte fassen
- Belege wie file:line als Fußnoten aus dem Fließtext auslagern
- Aufklappbare Darstellung (progressive disclosure): eingeklappt Zusammenfassung, aufgeklappt Details
- …insgesamt 10 Regeln + Checkliste + Abgrenzung „Wann man es nicht verwenden sollte“
Es ist für Claude Code gedacht, aber die Regeln selbst lassen sich unabhängig von Framework oder Sprache anwenden.
Wie geht ihr alle mit diesem Problem um? Lasst ihr es jedes Mal per Prompt erledigen, oder verankert ihr es als Skill-/Regeldatei?
Noch keine Kommentare.