Commit Conventions

Conventional Commits style. The full list of types and common scopes used
across the project.

Commit Types

  • feat: New features, icons, components, user-facing additions
  • fix: Bug fixes, build errors, broken functionality
  • refactor: Code restructuring, modernization, architectural changes
  • security: Security updates, vulnerability fixes
  • deps: Package updates, dependency management
  • chore: Maintenance, build improvements, tooling
  • perf: Performance improvements, optimizations

Common Scopes

  • icons — Font Awesome related changes
  • build — Webpack, Babel, build system
  • deps — Package dependency updates
  • ui — User interface components
  • crm — CRM-specific functionality
  • www — WWW site functionality

Format

<type>(<scope>): <description>

<body>

<footer>

Examples

feat(icons): add 13 missing Font Awesome 7 icons
security(deps): update deprecated Babel plugins
refactor(quote-builder): modernize from FA6 CSS to FA7 HTML
fix(build): resolve webpack compilation errors

Coding conventions

Coding conventions live in the skills system, not here. See .agents/skills/ (also
linked from CLAUDE.md) for canonical guidance on Ruby/Rails patterns,
forms, view components, background jobs, etc.