smart-commit

Smart Commit

Create atomic, well-documented commits following Conventional Commits.

Format

<type>(<scope>): <subject>

• type: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
• scope: Area of change (e.g., auth, api, config)
• subject: Imperative mood, max 100 chars, no period

For full type definitions, see CONVENTIONS.md. For message examples, see EXAMPLES.md.

Workflow

1. Check status using git status or MCP get_status
2. Review changes using git diff or MCP get_diff_summary
3. Stage files with git add <files> (never blind git add .)
4. Create commit using HEREDOC format:

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

[optional body]

Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"

5. Handle hook failures: If pre-commit modifies files, stage and amend (only if you authored the commit and it's not pushed)

Safety Rules

• NEVER skip hooks with --no-verify
• NEVER force push to main/master
• NEVER commit secrets (.env, credentials, keys)
• NEVER use git add . without reviewing changes first
• ASK user if commit scope or message is unclear
• SPLIT large changes into atomic commits

Quick Reference