git-workflow

Git Workflow Skill

Cuándo usar esta skill

• Cuando necesites actualizar el CHANGELOG.md con nuevos cambios.
• Cuando vayas a hacer commit de cambios al repositorio.
• Cuando necesites hacer push de cambios al remoto.
• Cuando prepares una nueva release.

Convenciones de Commits

Este proyecto usa Conventional Commits:

type(scope): description

Tipos válidos:

Ejemplos:

feat(semantic): add image caption indexing
fix(navigation): resolve path validation error
docs: update tool reference with new parameters

Flujo de Trabajo Completo

1. Verificar estado actual

# Ver estado de archivos
git status

# Ver historial reciente
git log --oneline -10

2. Actualizar CHANGELOG.md

Formato requerido (Keep a Changelog):

## [Unreleased]

### Added
- Nueva feature X que hace Y.

### Changed
- Modificación en Z.

### Fixed
- Corrección del bug en W.

Secciones válidas: Added, Changed, Deprecated, Removed, Fixed, Security

3. Realizar commit

# Añadir todos los cambios
git add .

# Commit con mensaje convencional
git commit -m "type(scope): descripción"

Trailers especiales:

• Para bugs reportados: git commit --trailer "Reported-by:<name>"
• Para issues: git commit --trailer "Github-Issue:#<number>"

⚠️ NUNCA incluir Co-Authored-By en los commits.

4. Push al remoto

git push origin main

Proceso de Release

Para crear una nueva versión:

1. Mover cambios de Unreleased a una versión

## [1.2.0] - 2026-01-20

### Added
- (mover items de Unreleased)

2. Actualizar versión en pyproject.toml

[project]
version = "1.2.0"

3. Commit de release

git add .
git commit -m "chore(release): bump to v1.2.0"
git tag v1.2.0
git push origin main --tags

Checklist Pre-Push

Antes de hacer push, verifica:

• Tests pasan: uv run pytest tests/
• Linting limpio: uv run ruff check .
• Tipos correctos: uv run pyright
• CHANGELOG actualizado
• Commit message sigue convención

Comandos Rápidos

# Quick commit de docs
git add . && git commit -m "docs: update documentation"

# Quick commit de fix
git add . && git commit -m "fix(module): brief description"

# Ver cambios desde última release
git log --oneline $(git describe --tags --abbrev=0)..HEAD