---
name: commit
description: Stage and commit changes with a clear, concise commit message.
argument-hint: [optional message hint]
allowed-tools: Bash(git *)
---

# Commit

Create a commit for the current changes.

## Steps

1. Run `git status` (without `-uall`) to see untracked and modified files.
2. Run `git diff` and `git diff --cached` to understand staged and unstaged changes.
3. Run `git log --oneline -5` to see recent commit style.
4. **Run `bin/test-confidence` to verify your changes don't break anything.** Opus analyzes your diff and runs the right tests. Wait for 99% confidence (green bar) before proceeding. If any test fails, fix it first.
5. **Run linters on changed files before staging:**
   - Ruby files: `bundle exec rubocop --force-exclusion -a <files>`
   - JS/TS files: `npm run lint-fast -- --max-warnings 0 --fix --no-warn-ignored <files>`
   - TypeScript type check: `npx tsc --noEmit` (required, catches type errors that eslint skips)
   - CSS/SCSS/JSON/MD files: `npx prettier --write <files>`
   - SVG files: `npx svgo --multipass <files>`
   - Fix any lint errors or type errors before proceeding. Do not commit code that fails linting or type checking.
6. Stage the relevant files by name — avoid `git add -A` or `git add .`.
7. Write a commit message and commit.

If `$ARGUMENTS` is provided, use it as a hint for the message.

## Commit message rules

- Use the imperative mood ("Add", "Fix", "Remove", not "Added", "Fixes", "Removed").
- Be concise: one short sentence, ideally under 50 characters.
- Do NOT use conventional commit prefixes (no `feat:`, `fix:`, `chore:`, etc.).
- Do NOT add any `Co-Authored-By` or similar trailers.
- Focus on **what** changed and **why**, not how.
- If a second line is needed for context, keep it brief.

## Examples of good messages

- `Prevent discount code from being cleared on edit`
- `Add integration test for offer code persistence`
- `Remove unused legacy export helper`
- `Fix thumbnail missing in upsell insert`

$ARGUMENTS