human-execution-engine

HEE (Human Execution Engine) es un framework de ejecución de doctrina primero de código abierto para la orquestación determinista de trabajo humano. Coordiona el razonamiento humano, la asistencia de máquinas y la automatización sin ambigüedades, priorizando la corrección sobre el consenso, la estructura sobre la vibra y el determinismo sobre la conveniencia. El proyecto aborda el problema de los registros que se desvían de la realidad: las afirmaciones se vuelven obsoletas o incorrectas sin que nadie mienta activamente. A medida que los sistemas de agentes leen y actúan sobre registros a velocidad de máquina, los datos obsoletos o erróneos se propagan más rápido de lo que los humanos los detectarían. HEE proporciona maquinaria para encontrar discrepancias intencionalmente en lugar de por azar. Conceptos principales: - Objetos tipados: Cada registro de gobernanza (Card, Pill, Contract, Blueprint, Plan, Registry) es YAML con un kind, un bloque de metadatos y una identidad derivada de hash computada como sha256(seed). Se validan con hee lint. - Verificaciones de comprobación: hee check reconcilia afirmaciones contra mediciones reales: verifica entradas de roster contra cuentas de GitHub en vivo, valida firmas GPG desvinculadas contra sus archivos fuente, confirma que los hashes de identidad se reproducen a partir de seeds y detecta secretos en repositorios públicos. - Cadenas de firmas: Los contratos son ratificados por firmas GPG sobre el YAML. El archivo .asc junto al YAML es la evidencia; la línea de estado es solo una afirmación sobre ella. - Thesis vs Duople: Una Thesis es una afirmación para someter a prueba de estrés. Un Duople es uno reducido a forma verificable y respaldada por evidencia. Etiquetar algo como Thesis es un reporte de estado honesto, no una degradación. - Separación de doctrina: blueprints/ y hee/ definen lo que debe ser verdadero. ci/, tooling/ y scripts lo aplican pero nunca son fuente de verdad. La CLI hee proporciona comandos como hee check, hee lint y hee list. El proyecto recomienda usarlo en un directorio temporal limpio ya que no requiere instalación. Los directorios clave incluyen blueprints/ para esquemas de doctrina y contratos validadores, hee/ para cards, pills, contracts, registries y skills, mib/ para el módulo de vocabulario HEE-MIB, docs/doctrine/ para HEE_POLICY, y tooling/bin/ para las herramientas hee. HEE define lo que debe ser verdadero, no cómo hacerlo verdadero. No es una herramienta de flujo de trabajo, biblioteca de prompts ni framework de agentes, y no tiene opinión sobre el lenguaje de implementación.