Protocolo de Decisión Humana

Objetivo

Convertir la filosofía de ATLANTYQA en conducta operativa obligatoria: ninguna decisión crítica se ejecuta sin trazabilidad humana explícita.

Cuándo aplica

1. Operativa diaria: PRs de runbooks, infraestructura, catálogos, documentación de gobierno.
2. Procesos regulados: cambios legales/compliance y cualquier paso con impacto normativo.

Secuencia obligatoria

1. identificar tipo de decisión: operativa diaria o proceso regulado.
2. identificar actor aprobador responsable por rol.
3. registrar decisión final: aprobado, cambios requeridos, bloqueado, o en espera de evidencia.
4. declarar riesgo residual y siguiente acción.
5. enlazar evidencia técnica/operativa.
6. enlazar issue/PR de trazabilidad.

Formato sintético en PR (user-friendly)

En .github/pull_request_template.md el protocolo se captura con 5 bloques:

1. tipo de decisión (elige 1),
2. aprobador responsable (elige 1),
3. decisión final (elige 1),
4. evidencia mínima (3 checks obligatorios),
5. check legal adicional solo si el tipo es proceso regulado.

Regla de claridad: en los bloques 1-3 se marca solo una opción.

Modo móvil (GitHub App)

Para operar desde móvil, la PR acepta un bloque compacto HDP-* en el body:

HDP-TYPE: operativa-diaria|proceso-regulado
HDP-APPROVER: loky|angel|bosco|hilt
HDP-DECISION: aprobado|cambios-requeridos|bloqueado|en-espera-evidencia
HDP-TRACE: #123
HDP-EVIDENCE: <url-evidencia>
HDP-RISK: bajo|medio|alto
HDP-NEXT: <siguiente-accion>
HDP-COMPLIANCE: yes

HDP-COMPLIANCE: yes es obligatorio solo para proceso-regulado.

Matriz por rol corporativo

Rol	Responsabilidad mínima	Señal de cumplimiento
L0KY (Lead)	Priorizar y cerrar decisión de gobierno	PR con decisión final explícita
Ángel (Junior)	Ejecutar runbook y adjuntar evidencia	Resultado reproducible enlazado
Bosco (Infra IT)	Validar operación diaria e infraestructura	Estado operativo y riesgos claros
Consultoria Agent HILT	Validar paso legal regulado	Evidencia de compliance y aprobación

Imposición técnica (gates)

• Contrato: .github/contracts/human-decision-protocol-gate.json
• Workflow: .github/workflows/human-decision-protocol-gate.yml
• Verificador: scripts/verify/human_decision_protocol_guard.py
• Plantilla PR obligatoria: .github/pull_request_template.md

Resultado esperado

• menor ambigüedad en decisiones,
• mejor adopción de comportamientos por rol,
• auditoría clara en procesos regulados y operación diaria.