semantic-commits

Workflow

Step 1 - Gather context

Run in parallel:

• git log --oneline -5 — recent commit style.
• git diff --cached --stat — staged files overview.

If no staged files, inform the user and stop.

Only read git diff --cached -- <file> for specific files when grouping is ambiguous from the stat alone. Do NOT read the full git diff --cached upfront.

Step 2 - Analyze and group

Group files by:

• Logical relationship: same feature/bug/purpose (e.g., controller + service + test).
• Module proximity: same module/directory changed for the same reason.
• Type of change: separate functional (feat, fix, refactor) from support (docs, chore, style, test, ci, build).