Hook Conventional Commits — enforce formato de commit con type(scope): description

Qué es#

Antes de cada git commit que Claude ejecute, este hook valida que el mensaje siga el formato Conventional Commits:

type(scope): description

Types soportados: feat, fix, docs, style, refactor, test, chore, ci, perf, build.

Si el mensaje no respeta el formato, el commit se bloquea. Hook event: PreToolUse.

Tabla resumen#

Cómo se instala#

npx claude-code-templates@latest --hook git/conventional-commits

Para Claude:

Instalé el hook git/conventional-commits. Probá: pedile a Claude que
commitee con mensaje "hice cambios" — debería bloquear. Después con
"feat(auth): agrega login OAuth" — debería pasar.

Qué podés hacer con esto#

Convention forzada en todo el repo#

Ya no importa si Claude tira un commit informal. El hook lo formatea o lo rechaza.

Changelog autogenerado#

Con commits conventional, herramientas como conventional-changelog arman el CHANGELOG automáticamente al release.

Semantic versioning automático#

feat: → minor bump. fix: → patch. BREAKING CHANGE: → major. Tu CI puede manejarlo.

Para teams nuevos en Convention#

Forzar el patrón es la forma más rápida de adoptar la convención.

Cuándo NO conviene#

Bajalo de la fuente#

• Ficha en aitmpl.com: Conventional Commits Hook — comando exacto.
• Config JSON: conventional-commits.json.
• Convention spec: conventionalcommits.org.

Recursos relacionados#

• Auto Git Add Hook — combo natural: stage automático + commit convencional.
• Console Log Cleaner Hook — otra red de seguridad para commits limpios.
• Claude Code Best Practices — buenas prácticas de git workflow.