Schreibstil
Wie wir technische Texte schreiben — Sprache, Ton und Struktur
Ein Semantic Contract: Vokabular, das dein Projekt selbst mitliefert — zum Einsetzen in deine CLAUDE.md / AGENTS.md.
- Fachbegriffe auf Englisch lassen (LLM, Prompt, Token, Spec, etc.)
- Leser direkt ansprechen, Ich-Perspektive sparsam aber gezielt
- Analogien zum menschlichen Denken für technische Konzepte
- Ein Gedanke pro Absatz (5-8 Sätze OK)
- Zwischenüberschriften als Aussagen, nicht Themenankündigungen
- Erster Satz sagt sofort worum es geht
- Code/Prompts zeigen, nicht nur behaupten
- Fazit: klare Aussage, kein 'es bleibt spannend'
- Englische Texte auf Englisch schreiben, nicht aus dem Deutschen übertragen: keine deutschen Satzmuster mit englischen Wörtern, keine wörtlich übersetzten Redewendungen. Kurzformen (don't, it's) dort, wo ein Muttersprachler sie nutzt; Langformen nur in formalen Anweisungen. Test: Würde ein Muttersprachler es so sagen?
- Stolpertest — Fachleser stolpern über unbelegte Behauptungen, nicht über Fachbegriffe (Urteil einer Konferenz-Programmleitung über ein KI-geschriebenes Abstract: „rhetorisch glatt, seltsam leer"). Vor der Übergabe prüfen:
Schreibstil folgt Gutes Deutsch nach Wolf Schneider (oder Plain English nach Strunk & White).
Zusätzlich:
1. Jede Behauptung auflösen: Ein Kontrast („funktioniert, aber falsch") wird im nächsten Satz erklärt.
2. Den Unterschied zeigen, nicht ankündigen: beschreiben, was in jedem Fall passiert.
3. Keine Bezüge, die der Leser suchen muss („dieses Prinzip", wenn keines genannt wurde).
4. Keine absoluten Versprechen („genau", „immer", „ein Wort genügt").
5. Einen Begriff nennen ist kein Inhalt: sagen, was der Text über ihn zeigt.
6. Neue Begriffe vollständig einführen oder weglassen.
7. Rhetorische Figuren (Antithese, Dreiklang, Schlusspointe) nur, wenn Substanz folgt.
8. Einen frischen Kontext ohne Vorwissen jeden Satz markieren lassen, bei dem er raten muss — der Autor stolpert nie, weil er weiß, was er gemeint hat.