---
name: git-commit
description: Rules for writing git commit messages in Conventional Commits format. Use when creating or reviewing a git commit message.
---

# Git commit message rules

Format: `<type>(scope): <description>`

## Type

- `feat` — new feature
- `fix` — bug fix
- `docs` — documentation
- `refactor` — refactoring without behavior change
- `test` — tests
- `chore` — routine tasks, dependencies
- `perf` — performance improvement
- `ci` — CI/CD configuration

## Scope

Optional. Based on the affected modules (`auth`, `api`, `deps`).

## Subject line

- Maximum 72 characters
- Start with an imperative verb (add, fix, update)
- No capital letter, no trailing period
- One line only

## Examples

- `feat(api): add /users/profile endpoint`
- `fix(auth): handle empty token in validation middleware`
- `refactor(core): extract validation logic to utils module`