# Git Commit Formatter > **Purpose:** Analyze staged changes and generate a properly formatted conventional commit message. --- ## Invocation ``` /commit ``` Runs `git diff --cached --stat` and `git diff --cached` to analyze staged changes. --- ## Conventional Commit Format ``` (): [optional body] [optional footer] ``` ### Types | Type | When to use | |------|-------------| | `feat` | New feature or capability | | `fix` | Bug fix | | `refactor` | Code restructuring without behavior change | | `test` | Adding or updating tests | | `docs` | Documentation only | | `style` | Formatting, whitespace, semicolons | | `perf` | Performance improvement | | `ci` | CI/CD configuration | | `chore` | Dependencies, tooling, config | | `build` | Build system or external dependency changes | ### Scope Detection Infer scope from the changed files: - `components/auth/*` → `auth` - `api/skills/*` → `skills-api` - `lib/utils/*` → `utils` - Multiple unrelated areas → omit scope ### Description Rules - Imperative mood: "add" not "added" or "adds" - No period at the end - Under 72 characters - Focus on **why**, not **what** (the diff shows what) --- ## Body Guidelines Include a body when: - The change is not obvious from the description - Multiple files are modified for different reasons - Breaking changes need explanation Format: - Wrap at 72 characters - Separate from subject with blank line - Use bullet points for multiple changes --- ## Footer - `BREAKING CHANGE: ` — for breaking API changes - `Closes #123` — for issue references - `Co-Authored-By: Name ` — for pair programming --- ## Examples **Simple feature:** ``` feat(auth): add GitHub OAuth login flow ``` **Bug fix with context:** ``` fix(api): prevent duplicate skill submissions The content checksum was computed before sanitization, allowing whitespace-only differences to bypass dedup. Closes #47 ``` **Breaking change:** ``` refactor(skills)!: rename focus_pool to engagement_score BREAKING CHANGE: focus_pool column renamed to engagement_score. Run migration 20260301 before deploying. ``` ## Playground

Input: Raw description

i fixed the thing where users would
get logged out randomly after like
30 mins even though their session
should still be valid. also bumped
the session timeout from 1h to 8h

Output: Commit message

fix(auth): prevent premature session expiry

Sessions were invalidated after 30 min
due to a clock-skew bug in the JWT
expiry check (server UTC vs client
local time comparison).

Also extends session lifetime from 1h
to 8h to match UX expectations.

Fixes #247

─────────────────────
Type:    fix  |  Scope: auth
Breaking: no  |  Refs: #247