Definition of Done

Esto no es un principio ni un estándar: es la condición de salida de un paso del proceso de entrega. Cuando ese proceso se modele en arquitectura/procesos.c4, este archivo es la compuerta de la tarea correspondiente y debe enlazarse desde ahí.

Se mantiene aparte de estandares.md a propósito. Los estándares aplican al artefacto (el código, el servicio); el DoD aplica al flujo de trabajo (el cambio, el ticket).

Criterios

(Pendiente de escribir. Lo de abajo es andamiaje: reemplazar, no rellenar.)

Los checks de CI pasan, incluyendo los estándares de nivel 🔴 obligatorio.
(pendiente) Cobertura de pruebas / criterio de pruebas.
(pendiente) Revisión de una segunda persona.
Si el cambio altera el grafo de contenedores o sus relaciones: el .c4 correspondiente en arquitectura/ está actualizado en el mismo PR, y npm run check pasa.
Si el cambio mete o saca algo de la ruta de firma cualificada: el tag #firma-cualificada del modelo lo refleja.
Si el cambio altera un proceso automatizado: la vista dinámica correspondiente en arquitectura/procesos.c4 está actualizada en el mismo PR, y npm run check pasa.
Si el cambio viene de una decisión que valga la pena escribir: hay un ADR. En decisiones/ de este repositorio si afecta a más de un repositorio, toca un STD-XXX, mueve la frontera de confianza o nos compromete frente a un supervisor; en decisiones/ del repositorio del proyecto si no. En la duda, sube.
Si el ADR crea, cambia o elimina una regla: estandares.md refleja el nuevo estado en el mismo PR.
(pendiente) Criterios con peso regulatorio: evidencia, retención, trazabilidad.

Por qué importan los criterios condicionales

Son el mecanismo antipodredumbre de este repositorio. La arquitectura y los procesos documentados no se degradan porque la gente sea descuidada, sino porque nada en el flujo de trabajo obliga a mirarlos. Estas casillas son ese algo.

Desde que los ADRs de proyecto viven en sus repositorios, la casilla del ADR carga además con el riesgo de esa decisión: una decisión transversal que se queda escrita en un solo repositorio es invisible para todos los demás. Es la única casilla que no se puede automatizar, porque decidir el alcance de una decisión es un juicio.