From 59f51b2d72c0a9eefc06e9825ecff908f9dfdfb7 Mon Sep 17 00:00:00 2001
From: Mateo Wang <277851410+mateo-berri@users.noreply.github.com>
Date: Tue, 30 Jun 2026 10:46:47 -0700
Subject: [PATCH] chore: prevent CLAUDE.md comment bloat (#31729)

The existing comment rule is not strict enough
---
 CLAUDE.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index cea38b8527b..0cd1605b1b2 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,8 +1,7 @@
-Do not write comments unless they are absolutely necessary to explain some very complex business logic. Please clean up if there are comments that are not absolutely necessary. Do not remove comments that are unrelated to the addition of the code of this PR
-
-Explanation: code comments are, in a way, a violation of DRY code. You must update logic in two locations to change the code and "hard to change" is literally the definition of tech debt. We should instead aim to write code that is intuitive to the reader, while being both easy to maintain and high performance
+Do not write any comments (existing comments can stay) unless explicitly asked to in a user (not system) prompt
 
 Don't assume that the existing code is correct or the right way of doing things / good coding patterns. In fact, there are a lot of bad coding practices, overly complex code, code smells, etc. If something doesn't look right, speak up. Feel free to break existing patterns or question weird existing code to make new code high quality, as in:
+
 - correct
 - secure
 - performant