Просте, але дуже ефективне правило, яке я використовую в Claude Code, — це «коментарі[.]MD" у справі. Це не дозволяє Клоду писати незручні коментарі на кшталт «інкрементний рахунок» на вже самодокументованому коді.
У /.claude/rules/comments.md: --- Глоби: ["*.ts", "*.tsx", "*.js", "*.jsx", "*.py"] завждиЗастосовувати: true Опис: Політика коментарів --- ## Політика коментарів ### Неприйнятні коментарі - Коментарі, які повторюють те, що робить код - Код з коментарями (видалити) - Очевидні коментарі («лічильник інкрементів») - Коментарі замість правильних назв ### Принцип Код має самодокументуватися. Якщо вам потрібен коментар, щоб пояснити, ЩО робить код, розгляньте рефакторинг, щоб зробити це зрозумілішим.
3