human-execution-engine

HEE (Human Execution Engine) is an open-source doctrine-first execution framework for deterministic human work orchestration. It coordinates human reasoning, machine assistance, and automation without ambiguity, prioritizing correctness over consensus, structure over vibes, and determinism over convenience. The project addresses the problem of records drifting from reality — claims becoming outdated or incorrect without anyone actively lying. As agent systems read and act on records at machine speed, stale or wrong data propagates faster than humans would catch it. HEE provides machinery for finding discrepancies intentionally rather than by luck. Core concepts: - Typed objects: Every governance record (Card, Pill, Contract, Blueprint, Plan, Registry) is YAML with a kind, metadata block, and a hash-derived identity computed as sha256(seed). These are validated with hee lint. - Verification checks: hee check reconciles claims against real measurements — verifying roster entries against live GitHub accounts, validating detached GPG signatures against their source files, confirming identity hashes reproduce from seeds, and detecting secrets in public repos. - Signature chains: Contracts are ratified by GPG signatures over the YAML. The .asc file beside the YAML is the evidence; the status line is only a claim about it. - Thesis vs Duople: A Thesis is a claim to stress-test. A Duople is one reduced to verifiable, evidence-backed form. Labeling something Thesis is honest status reporting, not demotion. - Doctrine separation: blueprints/ and hee/ define what must be true. ci/, tooling/ and scripts enforce it but are never a source of truth. The hee CLI provides commands like hee check, hee lint, and hee list. The project recommends using it in a clean temporary directory since no installation is required. Key directories include blueprints/ for doctrine schemas and validator contracts, hee/ for cards, pills, contracts, registries and skills, mib/ for the HEE-MIB vocabulary module, docs/doctrine/ for HEE_POLICY, and tooling/bin/ for the hee tools. HEE defines what must be true, not how to make it true. It is not a workflow tool, prompt library, or agent framework, and has no opinion on implementation language.