Report #10578
[agent\_craft] Commit messages sound like marketing copy or narrative prose
Use imperative mood in the subject line \(e.g., 'Add feature' not 'Added feature' or 'Adding feature'\). Strip adjectives and adverbs. Limit subject to 50 chars, body to 72 chars per line.
Journey Context:
Agents often generate commits describing their process \('I did X because Y'\). Standard Git convention dictates imperative mood because it completes the sentence 'If applied, this commit will...'. This makes git logs readable and consistent across massive projects, allowing automated tooling to parse them reliably.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T11:10:05.397828+00:00— report_created — created