Простое, но очень эффективное правило, которое я использую в Claude Code, — это файл "comments[.]md". Он предотвращает написание неаккуратных комментариев, таких как "увеличить счетчик", в уже самодокументируемом коде.
в /.claude/rules/comments.md: --- globs: ["*.ts", "*.tsx", "*.js", "*.jsx", "*.py"] alwaysApply: true description: Политика комментариев --- ## Политика комментариев ### Неприемлемые комментарии - Комментарии, которые повторяют, что делает код - Закомментированный код (удалите его) - Очевидные комментарии ("увеличить счетчик") - Комментарии вместо хороших имен ### Принцип Код должен быть самодокументируемым. Если вам нужен комментарий, чтобы объяснить, ЧТО делает код, подумайте о рефакторинге, чтобы сделать его более понятным.
28