chore: update release flow to include release-please

Author: danielaEsc

.github/copilot-instructions.md

@@ -0,0 +1,19 @@
+# Instrucciones para Gestión de Releases (Carpeta `release/`)
+
+Cuando se detecte una rama `release/v{VERSION}` creada automáticamente por `release-please` (al detectar commits en `master`), Copilot debe intervenir para finalizar el release:
+
+1. **Detección de Contexto:**
+   - Confirmar que se encuentra en una rama `release/v{VERSION}`.
+   - Usar el archivo `release/.releaserc.yml` para configuraciones específicas.
+   - Referencia de versión: `package.json` (campo `version`).
+
+2. **Generación de Changelog en Español:**
+   - Analizar los commits del PR/rama actual.
+   - Generar/Actualizar `release/CHANGELOG.md` con secciones en español (ej. "Características", "Correcciones").
+   - El formato debe seguir lo definido en `.releaserc.yml`.
+
+3. **Cierre de Release:**
+   - Actualizar la versión en `package.json`.
+   - Realizar un commit con el mensaje: `chore: release v{version} [spanish changelog]`.
+   - Ejecutar el **Release & Communication Agent** para generar la síntesis para stakeholders (evidencia, riesgos, etc.).
+   - Dejar el PR listo para revisión y merge manual a `master`. (El tag final lo creará `release-please` al mergear).

release/README.md

@@ -0,0 +1,50 @@
+# Gestión de Releases - ePayco-tl
+
+Esta carpeta contiene el setup automatizado para gestión de releases usando agentes y skills de GitHub Copilot, inspirado en "release-skills" de baoyu-skills.
+
+## Archivos
+
+- `.releaserc.yml`: Configuración del skill (versión, changelog, secciones, etc.).
+- `CHANGELOG.md`: Registro de cambios en español.
+
+## Cómo Usar
+
+### Cuando se detecta una rama de release
+
+Una vez que `release-please` crea automáticamente una rama `release/v{VERSION}` al detectar commits en `master`, abre esa rama y ejecuta en Copilot:
+
+```
+"Completa el release"
+```
+
+Copilot seguirá el workflow para finalizar el PR:
+
+1. ✅ Detectar la versión desde la rama/PR creada por release-please
+2. ✅ Generar changelog detallado en español en `release/CHANGELOG.md`
+3. ✅ Actualizar versión en `package.json`
+4. ✅ Ejecutar el Release & Communication Agent para síntesis de stakeholders
+5. ✅ Notificar que el PR está listo para mergear a `master`
+
+## Workflow Automatizado
+
+La rama de trabajo actual: `feat/release-skills-setup`
+
+La rama base es: `master`
+
+- **Disparador:** Commit en `master`.
+- **Acción 1 (Auto):** `release-please` crea rama `release/v{VERSION}` y PR.
+- **Acción 2 (Copilot):**
+  - Genera changelog actualizado en `CHANGELOG.md` (Español).
+  - Actualiza `package.json` con la nueva versión.
+  - Genera síntesis para stakeholders (Release & Communication Agent).
+- **Acción 3 (Manual):** Revisión y Merge del PR a `master`.
+- **Acción 4 (Auto):** `release-please` crea el Tag final en GitHub.
+
+## Configuración
+
+- **Versión actual:** `1.0.0` (en `package.json`)
+- **Rama de trabajo:** `feat/release-skills-setup`
+- **Rama destino:** `master`
+- **Idioma del changelog:** Español
+
+Para más detalles, consulta `.github/copilot-instructions.md`, `skill.md` y la [Investigación de Agentes de Release](file:///home/danielaescobar/Documentos/GitHub/simple-test-project-/docs/research/epayco-release-agentes.md).

release/skill.md

@@ -0,0 +1,61 @@
+# Skill de Releases Automatizados
+
+Este documento describe la "skill" que reside en la carpeta `release/` y que permite a GitHub Copilot gestionar releases de forma automatizada.
+
+### ¿Qué hace?
+
+- Detecta configuración del proyecto mediante `.releaserc.yml`.
+- Se activa cuando `release-please` crea una rama `release/v{VERSION}`.
+- Inspecciona commits desde el último tag siguiendo conventional commits.
+- Genera o actualiza el `CHANGELOG.md` en español con secciones estándares.
+- Actualiza la versión en `package.json`.
+- Invoca al Release & Communication Agent para producir notas de versión y gestionar comunicación para stakeholders.
+- Deja el PR listo para revisión y merge manual a `master`.
+
+### Estructura de la carpeta
+
+- `.releaserc.yml` – configuración del comportamiento.
+- `CHANGELOG.md` – registro de cambios.
+- `README.md` – guía de uso de la skill.
+- `skill.md` – descripción funcional (este archivo).
+
+### Uso
+
+El usuario simplemente formula una petición a Copilot del tipo:
+
+> "Crea un release" o "Genera un release automático".
+
+Copilot toma el control mediante los agentes definidos y ejecuta el flujo anterior, respetando la configuración en `release/.releaserc.yml`.
+
+---
+
+### Flujo de Ramas y Pull Requests
+
+Para cada release se sigue este flujo:
+
+1. **Creación Automática:** `release-please` detecta commits en `master` y crea la rama `release/v{VERSION}` (ej: `release/v1.2.0`) y su respectivo PR.
+2. **Intervención de Copilot:** Una vez en la rama, Copilot:
+   - Actualiza `package.json` (campo `version`).
+   - Genera `release/CHANGELOG.md` en español.
+   - Ejecuta el Release & Communication Agent para síntesis de stakeholders.
+3. **Commit de Copilot:** Mensaje: `chore: release v{version} [spanish changelog]`.
+4. **Revisión:** El desarrollador revisa el PR que ya contiene el changelog y la síntesis.
+5. **Merge a master:** Al mergear el PR, `release-please` crea el tag de Git automáticamente.
+
+**Ejemplo de comando Copilot:**
+
+```
+"Crea un release"
+```
+
+El sistema automáticamente:
+
+- ✅ Detecta rama `release/v1.2.0` creada por release-please
+- ✅ Traduce y genera changelog a español
+- ✅ Actualiza versión en package.json
+- ✅ Prepara síntesis de comunicación
+- ✅ Actualiza el PR existente
+
+---
+
+La intención es que todo lo relacionado con releases quede concentrado en esta carpeta, sin necesidad de instalaciones externas.