Rule Git & Version Control

Commit the Why

Commit messages should explain why the change was made

gitcommitsdocumentation
CLAUDE.md

Commit messages should explain why the change was made, not what changed. The diff shows what changed. The message should provide context a future reader won’t have.

Copy this block into your CLAUDE.md or agent config file to enforce it in your workflow.

get crystl