diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..654dd27db
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,6 @@
+## Code style
+- Don't write comments that restate what the code already says.
+- Comment only the "why" when something isn't obvious: workarounds,
+  counterintuitive decisions, constraints from an external API.
+- No section-divider comments like `// --- Helpers ---`.
+- Don't leave comments describing the change you just made.
\ No newline at end of file