Una regla simple pero muy efectiva que utilizo en Claude Code es este archivo "comments[.]md". Evita que Claude escriba comentarios imprecisos como "incrementar contador" en código que ya se documenta por sí mismo.

en /.claude/rules/comments.md: --- globs: ["*.ts", "*.tsx", "*.js", "*.jsx", "*.py"] alwaysApply: true description: Política de comentarios --- ## Política de Comentarios ### Comentarios Inaceptables - Comentarios que repiten lo que hace el código - Código comentado (elimínalo) - Comentarios obvios ("incrementar contador") - Comentarios en lugar de buenos nombres ### Principio El código debe ser auto-documentado. Si necesitas un comentario para explicar QUÉ hace el código, considera refactorizar para hacerlo más claro.