Een eenvoudige maar zeer effectieve regel die ik gebruik in Claude Code is dit "comments[.]md" bestand. Het voorkomt dat Claude slordige opmerkingen schrijft zoals "verhoog teller" op al zelfdocumenterende code.
in /.claude/rules/comments.md: --- globs: ["*.ts", "*.tsx", "*.js", "*.jsx", "*.py"] alwaysApply: true description: Commentbeleid --- ## Commentbeleid ### Onacceptabele Reacties - Reacties die herhalen wat de code doet - Uitgecommentarieerde code (verwijder het) - Voor de hand liggende opmerkingen ("verhoog teller") - Opmerkingen in plaats van goede naamgeving ### Principe Code moet zelfdocumenterend zijn. Als je een opmerking nodig hebt om uit te leggen WAT de code doet, overweeg dan om te refactoren om het duidelijker te maken.
32