Guide for creating well-structured git commit messages following Conventional Commits spec. Use when committing code changes, creating PRs, or reviewing commit history.
Standards for commit messages that enable automatic changelog generation and semantic versioning.
Use this skill when:
<type>(<scope>): <description>
[optional body]
[optional footer(s)]
| Type | Description | Example |
|---|---|---|
feat | New feature for the user | feat(dashboard): add ROAS chart |
fix | Bug fix | fix(orders): correct profit calculation |
docs | Documentation only | docs: update AGENTS.md |
style | Formatting, no code change | style: fix indentation in sidebar |
refactor | Code change, no new feature/fix | refactor(finance): extract currency util |
perf | Performance improvement | perf(charts): memoize expensive render |
test | Adding/updating tests | test(orders): add profit margin tests |
build | Build system/dependencies | build: update next.js to 16.1 |
ci | CI configuration | ci: add github actions workflow |
chore | Maintenance tasks | chore: clean up unused imports |
| Scope | Area |
|---|---|
dashboard | Main dashboard page |
finanzas | Finance/profit module |
logistica | Logistics/shipping module |
shopify | Shopify integration |
tiendanube | Tiendanube integration |
meta | Meta Ads integration |
supabase | Database/Supabase |
auth | Authentication |
ui | UI components |
charts | Chart components |
orders | Order management |
sync | Data synchronization |
feat(dashboard): add real-time profit ticker
- Shows True Profit updating every 30s
- Includes trend indicator (up/down)
- Animated number transitions
fix(orders): correct shipping cost calculation
The shipping cost was being doubled when platform
fee was applied. Now correctly calculates:
profit = revenue - costs - fees - shipping
Fixes #42
feat(api)!: change order response format
BREAKING CHANGE: Order totals now use cents instead
of decimal values for precision.
Migration: Divide all `totals.*` values by 100.
feat(shopify,tiendanube): unified order sync
Both platforms now use the same sync pipeline,
reducing code duplication by 60%.
git log --oneline -10
git commit --amend -m "fix(scope): new message"
git rebase -i HEAD~3
Before committing, verify:
feat, fix, etc.)! and BREAKING CHANGE:| Commit Type | Version Bump |
|---|---|
fix | PATCH (0.0.X) |
feat | MINOR (0.X.0) |
BREAKING CHANGE | MAJOR (X.0.0) |
❌ Don't:
update code
fixed stuff
WIP
asdf
changes
✅ Do:
feat(finanzas): add currency selector for multi-store
fix(sync): handle Shopify rate limit with exponential backoff
refactor(ui): extract Card component variants