diff --git a/CLAUDE.md b/CLAUDE.md
index 2805447..77ea9bd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -970,6 +970,17 @@ Die API gibt immer `type: plain` zurück, rendert aber trotzdem HTML.
 | Aufzählung | `• Text` (Unicode U+2022) | • Text |
 | Unter-Aufzählung | `◦ Text` (Unicode U+25E6) | ◦ Text |
 
+### Inhaltliche Anforderungen
+
+**Kommentare müssen genug Detail enthalten, um bei Problemen als Troubleshooting-Einstieg zu dienen.**
+
+- Bei jeder Erwähnung eines Dienstes/Protokolls die konkreten Verbindungsdaten angeben (Host, Port, Protokoll)
+- Nicht: "per SMTP verschickt" → Sondern: "per SMTP über smtp.mailbox.org:465 (SSL/TLS) verschickt"
+- Nicht: "IMAP-Abruf" → Sondern: "IMAP IDLE auf imap.mailbox.org:993 (TLS)"
+- Nicht: "auf dem Server" → Sondern: "auf srv-docker02 (/home/vinosadmin/n8n/)"
+- Pfade, IPs, Ports, Credentials-Quellen immer mit angeben
+- **Ziel:** Jemand der den Kommentar liest, weiß sofort wo er nachschauen muss wenn etwas nicht funktioniert
+
 ### Pitfalls
 
 - **Kommentare können NICHT gelöscht werden** — weder via API noch UI. Workaround: Inhalt durch `.` ersetzen