Commit
Create commits following the commit guidelines.
Instructions
When invoked, create a single git commit:
- •Review changes and recent commits
- •Draft message following conventional commit format
- •Stage files and create commit
Commit Message Rules
1. Use Conventional Commit Format
Rule: Use conventional commit prefixes like feat:, fix:, chore:,
docs:, refactor:, etc.
Scope: When adding, modifying, or deleting a specific plugin, use the plugin name as the scope.
Examples:
- •✅
feat(my-plugin): add new feature - •✅
fix(auth-plugin): fix token expiration - •✅
chore(my-plugin): update dependencies - •✅
docs: update README - •✅
refactor: improve error handling
2. Start with Lowercase
Rule: The message after the prefix should start with a lowercase letter.
Examples:
- •✅
feat(plugin): add new feature - •❌
feat(plugin): Add new feature
3. Keep Messages Concise
Rule: Commit messages should be clear and scannable.
Why: Short messages are easier to scan in git log.
Examples:
- •✅
feat(user-auth): add login endpoint - •✅
fix(payment): handle null amount - •❌
feat(user-auth): add a new user authentication endpoint with JWT support and validation(too long)
4. No Co-Author Attributions
Rule: Do NOT include Co-Authored-By: lines in commit messages.
Why: Attribution is handled at the PR level, not commit level.
Examples:
- •✅
chore: update database schema - •❌
chore: update database schema\n\nCo-Authored-By: Claude <noreply@anthropic.com>
5. No AI Agent Mentions
Rule: Do NOT mention AI tools or agents in commit messages.
Why: Commits should describe what changed, not how it was created.
Examples:
- •✅
refactor: refactor payment processing logic - •❌
refactor: refactor payment processing logic with Claude
6. Match Repository Style
Rule: Follow the style of recent commits in the repository.
How: Run git log --oneline -10 to see recent commit messages and match
their tone and format.
Message Guidelines
Focus on WHAT, not WHY or HOW
Good:
- •
feat(search): add product search API - •
fix(shipping): fix cost calculation - •
chore: remove deprecated endpoints
Bad:
- •
feat(search): add product search API to improve UX(includes why) - •
fix(shipping): fix cost calculation using new formula(includes how)
Use Imperative Mood
Good:
- •
feat(profile): add user profile page - •
fix(auth): fix login redirect bug - •
chore: remove unused imports
Bad:
- •
feat(profile): added user profile page(past tense) - •
fix(auth): fixes login redirect bug(present tense) - •
chore: removing unused imports(gerund)