You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: release/README.md
+5-6Lines changed: 5 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@
3
3
Esta carpeta contiene el setup automatizado para gestión de releases usando:
4
4
5
5
- La GitHub Action **`release-please`** como **fuente de verdad del versionado y los tags**.
6
-
- La **skill local de release**y el **Release & Communication Agent**como capa de **documentación (changelog) y comunicación (síntesis para stakeholders)**.
6
+
- La **skill local de release** como capa de **documentación (changelog)**.
7
7
8
8
## Archivos
9
9
@@ -20,9 +20,9 @@ Cuando la GitHub Action `release-please` detecta commits en `master`/`main`, se
20
20
- Crear una rama de release (por ejemplo `release/v{VERSION}` o `release-please--branches--master--components--simple-test-project`).
21
21
- Abrir el **PR de release** correspondiente.
22
22
23
-
En esta etapa, la GA controla versionado y tags. Aún falta complementar la documentación y la comunicación.
23
+
En esta etapa, la GA controla versionado y tags. Aún falta complementar la documentación.
24
24
25
-
### 2. Completar y documentar el release con la skill y el Release & Communication Agent
25
+
### 2. Documentar el release con la skill
26
26
27
27
Una vez exista la rama/PR de release, desde esa rama (o con el PR abierto) pide a Copilot:
28
28
@@ -43,13 +43,12 @@ Copilot, usando la skill de esta carpeta, debe:
43
43
- Calcula la nueva versión.
44
44
- Crea la rama `release/v{VERSION}` (o equivalente) y el PR de release.
45
45
- Gestiona el tag cuando el PR se mergea.
46
-
-**Acción 2 (Copilot – skill + Release & Communication Agent):**
46
+
-**Acción 2 (Copilot – skill):**
47
47
- Genera/actualiza `release/CHANGELOG.md` en español con formato ePayco.
48
-
- Prepara la síntesis para stakeholders (resumen ejecutivo, riesgos, siguiente paso) y la asocia al PR.
49
48
-**Acción 3 (Manual):** Revisión y merge del PR a `master`.
50
49
51
50
## Configuración
52
51
53
52
-**Idioma del changelog:** Español (formato ePayco).
54
53
55
-
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).
54
+
Para más detalles, consulta `.github/copilot-instructions.md` y `skill.md`.
Copy file name to clipboardExpand all lines: release/skill.md
+3-9Lines changed: 3 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,10 +9,6 @@ Este documento describe la "skill" que reside en la carpeta `release/` y que per
9
9
- Asume que el **versionado y el tag ya fueron calculados y gestionados por `release-please`** (GA): la skill **no cambia la versión ni crea tags**.
10
10
- Inspecciona los commits desde el último tag para entender los cambios incluidos en el release.
11
11
- Genera o actualiza `release/CHANGELOG.md` en **español** siguiendo el **formato de ePayco** (secciones como "Características", "Correcciones", "Documentación" y otras acordadas en `.releaserc.yml`).
12
-
- Invoca al **Release & Communication Agent** para preparar una **síntesis para stakeholders** con:
13
-
- Resumen ejecutivo orientado a negocio.
14
-
- Principales riesgos o consideraciones técnicas relevantes.
- Deja el PR de release listo para revisión y merge manual a `master`, sin crear PRs adicionales ni modificar el flujo de versionado manejado por la GA.
17
13
18
14
### Estructura de la carpeta
@@ -24,7 +20,7 @@ Este documento describe la "skill" que reside en la carpeta `release/` y que per
24
20
25
21
### Uso
26
22
27
-
La skill se usa **después** de que `release-please` (GitHub Action) ya hizo su trabajo de versionado y creación del PR de release. Piensa en esta skill como la capa de **documentación y comunicación**, mientras que `release-please` es la capa de **versionado y tags**.
23
+
La skill se usa **después** de que `release-please` (GitHub Action) ya hizo su trabajo de versionado y creación del PR de release. Piensa en esta skill como la capa de **documentación**, mientras que `release-please` es la capa de **versionado y tags**.
28
24
29
25
1. Asegúrate de que ya existe una rama/PR de release creada por `release-please` (por ejemplo `release-please--branches--master--components--simple-test-project` o `release/vX.Y.Z`).
30
26
2. Sitúate en esa rama de release o abre el PR correspondiente.
@@ -50,9 +46,8 @@ Para cada release se sigue este flujo, separando claramente responsabilidades:
50
46
2.**Intervención de Copilot – Skill de release (este repo):**
51
47
- Una vez en la rama de release, al recibir el prompt **"Crea un release"**, la skill:
52
48
- Genera o actualiza `release/CHANGELOG.md` en español usando el formato de ePayco.
53
-
- Invoca al Release & Communication Agent para producir una síntesis para stakeholders (resumen ejecutivo, riesgos, siguiente paso) y la agrega al contexto del PR.
54
-
- La skill **no toca la versión ni los tags**; solo documentación y comunicación.
55
-
3.**Revisión:** El desarrollador revisa el PR que ya contiene el changelog y la síntesis para stakeholders.
49
+
- La skill **no toca la versión ni los tags**; solo documentación.
50
+
3.**Revisión:** El desarrollador revisa el PR que ya contiene el changelog actualizado.
56
51
4.**Merge a master:** Al mergear el PR, `release-please` aplica la versión calculada y crea el tag de Git automáticamente.
57
52
58
53
**Ejemplo de comando para Copilot:**
@@ -66,7 +61,6 @@ En respuesta a ese comando, el sistema automáticamente:
66
61
- ✅ Detecta la rama/PR de release creada por `release-please`.
67
62
- ✅ Usa la versión/tag ya calculados por `release-please` como fuente de verdad.
68
63
- ✅ Genera o actualiza el changelog en `release/CHANGELOG.md` en español con formato ePayco.
69
-
- ✅ Ejecuta el Release & Communication Agent para preparar una síntesis para stakeholders (resumen ejecutivo, riesgos, siguiente paso) asociada al PR.
0 commit comments