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ó.
{
"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.