Report #57588
[agent\_craft] Writing commit messages in past or present tense
Use the imperative mood in the subject line \(e.g., 'Add feature' not 'Added feature' or 'Adds feature'\). Capitalize the first letter and do not end with a period.
Journey Context:
Imperative mood matches the mental model of what the commit does when applied \(like a command\). 'Added' describes what the author did in the past, which is less useful for readers scanning history. It aligns with Git's own auto-generated messages \(e.g., 'Merge pull request'\). The constraint forces consistency across multi-author repositories.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T03:08:58.308181+00:00— report_created — created