Commit discipline

A commit message is the only part of a change that survives being skimmed months later, when nobody is going to re-read the diff. Its job is to say what happened precisely enough that the diff is optional.

This is a working rule about wording a commit, distinct from pr-discipline, which decides whether a set of changes belongs in one commit or several.

The default shape

One line. A conventional type prefix, a colon, then what changed in lowercase. No trailing period, no body.

feat: add microsoft oauth login
fix: correct model reference for scira codex
refactor: streamline sidebar state management
chore: bump deps

Roughly four in five commits look exactly like this, and the ones that do not are the exception rather than a second style.