Commit Commands

---
name: commit-commands
description: |
  Trigger on "commit", "push", "create PR", "git commit", or any git
  workflow request. Auto-generates commit messages from staged changes.
allowed-tools:
  - Bash(git *)
  - Bash(gh *)
  - Read
  - Grep
---

# Commit Commands

Git workflow automation: analyze diffs, generate conventional commit messages,
push, and create pull requests.

## Prerequisites

- Git repository initialized with a remote
- `gh` CLI installed for PR creation (optional)

## Steps

### Commit

1. Check what's staged:
   ```bash
   git status
   git diff --staged --stat
   ```

2. If nothing is staged, stage relevant files:
   ```bash
   git add <specific-files>
   ```
   Never use `git add -A` without user confirmation.

3. Read the staged diff to understand changes:
   ```bash
   git diff --staged
   ```

4. Generate a commit message following conventional commits:
   - Format: `type: short description`
   - Types: feat, fix, refactor, docs, test, chore, style, perf
   - Keep the subject line under 72 characters
   - Use lowercase, no period at end
   - Use imperative mood: "add" not "added"

5. Read recent commits to match project style:
   ```bash
   git log --oneline -10
   ```

6. Commit:
   ```bash
   git commit -m "type: description"
   ```

### Push

```bash
git push origin HEAD
```

### Create PR

1. Compare against base branch:
   ```bash
   git log main..HEAD --oneline
   git diff main...HEAD --stat
   ```

2. Create PR with gh:
   ```bash
   gh pr create --title "type: description" --body "## Summary\n- change 1\n- change 2"
   ```