human-execution-engine

HEE (Human Execution Engine) é um framework de execução de código aberto baseado em doutrina para orquestração determinística do trabalho humano. Ele coordena o raciocínio humano, assistência de máquina e automação sem ambiguidade, priorizando correção sobre consenso, estrutura sobre sensações e determinismo sobre conveniência. O projeto aborda o problema de registros que se desviam da realidade — afirmações que se tornam desatualizadas ou incorretas sem que ninguém esteja mentindo ativamente. À medida que sistemas agente leem e agem sobre registros à velocidade de máquina, dados obsoletos ou incorretos se propagam mais rápido do que os humanos conseguiriam perceber. O HEE oferece mecanismos para encontrar discrepâncias intencionalmente, e não apenas por sorte. Conceitos centrais: - Objetos tipados: Cada registro de governança (Card, Pill, Contract, Blueprint, Plan, Registry) é um YAML com um tipo (kind), bloco de metadados e uma identidade derivada de hash calculada como sha256(seed). Eles são validados com hee lint. - Verificações: hee check reconcilia afirmações contra medições reais — verificando entradas de lista contra contas GitHub ativas, validando assinaturas GPG desanexadas contra seus arquivos fonte, confirmando que hashes de identidade reproduzem a partir de seeds e detectando segredos em repositórios públicos. - Cadeias de assinatura: Contratos são ratificados por assinaturas GPG sobre o YAML. O arquivo .asc ao lado do YAML é a evidência; a linha de status é apenas uma afirmação sobre ela. - Tese vs Duople: Uma Tese é uma afirmação para testar. Um Duople é uma reduzida a uma forma verificável e comprovada. Rotular algo como Tese é relatar honestamente a situação, não uma desvalorização. - Separação de doutrina: blueprints/ e hee/ definem o que deve ser verdadeiro. ci/, tooling/ e scripts impõem isso, mas nunca são uma fonte de verdade. A CLI hee fornece comandos como hee check, hee lint e hee list. O projeto recomenda usá-la em um diretório temporário limpo, já que não há instalação necessária. Diretórios principais incluem blueprints/ para esquemas de doutrina e contratos validadores, hee/ para cards, pills, contracts, registries e skills, mib/ para o módulo vocabular de HEE-MIB, docs/doctrine/ para HEE_POLICY e tooling/bin/ para as ferramentas hee. HEE define o que deve ser verdadeiro, não como torná-lo verdadeiro. Não é uma ferramenta de fluxo de trabalho, biblioteca de prompts ou framework de agentes, e não tem opinião sobre linguagem de implementação.