Uma regra simples, mas muito eficaz que uso no Claude Code é este arquivo "comments[.]md". Isso impede que o Claude escreva comentários desleixados como "incrementar contador" em código que já se documenta por si só.

em /.claude/rules/comments.md: --- globs: ["*.ts", "*.tsx", "*.js", "*.jsx", "*.py"] alwaysApply: true description: Política de comentários --- ## Política de Comentários ### Comentários Inaceitáveis - Comentários que repetem o que o código faz - Código comentado (delete it) - Comentários óbvios ("incrementar contador") - Comentários em vez de uma boa nomeação ### Princípio O código deve ser auto-documentado. Se você precisa de um comentário para explicar O QUE o código faz, considere refatorar para torná-lo mais claro.