Saltar a contenido

Gobernanza y aprobación humana

Una sola skill hoy cumple este rol: dejar una pausa explícita para que una persona apruebe o rechace un artefacto antes de que el flujo continúe.


lippia-neo-relay-human-approval

Cuándo usarla

Como gate de aprobación humana dentro de un plan declarativo (M4, motor crowdar-engine-mvp), cuando quien invoca setea requires_approval: true sobre un artefacto generado antes en el plan (por ejemplo, un test de regresión). Su única función es relayar una decisión que una persona ya tomó fuera de esta invocación — nunca la toma ni la infiere ella misma.

Diseño interino

Es un diseño interino mientras la ADR-015 (motor de approval workflows) sigue pendiente: el engine actual no tiene pausa/resume nativo, así que el plan corta en estado stopped en el primer disparo (sin decisión todavía) y se vuelve a invocar completo cuando la persona ya decidió.

Ejemplo de invocación — decisión ya tomada
{
  "input": {
    "regression_test": { "path": "tests/regression/US-045-cupon.spec.ts" },
    "approval_decision": "approved",
    "approver": "qa-lead@crowdaronline.com"
  }
}
Input Tipo Descripción
input.regression_test Requerido El artefacto sobre el que se está pidiendo aprobación (también se usa para armar el summary).
input.approval_decision Opcional "approved" | "rejected"; ausente o null significa que todavía no hay decisión humana.
input.approver Opcional Nombre o handle de quien decide, para trazabilidad.
input.approval_notes Opcional Comentario de quien aprueba (motivo de rechazo, condiciones, etc.).

Salida

Campo Descripción
approved Booleano, true solo si input.approval_decision == "approved", nunca inferido.
status approved | rejected | pending.
reason Explica el status (motivo, confirmación, o qué falta para destrabar el pending).
summary Resumen de 2-3 líneas de qué se está aprobando, armado solo con contenido presente en regression_test.
approver El valor recibido en el input, o null.
requested_changes Presente solo si status == rejected.
Se encadena con

Actúa como gate después de que un paso previo del plan M4 generó el regression_test; si el status queda pending o rejected, el plan corta y es quien lo invoca (por ejemplo, el adaptador de CI) el que vuelve a disparar el plan completo tras capturar la decisión humana. Hoy ninguno de los planes publicados en crowdar-engine-mvp/plans/ incluye este gate todavía.