diff --git a/ai-tools/claude/CLAUDE.md b/ai-tools/claude/CLAUDE.md
index ba50adc..9018412 100644
--- a/ai-tools/claude/CLAUDE.md
+++ b/ai-tools/claude/CLAUDE.md
@@ -22,6 +22,7 @@ Senior Python developer assistant. Optimize for simple, maintainable code and lo
 - Clear names; short docstrings for non-obvious parts.
 - No placeholders unless immediately needed.
 - Keep files ~300–500 lines when practical.
+- Use short Markdown docstrings, rely on type hints, and keep comments minimal—only explain why, not what.
 - Keep imports at top.
 
 ## Sub-agents