Gate y Centro de Gobierno

El contrato de calidad dice qué exige el equipo. El gate lo hace cumplir. Es un único comando del motor que usan igual los hooks de Git, la CI, el comando yuli-mcp gate y los hooks de los agentes. El resultado no depende de quién lo invoque.

El comando

agent-engine gate --project <raíz> --stage pre-commit|commit-msg|pre-push|ci \
  [--message-file <archivo>] [--base <revisión>] [--format text|json]

Si omites --project, se usa la carpeta actual. Una carpeta sin Git pasa siempre.

Qué revisa cada etapa

Los controles

Anti-trampa en los tests

Un agente presionado por terminar puede «arreglar» una prueba en lugar del código. Yuli lo detecta.

En las pruebas:

• Aserciones eliminadas o tests borrados.
• Tests saltados: @Disabled, @Ignore, .skip(, xit, #[ignore], skips de pytest o unittest, t.Skip.
• Aserciones triviales, como assertTrue(true) o expect(true).toBe(true).
• Valores esperados cambiados para que el test pase.
• catch que atrapa todo dentro de un test.

En el build y la CI:

• Cobertura mínima rebajada.
• Tests saltados en el build.
• Fallos ignorados, como npm test || true.
• Script de pruebas reemplazado por uno vacío.
• Gate de calidad desactivado o tarea de tests deshabilitada.

Red de seguridad

Si cambian archivos de código existentes sin pruebas de caracterización o unitarias, el gate avisa: el cambio debe preservar el comportamiento. Nunca bloquea el commit.

Instalar los hooks de Git

En el Centro de Gobierno, pestaña Puertas, pulsa Instalar hooks.

1. Yuli escribe .githooks/pre-commit, .githooks/commit-msg y .githooks/pre-push.
2. Configura git config --local core.hooksPath .githooks.

Desinstalar hooks quita la configuración y borra solo los scripts de Yuli.

En la CI

Los pipelines que genera Crear CI incluyen el paso «Puertas del contrato», que ejecuta agent-engine gate --stage ci. Así la CI aplica las mismas reglas que tu equipo local.

El Centro de Gobierno

Ábrelo desde el riel derecho (Más herramientas → Centro de Gobierno) o con la paleta de comandos: Abrir el Centro de Gobierno. Tiene 10 pestañas.

Documentos que genera

DORA

La pestaña Entrega calcula las cuatro métricas DORA: frecuencia de despliegue, lead time, tasa de fallos en cambios y MTTR, con las bandas Élite, Alta, Media y Baja. Usa los despliegues registrados o la CI. Yuli no ve un APM de producción.

Revisión independiente

Un modelo de otra familia revisa el cambio. Nunca usa la misma familia del modelo que lo escribió. Si no hay ninguno configurado, lo indica como no disponible. Es obligatoria en los perfiles Regulada y Seguridad crítica.

Contexto para todos los agentes

En Agentes → Contexto, la sección «Contexto para todos los agentes» escribe las mismas reglas para cada herramienta:

El contenido va en un bloque gestionado; lo que escribas fuera se respeta. Por defecto los archivos quedan fuera de Git; actívalo con Versionarlos en Git. Cada destino muestra su estado: Al día, Desactualizado, No existe o Editado a mano.

Reglas aprendidas

Cuando un mismo hallazgo aparece 3 veces o más en al menos 2 tareas dentro de 30 días, se convierte en una regla en .ai/rules/learned.md. Puedes rechazarla en Agentes → Aprendizaje; solo se vuelve a proponer si su evidencia se duplica.

Límites honestos

• DAST (OWASP ZAP), el escaneo de contenedores (Trivy o Grype) y la firma (cosign) solo se ejecutan si están instalados, y siempre con confirmación. Si faltan, Yuli lo indica y no simula el resultado.
• Las reglas preventivas y las de IaC son patrones sobre el texto. Cada hallazgo trae su archivo y línea para que una persona lo confirme.