Keep CLAUDE.md under about 200 lines and write only what Claude cannot learn from the repo.
Exact test and lint commands, misleading code areas, decisions made outside the repo, anything you corrected twice.
The habits that make the difference. Tick the ones you already keep and see what is left.
Exact test and lint commands, misleading code areas, decisions made outside the repo, anything you corrected twice.
"Use 2-space indentation" can be checked; "format nicely" cannot.
Shouting rarely helps. Either the file is too long, or the rule has no exceptions and belongs in a hook.
.claude/rules/.They load only when needed, so CLAUDE.md stays short.