| name | commit-creator |
| description | Crea commits siguiendo Conventional Commits v1.0.0 para raulfdez.dev. Cubre formato <type>(<scope>): <description>, tipos (feat/fix/docs/refactor/ci/chore/style/test/perf), scopes del proyecto (Header/Projects/Experience/i18n/Footer/Hero/AboutMe), breaking changes con ! y footer, descripciones en español, y validación de mensajes. |
Crea mensajes de commit para raulfdez.dev siguiendo Conventional Commits.
Especificación — Conventional Commits v1.0.0
Formato
<type>[optional scope]: <description>
[optional body]
[optional footer(s)]
Reglas
type y description son obligatoriosdescription en minúscula (primera letra)- Sin punto final en
description
- Máximo 72 caracteres en
description (ideal), 100 máximo
BREAKING CHANGE: en footer o ! tras type/scope para cambios que rompen compatibilidad- Línea en blanco entre header y body/footer
Tipos estándar
| Tipo | Uso |
|---|
feat | Nueva funcionalidad (MINOR en semver) |
fix | Corrección de bug (PATCH en semver) |
docs | Solo cambios en documentación |
style | Formato, espacios, punto y coma (sin cambio de lógica) |
refactor | Cambio de código que ni arregla bug ni añade feature |
perf | Mejora de rendimiento |
test | Añadir o corregir tests |
build | Sistema de build, dependencias externas |
ci | Configuración CI/CD |
chore | Tareas de mantenimiento, limpieza |
revert | Revertir commit anterior |
Scopes del proyecto
Basados en la estructura real de src/components/ y src/i18n/:
| Scope | Área |
|---|
Header | Navegación, observer, menú |
Hero | Sección hero, badge, social pills |
Experience | Timeline experiencia laboral |
Projects | Grid proyectos, TAGS |
AboutMe | Sección sobre mí |
Footer | Footer, copyright |
Layout | Layout.astro global |
ThemeToggle | Tema dark/light/system |
LanguageSelector | Selector ES/EN |
i18n | Traducciones en ui.ts |
Icons | Iconos SVG |
Badge | Componente badge animado |
SocialPill | Botones sociales |
SectionContainer | Wrapper secciones |
TitleSection | Títulos de sección |
LinkButton | Botones link |
config | astro.config, tailwind.config, tsconfig, netlify |
build | Scripts, dependencias |
skills | Skills en .agents/ |
docs | AGENTS.md, architecture.md, etc. |
Convenciones específicas del proyecto
- Descripciones en inglés y en minúscula inicial:
feat(Projects): add Tailor project
fix(Header): fix observer thresholds
docs(i18n): update about section translations
refactor(Experience): simplify timeline structure
ci: add netlify config
chore: clean up unused assets
-
Descripción concisa (idealmente ≤50 chars). Explica el "qué" y el "por qué", no el "cómo".
- ✅
fix(Header): adjust observer margin for mobile
- ❌
fix(Header): changed rootMargin value to -20%
-
Body opcional para contexto adicional (separado por línea en blanco):
refactor(Projects): remove Vue tag from Tailor
Tailor uses Symfony, not Vue.js. The tag was incorrect since the initial commit.
- Breaking changes con
! o footer:
refactor(i18n)!: change key format to domain.action.element
BREAKING CHANGE: old keys like 'hero.description' become 'hero.description.text'
Cómo generar un commit
- Analiza los cambios:
git status, git diff
- Identifica el tipo según la naturaleza del cambio
- Identifica el scope (componente o área afectada). Si afecta a varios, usa el más significativo o omite scope.
- Redacta descripción en inglés, ≤50 chars ideal, explicando el cambio
- Si es necesario, añade body con contexto/justificación
- Ejecuta:
git add + git commit -m "mensaje"
Ejemplos del historial real del proyecto
feat: 🎉 Initial commit: Portfolio personal de Raúl Fernández
docs: update README by removing image and refining description
chore: clean up project assets and format config files
ci: add netlify config and update site url in astro config
refactor(components): optimize images and improve responsive styles
fix(Header): adjust intersection observer thresholds and margins
refactor(pages): standardize import statements and fix layout structure
docs(i18n): update about section content in ui translations
refactor(Projects): remove Vue tag from Tailor project
Verificación
Tras commitear, verificar con:
git log -1 --format="%s"
Si el proyecto tuviera commitlint configurado, validaría automáticamente.
