| name | changelog |
| description | Mantiene el CHANGELOG.md actualizado con cada cambio significativo. Trigger: Despues de cada commit, feature completada, o cuando el usuario pide registrar cambios.
|
| license | Apache-2.0 |
| metadata | {"author":"gentleman-programming","version":"1.0"} |
When to Use
Actualizar el CHANGELOG.md:
- Despues de completar una feature o fix
- Antes de crear un commit
- Cuando el usuario pida registrar cambios
- Al finalizar una fase del proyecto
Formato
Seguimos Keep a Changelog + Semantic Versioning.
Categorias Validas
| Categoria | Cuando usar |
|---|
Added | Nuevas funcionalidades |
Changed | Cambios en funcionalidades existentes |
Deprecated | Features que seran removidas |
Removed | Features eliminadas |
Fixed | Correccion de bugs |
Security | Parches de seguridad |
Infrastructure | Cambios en DB, backend, CI/CD, config |
Estructura
# Changelog
Todos los cambios notables del proyecto se documentan en este archivo.
Formato basado en [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
## [Unreleased]
### Added
- Descripcion clara del cambio (REQ-ID si aplica)
### Fixed
- Que se arreglo y por que
Reglas
- Siempre en espanol - Este proyecto es en espanol
- Un item por linea - Cada cambio es un bullet point
- Referencia al requerimiento - Si existe un ID de PRD (AUTH-01, EVT-03), incluirlo
- Fecha en releases -
## [1.0.0] - 2026-02-16
- Unreleased primero - Cambios sin release van en
[Unreleased]
- No redundar - No repetir lo que dice el commit message
- Perspectiva de usuario - Describir QUE cambia para el usuario, no detalles de implementacion
Ejemplo
## [Unreleased]
### Added
- Sistema de autenticacion con email/password (AUTH-01, AUTH-03)
- Verificacion de email por codigo de 6 digitos (AUTH-02)
- CRUD completo de items para administradores
### Infrastructure
- Tablas `items`, `user_roles` en PostgreSQL
Ubicacion
El archivo CHANGELOG.md esta en la raiz del proyecto: /CHANGELOG.md
Procedimiento
- Leer el CHANGELOG.md actual
- Identificar la seccion correcta (
[Unreleased] o version especifica)
- Agregar el cambio en la categoria correcta
- Si es un release, mover items de
[Unreleased] a la nueva version con fecha
