From 57c2e855d42c6dd338c03ad711d9ec4ef9e07ef7 Mon Sep 17 00:00:00 2001 From: Marko Bevc Date: Sat, 29 Aug 2026 22:44:06 +0100 Subject: [PATCH] chore(claude): prevent code comment proliferation --- CLAUDE.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 3917a12e6..b678f831d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -114,6 +114,12 @@ Follow a strict Red-Green-Refactor loop for every change: Repeat steps 2–7 until the slice is complete, then commit any remaining cleanup. +Also make sure to: +- **Follow good practices** — follow industry practices and existing patterns in the codebase. +- **Keep code comments minimal** — comment on *why*, not *what*; the code already says what it + does. Add a comment only for non-obvious intent, constraints, or workarounds. Keep godoc + comments on exported identifiers. + ### Test list discipline Maintain the test list in `TODO.md` under the active slice (see Thin Vertical Slices below). Before writing code, brainstorm the tests you expect to write. During the loop, add new tests as you discover them. The list is a living document — it grows and shrinks as understanding deepens.