> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://naturgy-comer-documentation-p5mde.vercel.app/api/mcp` to find what you need.

# Preparar y cerrar una release de workflow

Usa esta guía cuando el cambio afecta al comportamiento de un workflow. Para
publicar la documentación del sitio, usa [Validar una publicación](/method/how-to/publish):
es un circuito diferente.

La guía no autoriza una escritura ni publica por sí misma. Sirve para preparar
la evidencia y llegar a una decisión explícita.

## Antes de empezar

No abras una release si falta alguno de estos elementos:

* un problema o resultado que se quiere mejorar;
* una evidencia reproducible o una explicación de por qué todavía es
  insuficiente;
* una versión viva confirmada y una línea base;
* un criterio de éxito observable;
* una clasificación del cambio y un responsable;
* un plan de reversión o una explicación de por qué no aplica.

Si hay una regla de negocio en conflicto, primero registra la decisión pendiente.
No la conviertas en una instrucción ni en un criterio de prueba.

## Procedimiento

### 1. Abrir el registro

Crea un registro con el [formato de release](/method/reference/release-record).
Copia el feedback literal, enlaza la evidencia permitida y separa el hecho
observado de la hipótesis de causa.

### 2. Fijar la base

Confirma el workflow, el entorno y la versión que atiende el tráfico relevante.
Registra el identificador, la fecha y las métricas de referencia. No uses la
última versión editable por defecto.

### 3. Definir el alcance

Clasifica el cambio como conducta, enrutado, integración, telefonía,
post-llamada o negocio. Indica qué capacidades, agentes, salidas y sistemas
pueden verse afectados. Una release debe poder describirse en una frase.

### 4. Preparar una candidata aislada

Parte de una copia de la versión base confirmada. No edites la versión viva, no
reutilices una candidata cuyo origen ya no sea la base actual y no mezcles otros
cambios en la misma subida.

### 5. Cambiar y proteger

Aplica el cambio mínimo. Añade una regresión que falle antes del cambio y pase
después. Comprueba también las rutas vecinas, las prohibiciones y las salidas
que podrían verse afectadas.

### 6. Ejecutar las puertas de validación

Elige las pruebas según la clasificación y anota el resultado, el alcance y las
limitaciones. Como mínimo, revisa:

* construcción y configuración de la candidata;
* regresión del problema;
* pruebas personalizadas y adversarias aplicables;
* recorrido completo afectado;
* evidencia externa para efectos, entregas, transferencias o datos de negocio;
* idempotencia antes de repetir una operación con efecto lateral.

Un resultado positivo de una prueba aislada no sustituye una revisión del
workflow ni de los sistemas que están fuera de él.

### 7. Revisar y autorizar

La revisión confirma que el cambio es atómico, que las pruebas corresponden al
riesgo, que no quedan decisiones ocultas y que existe una forma de volver atrás.
La persona autorizadora puede rechazar, pedir más evidencia o aprobar la
publicación.

### 8. Publicar o comparar

La publicación es manual y queda registrada. Si se necesita una comparación con
la versión anterior, se fija antes el objetivo, el criterio de lectura y la
ventana; no se promociona una candidata por falta de tiempo o por intuición.

### 9. Observar y cerrar

Durante la ventana acordada, compara la candidata con la línea base. Registra
las métricas, las auditorías, los incidentes y las limitaciones. Después marca
**promover**, **seguir observando** o **revertir**, informa a las personas del
circuito y cierra el issue con el resultado.

## Detenerse

Detén la release si:

* la versión base no puede confirmarse;
* el resultado de una lectura no es reproducible;
* la prueba usa una regla de negocio sin cerrar;
* la candidata no tiene regresión o plan de reversión;
* una operación con efecto lateral no tiene contrato de no duplicación;
* falta la evidencia externa necesaria y el riesgo no está aceptado;
* la publicación mezclaría cambios no relacionados.

Para aplicar esta secuencia al caso de uso ATC, continúa con [Preparar una
release de ATC](/use-cases/atc/how-to/release). Para aprenderla paso a paso,
sigue [De una incidencia a una release](/use-cases/atc/tutorials/issue-to-release).