Git Commit Writer

Write clear Conventional Commit messages from the actual git state. Prefer safe staging, precise scopes, and minimal commit bodies.

Workflow

1. Inspect the repository state before proposing a message.

   • Check git status --short.
   • Review staged diff first with git diff --cached.
   • If nothing is staged, inspect git diff and decide whether staging is required.
   • Do not assume all modified files belong in one commit.

2. Protect unrelated work.

   • Keep user changes that are unrelated to the requested task out of the commit.
   • If the worktree contains multiple concerns, recommend splitting commits.
   • If the requested commit scope is ambiguous, state the assumption before committing.

3. Infer the commit intent from behavior, not filenames alone.

   • feat: visible or functional capability added