Git Commit Command

Create atomic git commits following Conventional Commits.

Flow

1. Check state: git status --porcelain

   • Empty → STOP, report "No changes to commit"
   • Merge conflict markers → STOP, report conflict

2. Verify .gitignore excludes: secrets/.env, build artifacts, OS files (.DS_Store), IDE configs

3. Stage: git add -A (or specific files for atomic commits)

4. Analyze: git diff --cached --stat and git diff --cached

   • If unrelated changes exist, split into separate commits via git reset HEAD <file>

5. Commit: Use Conventional Commits format

<type>(<scope>): <summary>

[body: what/why, wrap 72 chars]

[footer: BREAKING CHANGE: or Fixes #123]

Types: feat | fix | docs | style | refactor | perf | test | build | ci | chore

Summary rules: imperative mood (e.g., "add", "fix", "refactor"), lowercase, no period, max 72 chars

6. Confirm: git log -1 --oneline → report hash and summary

Output

Success: Committed: <hash> <type>(<scope>): <summary> Failure: explain why and required action