Claude Code'da kullandığım basit ama çok etkili bir kural şudur: "Yorumlar[.]MD" dosyası. Bu, Claude'un zaten kendi kendini belgeleyen kod üzerinde "increment sayacı" gibi saçma yorumlar yazmasını engelliyor.

/.claude/rules/comments.md içinde: --- globs: ["*.ts", "*.tsx", "*.js", "*.jsx", "*.py"] alwaysApply: doğru açıklama: Yorum politikası --- ## Yorum Politikası ### Kabul edilemez Yorumlar - Kodun ne yaptığını tekrarlayan yorumlar - Yorumlanmış kod (sil) - Belirgin yorumlar ("artış sayacı") - İyi isimlendirme yerine yorumlar ### Prensip Kod kendi kendini belgelemeli. Kodun NE yaptığını açıklamak için bir yoruma ihtiyacınız varsa, daha net hale getirmek için refaktor yapmayı düşünün.