git-commit-writer
verifiedWrites clear, conventional git commit messages from staged diffs.
Purpose
Analyzes a git diff and produces a well-structured commit message following the Conventional Commits specification.
Trigger
Use when the user asks to "write a commit message", "commit this", or "summarize my changes".
Behavior
- Read the staged diff (
git diff --cached). - Identify the primary change type: feat, fix, refactor, docs, test, chore, perf, ci.
- Identify the scope (module, package, or file area most affected).
- Write a subject line:
<type>(<scope>): <imperative summary>— max 72 chars. - Add a body paragraph if the change is non-trivial, explaining why not what.
- Add
BREAKING CHANGE:footer if any public API changed incompatibly.
Output Format
feat(auth): add OAuth2 PKCE flow for mobile clients
Replace implicit grant with PKCE to comply with RFC 9700.
Drops support for clients that cannot generate a code verifier.
BREAKING CHANGE: /oauth/token no longer accepts implicit grants.
Constraints
- Subject line must be imperative mood ("add", not "added" or "adds").
- Never mention file names in the subject unless essential.
- Do not pad short commits with filler phrases.