Skip to content

HabitaNexus/monorepo / skills/versioning-management

versioning-management

Verified

FileKindSize
SKILL.mdskill md2.9 KB
# 🏷️ Skill: Versioning Management

## 📋 Metadata

| Atributo | Valor |
|----------|-------|
| **ID** | `versioning-management` |
| **Nivel** | 🟢 Básico |
| **Versión** | 1.0.0 |
| **Keywords** | `semver`, `versioning`, `changelog`, `semantic-versioning`, `release-notes` |
| **Lenguajes Soportados** | Universal (Markdown) |

## 🔑 Keywords para Invocación

- `semver`
- `versioning`
- `changelog`
- `semantic-versioning`
- `release-management`
- `@skill:versioning-management`

### Ejemplos de Prompts

```
Documenta los cambios de esta versión usando SemVer
```

```
Crea un changelog para la versión v1.2.0
```

```
@skill:versioning-management - Genera notas de lanzamiento para el backend
```

## 📖 Descripción

Skill para gestionar el versionamiento semántico (SemVer) de proyectos Flutter. Este skill define la estructura y el proceso para documentar cambios en el backend y en la aplicación móvil, asegurando que cada release tenga un registro claro de adiciones, cambios y eliminaciones.

### ✅ Cuándo Usar Este Skill

- Al completar una nueva funcionalidad (Feature)
- Al corregir un error (Bug Fix)
- Antes de realizar un despliegue a Staging o Producción
- Cuando se requiere sincronizar versiones entre distintos microservicios

### ❌ Cuándo NO Usar Este Skill

- Para commits internos o cambios menores en el código que no afectan la funcionalidad pública
- Documentación puramente técnica de código (usar JSDoc/DartDoc en su lugar)

## 🛠️ Estándar de Versionamiento

Seguimos el estándar [SemVer 2.0.0](https://semver.org/):
- **MAJOR**: Cambios incompatibles en la API
- **MINOR**: Funcionalidad nueva compatible hacia atrás
- **PATCH**: Corrección de errores compatible hacia atrás

## 📂 Estructura de Archivos

La documentación de versiones se almacena en `docs/versioning/`:

```
docs/versioning/
├── backend/
│   ├── CHANGELOG-vX.Y.Z.md
│   └── ...
└── mobile/
    ├── CHANGELOG-vX.Y.Z.md
    └── ...
```

## 📝 Formato del Changelog (Basado en [Keep a Changelog](https://keepachangelog.com/))

Cada archivo debe seguir esta estructura:

```markdown
# Changelog - Version X.Y.Z

## [X.Y.Z] - YYYY-MM-DD

### Added
- [ ] Descripción de nueva funcionalidad

### Changed
- [ ] Descripción de cambios en funcionalidad existente

### Deprecated
- [ ] Funcionalidades que serán eliminadas pronto

### Removed
- [ ] Funcionalidades eliminadas en esta versión

### Fixed
- [ ] Corrección de errores

### Security
- [ ] Mejoras de seguridad o parches de vulnerabilidades
```

## 🚀 Proceso de Actualización

1. **Identificar el tipo de cambio**: ¿Es Major, Minor o Patch?
2. **Localizar el componente**: ¿Backend, Mobile o ambos?
3. **Crear/Actualizar el archivo**: Usar el template anterior en la ruta correspondiente.
4. **Verificar consistencia**: Asegurarse de que la fecha y la versión coincidan con los tags de Git si se utilizan.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall