720 B
720 B
Commit messages must be 1-3 sentences — longer than 15 lines is a confession, not a commit
7. The Verbose-Commit-Message Pattern (kill it)
Symptom: Your commit message is 50 lines. It contains the root cause analysis, the alternatives you considered, the side effects you considered, the cross-references, the "what this doesn't fix", the "what to verify", and a personal essay. The commit message is longer than the diff it describes.
Rule: A commit message is a 1-3 sentence summary. The body is for non-obvious "why" details, not for re-stating what the diff shows. If your commit message is longer than 15 lines, you are writing a report, not a commit message. Save the report for docs/reports/.