- Use Conventional Commits:
feat: ...fix: ...chore: ...docs: ...refactor: ...test: ...
- Scope is recommended when useful, e.g.
feat(api): add mcp auth guard.
- Keep commits small and single-purpose.
- Align commit message with why the change exists.
- Include:
- what changed
- why it changed
- test/verification evidence
- risk/rollback notes when relevant