14 August 2026
Commit Conventions That Scale Down to a Team of One
Commit conventions are usually justified by what they do for a team: a consistent git log that a reviewer or a future teammate can scan. dev-hub has exactly one committer, and the convention stayed anyway — [Type] Brief description, title case, no body unless strictly necessary, no Co-Authored-By line.
Who the format is actually for
It turns out the primary reader of git log on a solo project is the same person, months later, who has fully forgotten the context. [Backend] Add Weekly PageView Retention Cleanup Job is scannable in a way that a vague "fix stuff" or an over-long paragraph explaining every implementation detail isn't — the tag alone answers "do I need to look at this" before the description is even read.
Why "no body unless strictly necessary" is the harder rule to keep
The tempting failure mode on a solo project is the opposite of a lazy commit message — it's an essay, because there's no reviewer to keep concise for and the temptation is to over-explain to future-self. The discipline is realizing that the code diff is the explanation; the commit message's job is only to say what changed and why it was worth a separate commit, which a well-chosen [Type] and a few words already does.
What no Co-Authored-By signals
An AI agent does a large share of the typing on this project, and the commit history still doesn't attribute lines to it. That's a deliberate call about what the git history is for — a record of what changed and why, not a record of which tool held the keyboard. The decision of what ships is the human's, made explicit by the rule that commits only get created "with explicit user permission" regardless of who drafted them.