Uma regra simples, mas muito eficaz, que uso no Claude Code é esta "comentários[.]MD". Isso impede que Claude escreva comentários slop como "contador de incrementos" em códigos já auto-documentados.
em /.claude/rules/comments.md: --- Globos: ["*.ts", "*.tsx", "*.js", "*.jsx", "*.py"] SempreAplice: verdade Descrição: 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) - Comentários óbvios ("contador de incremento") - Comentários em vez de bons nomes ### Princípio O código deve ser autodocumentado. Se precisar de um comentário para explicar O QUE o código faz, considere refatorar para deixar mais claro.
38