Naming And Comments

Names and comments are the primary channel through which code communicates intent to the next engineer. Use when choosing an identifier ("what should I call this", "rename this", "is this name clear"), deciding whether to add a comment ("should I comment this", "does this need explaining"), or auditing existing prose ("clean up the comments", "too many comments", "comment slop"). Also fires when a name is hard to pick — that difficulty is a design smell, not a vocabulary problem (Ousterhout: Hard to Pick Name).

manutej Updated 63 repo stars
craft — senior-engineer guardrails against AI code slop

File contents

manutej/craft commit 77f2c7c6f8

Frequently asked questions

npx get-skill add manutej/naming-and-comments