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'
Schreibstil folgt Gutes Deutsch nach Wolf Schneider (oder Plain English nach Strunk & White).
Zusätzlich: