This is an automated email from the ASF dual-hosted git repository.

jamesfredley pushed a commit to branch docs/agents-no-grouping-comments
in repository https://gitbox.apache.org/repos/asf/grails-core.git

commit 7556404b08aee0806db33fca1856729e5bdfee40
Author: James Fredley <[email protected]>
AuthorDate: Thu Feb 26 08:50:31 2026 -0500

    Add no-grouping-comments rule to AGENTS.md Groovy style guide
    
    Discourage section separator comments like '// --- Domain classes ---'
    in source files. These add visual noise without value and are a common
    AI-generated pattern.
    
    Assisted-by: Claude Code <[email protected]>
---
 AGENTS.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 7920fb98f7..4905df60ff 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -186,6 +186,10 @@ class MyService { }
 
 // DON'T: javax packages
 // import javax.servlet.*  ❌ → use jakarta.servlet.*
+
+// DON'T: Section separator or grouping comments
+// // --- Domain classes ---  ❌
+// // ===== Helpers =====     ❌
 ```
 
 ## Test Isolation

Reply via email to