rust-optimizer/.claude/commands/commit.md

allowed-tools, description

allowed-tools	description
Bash(git add:*), Bash(git status:*), Bash(git commit:*), Bash(git diff:*), Bash(git log:*), Bash(git config:*), Bash(git branch:*)	Create a git commit

Context

• Current git status: !git status
• Current git diff (staged and unstaged changes): !git diff HEAD
• Current branch: !git branch --show-current
• Recent commits (for style reference): !git log --oneline -10
• Author commits (for style reference): !git log --author="$(git config user.email)" --oneline -10
• User input (optional): $ARGUMENTS

Your task

Based on the above changes, create a single git commit.

1. If there are no staged changes, stage only the relevant changed files by name (never use git add -A or git add .).
2. Do NOT commit files that likely contain secrets (.env, credentials.json, etc).
3. Write a commit message following the guidelines below, then commit.
4. Do NOT push to remote.

Commit message guidelines

• Use imperative mood (e.g., "add feature" not "added feature")
• First line: brief summary, max 72 characters
• Focus on the "why" and "what", not the "how"
• Be specific but concise
• Many commits do not need a body if the title is self-explanatory
  • Litmus test: "Would a developer understand this commit from the title + diff?" If yes, skip the body.
• Do NOT include "Generated with ...", "Co-Authored-By ...", or any AI attribution

Conventional commit prefixes

Match the prefix to the nature of the change. These must align with cliff.toml commit parsers so they appear correctly in the changelog.

Changelog: "Added"

• feat: / feat(scope): — new feature

Changelog: "Fixed"

• fix: / fix(scope): — bug fix

Changelog: "Changed"

• refactor: / refactor(scope): — code restructuring without behavior change
• perf: / perf(scope): — performance improvement
• docs: / docs(scope): — documentation changes (README, guides, etc.)
• style: / style(scope): — formatting only (no logic change)
• chore: / chore(scope): — tooling, deps, config, scripts, AI config (.claude/, CLAUDE.md)

Changelog: "Removed"

• revert: / revert(scope): — revert a previous commit

Excluded from changelog

• test: / test(scope): — adding or updating tests
• ci: / ci(scope): — CI/CD pipeline changes

Body rules

• When a body is needed (multiple important things in one commit), use bullet points.
• Body is separated from the title by a blank line.
• One bullet point per concept/change.
• Don't explain obvious things like "added unit tests for X".

Commit format

Always pass the commit message via a HEREDOC:

git commit -m "$(cat <<'EOF'
<title line>

<optional body>
EOF
)"