// Create commit messages following Sentry conventions with conventional commits and issue references. Use when committing code changes, writing commit messages, or formatting git history with Fixes/Refs patterns.
| name | sentry-commit-messages |
| description | Create commit messages following Sentry conventions with conventional commits and issue references. Use when committing code changes, writing commit messages, or formatting git history with Fixes/Refs patterns. |
<type>(<scope>): <subject>
<body>
<footer>
Requirements:
| Type | Purpose |
|---|---|
feat | New feature |
fix | Bug fix |
ref | Refactoring (no behavior change) |
perf | Performance improvement |
docs | Documentation only |
test | Test additions or corrections |
build | Build system or dependencies |
ci | CI configuration |
chore | Maintenance tasks |
style | Code formatting (no logic change) |
meta | Repository metadata |
license | License changes |
When writing the subject line:
Explain what and why, not how:
Reference issues using these patterns:
Fixes GH-1234 # GitHub issue
Fixes #1234 # Shorthand GitHub
Fixes SENTRY-1234 # Sentry issue
Refs LINEAR-ABC-123 # Linear issue (no auto-close)
Fixes closes the issue when mergedRefs links without closingFor breaking changes, add ! after type/scope and include a footer:
feat(api)!: Remove deprecated v1 endpoints
BREAKING CHANGE: v1 endpoints no longer available
revert: feat(api): Add new endpoint
This reverts commit abc123def456.
Reason: Caused performance regression in production.
See examples.md for detailed commit examples across different scenarios.