commit

name	commit
description	Generates git commit messages following Conventional Commits 1.0.0 specification with semantic types (feat, fix, etc.), optional scope, and breaking change annotations. Use when committing code changes or creating commit messages. Triggers on phrases like 'commit', 'commit and push', 'make a commit', 'git commit', or when commit is part of a compound action (e.g., 'bump version and commit').

Conventional Commit Generator

Workflow

1. Run git status and git diff HEAD to analyze changes

2. Stage files: user-specified only, or git add -A for all

3. Commit using HEREDOC format:

   git commit -m "$(cat <<'EOF'
   <type>(<scope>): <description>
   EOF
   )"
   

4. Output: <hash> <subject>

DO NOT: Modify code, push (unless asked), amend without request

Format

<type>[scope][!]: <description>

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

Subject: Imperative mood ("Add" not "Added"), capitalize first letter, no period, ~50 chars (max 72)

Scope: Optional noun for affected area (e.g., auth, api, parser)

Breaking changes: Add exclamation mark before colon: feat(api)!: Remove deprecated endpoints

Issue references: Use footer: Closes #123 or Fixes #456

Body (when needed)

Add body for non-trivial changes. Explain what and why, not how. Wrap at 72 chars.