| name | commit-message-helper |
| description | Helps write conventional commit messages following Hara Vital standards. Triggers on "commit", "ready to commit", "push". |
Commit Message Helper
Conventional Commit Format
<type>(<scope>): <description>
[optional body]
[optional footer]
Required: Type
| Type | When to use |
|---|
feat | New feature or user-facing change |
fix | Bug fix |
docs | Documentation only |
refactor | Code restructuring (no behavior change) |
style | Formatting, whitespace (no code change) |
test | Adding or updating tests |
chore | Build, tooling, dependencies |
perf | Performance improvement |
revert | Revert previous commit |
Optional: Scope
Use the area of the codebase affected:
| Scope | Files |
|---|
ui | app/components/, app/globals.css |
recommendations | app/r/[tracking_code]/ |
registration | app/profesionales/ |
profile | app/p/[slug]/ |
admin | app/admin/ |
api | app/api/ |
lib | lib/ |
tests | __tests__/ |
Rules
- Imperative mood: "add feature" not "added feature" or "adds feature"
- Lowercase: Start description with lowercase
- No period: Don't end the description with a period
- ≤ 72 characters: Keep the first line short
- Body for context: Use the body to explain why, not what
Examples
feat(recommendations): add swipe hint animation on first visit
fix(registration): validate WhatsApp number requires + prefix
refactor(ui): extract CardSkeleton into separate component
docs: update TODO.md with email feature requirements
chore: add test artifacts to .gitignore
perf(recommendations): lazy load BottomSheet component
Multi-line Example
feat(registration): add email confirmation on professional signup
Send confirmation email via Resend after successful DB insert.
Email includes review timeline and contact info.
Failures are logged but don't block registration.
Closes #12
