name: conventional-commits description: Conventional Commits specification for standardized, semantic versioning-compatible commit messages trigger: commit OR git OR conventional commits OR changelog OR versioning scope: global

Conventional Commits

Estándar para mensajes de commit estructurados, legibles y compatibles con semantic versioning.

Formato Base

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Types (Obligatorio)

Scope (Opcional)

Componente o área afectada entre paréntesis:

• feat(auth): add JWT middleware
• fix(database): resolve connection pool leak
• chore(git): update .gitignore

Description (Obligatorio)

• Imperativo, tiempo presente: "add" no "added" ni "adds"
• Sin mayúscula inicial después de los dos puntos
• Sin punto final
• Máximo 72 caracteres

✅ Correcto

feat(api): add user profile endpoint
fix(ui): resolve mobile navbar overflow
chore(deps): update react to v18.3

❌ Incorrecto

feat(api): Added user profile endpoint.
FIX: navbar
update react

Body (Opcional)

Explicación detallada del cambio:

• Una línea en blanco después del description
• Usar para contexto, motivación, contraste con comportamiento previo
• Wrap a 72 caracteres

feat(parser): add support for multi-line strings

The parser now handles strings spanning multiple lines using
the triple-quote syntax, similar to Python. This was needed
to support large text blocks in configuration files.

Previous behavior raised a syntax error on newlines.

Footer (Opcional)

Metadatos, referencias, breaking changes:

fix(api): correct pagination offset calculation

Closes #123
Reviewed-by: @username

Breaking Changes

Agregar ! después del type/scope Y/O footer con BREAKING CHANGE::

feat(api)!: remove deprecated /v1/users endpoint

BREAKING CHANGE: The /v1/users endpoint has been removed.
Migrate to /v2/users instead. See migration guide in docs.

Ejemplos Reales

# Nueva feature
feat(auth): implement OAuth2 provider integration

# Bug fix con scope
fix(payment): prevent duplicate charge on retry

# Chore sin scope
chore: update dependencies to latest versions

# Multiple scopes (usar scope más general)
feat(ui): redesign dashboard with new color scheme

# Breaking change
refactor(database)!: migrate from MongoDB to PostgreSQL

BREAKING CHANGE: Database schema completely rebuilt.
Run migration scripts before deploying.

Beneficios

1. Changelog automático: Herramientas generan release notes
2. Semantic versioning: Calcula versión basada en types
3. Navegación histórica: Buscar por type (git log --grep="^feat")
4. CI/CD triggers: Acciones automáticas según type
5. Comunicación clara: Equipo entiende impacto de cada cambio

Herramientas

• commitlint: Valida formato de commits
• semantic-release: Automatiza versioning y releases
• conventional-changelog: Genera CHANGELOG.md

Recursos

• conventionalcommits.org
• Semantic Versioning