From 4710c28db528b382a416701e4b75947e3b0db5a4 Mon Sep 17 00:00:00 2001
From: Mauricio Siu <siumauricio@icloud.com>
Date: Thu, 27 Aug 2026 01:15:17 -0600
Subject: [PATCH] docs: add CLAUDE.md code style notes

---
 CLAUDE.md | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 CLAUDE.md

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